在mastergo中为组件添加可编辑属性需在组件或组件集层级操作,支持文本内容、显示状态、实例切换及组件状态四类属性,分别用于外部编辑文本、控制图层显隐、切换嵌套子组件和触发可变组件状态跳转。

在MasterGo中为组件添加可编辑属性,能让团队成员无需进入组件内部就能快速修改文本、切换状态或控制图层显隐,避免误改父组件结构。这一步必须在组件或组件集层级操作,普通图层上无法创建组件属性。
创建组件属性的前置准备
打开团队组件库文件,确保你有编辑权限;选中一个已创建好的组件(非实例),或选中组件集整体——组件属性只能加在父层(组件/组件集本身)或其子图层上,不能加在画布上的实例上。【必须是组件或组件集,不是实例】
确认右侧属性栏已展开「组件属性」区域,若未显示,请先点击右上角「⋯」→「显示组件属性」。
添加文本内容属性
方法一:绑定单个文本图层
选中组件内部需要对外暴露编辑权的文本图层(如按钮上的“提交”文字),在右侧属性栏点击「+ 添加属性」→ 选择「文本内容」→ 输入属性名(如“按钮文字”)→ 点击「关联图层」→ 确认当前文本图层已被高亮选中即可完成绑定。
方法二:批量绑定多个同名文本图层
若组件内含多个需统一修改的文本(如卡片标题+副标题),可先在图层栏按住 Ctrl/Cmd 多选这些文本图层,再点击「+ 添加属性」→「文本内容」→ 输入属性名(如“卡片文案”)→ 自动关联全部选中图层。此时在实例中修改该属性,所有绑定图层将同步更新内容。
添加显示状态属性
第一步:选中要控制显隐的图层(例如图标、加载动画、禁用蒙版)
第二步:在右侧属性栏点击「+ 添加属性」→ 选择「显示状态」→ 命名(如“显示图标”)→ 属性值默认为“开”,代表图层可见;设为“关”则隐藏。
第三步:保存后,在任意实例中勾选/取消勾选该属性,对应图层立即响应显隐变化。注意:此操作不会影响其他未绑定该属性的图层,也不会改变图层本身的可见性开关设置——它只是覆盖了原始可见性。
添加实例切换属性
适用于组件内嵌套了多个子组件(如不同尺寸的头像、不同样式的标签)的场景。先确保这些子组件已作为独立组件存在,并被当前文件加载。
选中父组件中承载子组件的容器图层(通常是空的占位框或已插入某个默认子组件的图层),点击「+ 添加属性」→「实例切换」→ 在弹出列表中勾选允许切换的目标组件(支持本地组件和已启用的团队库组件)→ 设置默认值(即首次插入时显示哪个子组件)。
完成后,在实例中点击该属性下拉菜单,即可一键替换为任一已勾选的子组件,且保持位置、约束与父组件其他属性不变。
为可变组件添加组件状态属性
组件状态属性仅适用于可变组件(Variant),不能用于普通组件或组件集。先选中可变组件整体(即组件集顶层),再点击「+ 添加属性」→「组件状态」。
系统自动列出该可变组件内所有已定义的状态(如“默认”“悬停”“禁用”),你只需为其命名(如“交互状态”),并指定默认值。之后在实例中,该属性会以下拉菜单形式出现,切换选项即触发整个可变组件的状态跳转。
这一步不可逆:一旦添加组件状态属性,就锁定了该可变组件的状态映射关系,删除属性不会恢复原状态逻辑,需手动重建。











