符号是可复用的组件：在符号库中设计一次，即可在界面上放置多份关联副本。修改符号会同步更新所有副本，同时每个副本仍可保留少量自己的差异。

概述

符号适合页眉、卡片、工具栏、按钮等在多个界面重复出现的元素：只需维护一份设计，生成的代码中也只有一个函数，各处外观保持一致。

创建符号

1. 打开导航器中的符号选项卡（与层级选项卡相邻）。
2. 点击符号库标题栏的新建按钮。编辑器会新建一个空符号，在画布上打开它，并切换到符号编辑模式。
3. 像在界面上一样，向符号中添加组件。
4. 点击符号工具栏中的确认按钮保存定义。

符号库中的操作会立即生效：

• 重命名 - 点击行上的铅笔图标。
• 排序 - 拖动行上移或下移。该顺序同时决定符号在组件面板中的排列顺序。
• 删除 - 见删除符号。

只有符号内部的设计需要保存；重命名、排序和删除在操作时即生效。

编辑符号

在符号库中选中一个符号后，画布会显示它的定义，画布上方的工具栏显示编辑符号及符号名称。名称旁出现橙色小圆点时，表示存在未保存的更改。

只有存在未保存的更改时，放弃和保存按钮才可用。

存在未保存的符号草稿时也无法导出：请先保存或点击**✕**放弃，再构建或导出项目。

创建实例

展开组件栏，组件栏中的符号分组列出了所有可放置的符号：

• 点击图标，会向当前界面或其中的容器添加一个实例。
• 将图标拖到画布上，可以自行决定落点。

放置的每一份副本都与符号保持关联。需要放置多份时，重复上述任一操作即可。

使用实例

在画布上，实例作为一个整体处理：内部组件处于锁定状态，点击任意部分都会选中该实例；层级树中只显示该实例本身，不展开内部组件。若要修改其内容，请编辑符号本身。

每个实例可以单独设置的属性：

选中实例时，检查器默认折叠这些分组，只显示确定属于该实例的项。检查器上方有两个操作：

• 编辑符号 - 打开该符号定义的编辑器。
• 更多操作（…） - 其中的编辑实例会展开其余组件属性。

将某一项改为不同的值后，该值就只属于此实例。这类本地值会一直保留，之后保存符号时也不会被覆盖。

实例存在本地值后，菜单中会出现重置：将符号定义重新应用到该实例，覆盖实例上的本地修改；位置、名称、标识符、子组件与关联关系保持不变。

保存已有实例的符号

保存定义会更新所有实例：

• 实例上未改动过的值跟随新设计。
• 实例上改动过的值保留你的取值。
• 在实例上删除的属性会保持删除状态，之后修改符号也不会把它恢复。

希望某个实例重新跟随符号时，对该实例使用重置。

删除符号

删除符号只会移除符号库中的条目。只要还有实例在使用该符号，编辑器就会拒绝删除，并提示该符号仍在使用和涉及的组件数量。请先删除这些实例，再删除该符号。

生成的代码

每个符号都会在生成结果中成为一个可复用函数，实例直接复用该函数，而不重复设计内容：

• 每个定义在 generated/symbols.c 和 generated/symbols.h 中生成 create_symbol_<标识符>(lv_obj_t * parent) 函数。
• 未做任何改动的实例只生成一次调用及其位置。
• 存在本地值的实例会生成调用、位置，以及它自己声明的差异。
• 实例内部的子组件不会单独生成。

每个实例对应的函数都以 create_symbol_ 开头，便于查找；生成文件的组织方式见代码生成。

相关指南

• 布局 - 在符号内部排列组件。
• 图片 - 为符号内部组件指定图片资源。
• 字体库 - 符号内容的排版。
• 代码生成 - 符号如何变成生成函数。
• 编辑器概览 - 在画布上设计界面。
• 导航器 - 界面、层级与符号选项卡。
• 预览 - 验证符号的外观与行为。