MasterGo组件属性使用指南

在MasterGo里为组件添加可编辑属性：让团队成员快速修改，无需进入组件内部

在MasterGo中给组件加上“可编辑属性”，说白了就是让团队成员不用钻进组件“内部”去改东西。比如，修改按钮上的文字、控制某个图层的显示或隐藏、甚至一键切换嵌套的子组件，这些操作都能在组件实例上直接完成，既高效又安全，从根本上避免了手滑改坏父组件的风险。

需要记住一个铁律：组件属性只能在组件或组件集这一层级创建。普通图层是玩不转的，画布上已经实例化的组件也不行。

准备工作：把架子搭好

首先，打开你的团队组件库文件，确保自己有编辑权限。然后，选中一个已经创建好的组件（注意，不是实例哦），或者直接选中整个组件集。因为组件属性只能加在“父级”——也就是组件或组件集本身，或者是它的子图层上。

确保右侧属性栏里已经展开了“组件属性”这一块。如果看不到，点一下右上角的「」，勾选「显示组件属性」就行。

文本内容属性：让文字“活”起来

这里有两个常用的操作手法。

方法一：一对一绑定

假设组件里有一个文本图层，比如按钮上的“提交”二字。你想让外部能直接改这个词。选中这个文本图层，在右侧属性栏点击「+ 添加属性」，选择「文本内容」，输入一个你喜欢的属性名，比如“按钮文字”，然后点击「关联图层」。确认当前的高亮图层就是你要绑定的那个，就搞定了。

方法二：批量绑定，同步修改

如果你的组件里有好几个文本需要统一改动，比如卡片的标题和副标题。按住 Ctrl/Cmd 键，在图层栏里把这些文本图层都选上，然后同样点击「+ 添加属性」→「文本内容」，输入一个属性名，比如“卡片文案”。系统会自动把它们全部关联起来。之后，你只要在实例里修改这一个属性，所有绑定的图层都会同步更新文字。

显示状态属性：一键显隐

这个功能在控制图标、加载动画、禁用蒙版这类图层时特别好用。

先选中你想控制显示或隐藏的图层。然后，在右侧属性栏点击「+ 添加属性」，选择「显示状态」，给它起个名字，比如“显示图标”。默认属性值是“开”，表示图层可见；改成“关”，图层就隐藏了。

保存之后，在任意实例里，你只需要勾选或取消勾选这个属性，对应的图层就会立刻响应。需要注意的是，这个操作只会覆盖图层原始的可见性开关，不会影响到其他没有绑定的图层。

实例切换属性：动态换组件

当你在一个父组件里嵌套了多个子组件，比如不同尺寸的头像、不同样式的标签，就能用到这个功能。前提是这些子组件都得是独立的组件，并且已经被加载到当前文件里。

选中父组件里用来放置子组件的那个容器图层，比如一个空的占位框，或者已经插入了默认子组件的图层。点击「+ 添加属性」→「实例切换」，在弹出的列表里勾选你允许切换的目标组件（支持本地组件和已启用的团队库组件）。然后，设置一个默认值，也就是首次插入父组件时，默认显示哪个子组件。

完成之后，在实例上点击这个属性的下拉菜单，就能一键替换成你想要的任何子组件，位置、约束和父组件的其他属性都会保持不变。

组件状态属性：可变组件的“变形记”

这个属性是专门给可变组件（Variant）用的，普通组件或组件集不行。先选中整个可变组件（也就是组件集顶层），再点击「+ 添加属性」→「组件状态」。

系统会自动列出这个可变组件里所有已定义的状态，比如“默认”、“悬停”、“禁用”。你只需要给它起个名字，比如“交互状态”，并指定一个默认值。之后在实例里，这个属性会以下拉菜单的形式出现。切换选项，就能触发整个可变组件的状态跳转。

这里要特别提醒一句：这个操作是不可逆的。一旦添加了组件状态属性，就相当于锁死了这个可变组件的状态映射关系。如果你以后想删除这个属性，系统并不会恢复原始的状态逻辑，需要你手动重建。所以，操作前最好想清楚。