文本元素

阅读时间:2分钟更新于 2026-02-04 14:43

在一些特殊的应用场景中,动画会需要搭配一些可更新的文案实现。

因此,Galacean Effects 提供了【文本元素】功能,支持设计师添加文案元素,由开发同学根据应用场景动态变更文案。

创建文本元素

  • 点击右上角文本元素创建按钮进入文本元素创建模式。
  • 可以在屏幕拖拽设定文本元素宽度。
  • 文本框对文本元素内容进行编辑,也可以在右侧文本属性框对文本进行编辑。

文本换行

如需要对文本元素进行换行,具体可按如下演示操作:

  1. 在主面板双击“文本元素”,进入 文案编辑状态
  2. 在文案指定位置,按 回车 键,即可实现换行编辑。

注意:

  • 文案换行后仍然使用同一文本属性,如果需要不同文本属性,请使用 富文本 功能。

修改文本元素基本属性

设计师可以在右侧属性面板对文本元素基础属性进行改变。

设置自定义字体

  1. 上传自定义字体文件
    • 选择左下角 资源 选择标签
    • 选择 字体 资源分类
    • 点击 “ + ” 并通过导入字体资源上传自定义字体。
  1. 设置自定义字体
    • 自定义字体上传完成后,可以在右侧 基础属性 - 字体 列表中查找上传自定义字体。
    • 自定义字体通常位于字体列表的最上侧。

注意:

  • 文本元素的字体文件会打包在产物中,如果对产物大小有要求,设计师可以自行裁剪字体。
  • 自定义字体名称尽量使用英文和数字,否则在某些机型上有兼容性错误,下列表格给出一些示例,同时编辑器在导出时会给不支持的字体名称做兼容

字体名称

是否支持

不支持的原因

_BDFZ_FZZeBrach-Regular


200_BDFZ_FZZeBrach-Regular

iOS 部分系统不支持自定义字体开头为数字的名称,运行时在渲染时会使用系统默认字体

_BD!FZ_FZZeBrach-Regular

不支持大部分特殊符号如:+=!@ 等,会使用系统默认字体

裁剪字体

需要上传的自定义字体可能包括了大量的非西文字符,导致字体文件尺寸过大,用户设备播放动画前下载字体文件的过程会影响用户体验,因此建议根据业务对自定义字体按照字符集进行裁剪,这可以在保障用户体验的同时也满足开发者使用编程方式动态设置文本元素的内容:

  • 点击字体类别资源的 “ + ” 找到裁剪功能入口
  • 在字体裁剪面板选择要裁剪的字体
  • 在字符集面板勾选要裁剪的字符集:
    • 英文字母
    • 阿拉伯数字
    • 常用标点
    • 当前项目文本元素实际用到的文字
  • 在自定义字符集中配置业务实际会用到的字符集
  • 点击裁剪,并预览裁剪信息

注意:

每个字体资源会使用自身的 FontFamily 注册全局的字族名,因此你无法为动画使用多个 FontFamily 相关的字体,所以字符裁剪功能还提供了重命令字符 FontFamily 的功能,见信息面板字族信息的红色小叹号,你可以对字族名进行编辑。


Preview