echolive:emoji
1.5.0
注册表情包,以供编辑器和对话框使用。
属性
| 属性 | |
|---|---|
| 唯一键 | meta.name |
| 继承 | 无 |
默认值
该注册表有再注册过程,实际默认值取决于再注册过程。
预期值
元数据
表情包的元数据存储于 meta 字段中。
name
表情包名称,建议使用命名空间以防命名冲突。
namespace
短命名空间,用于在编辑器中调用。若短命名空间冲突,将使用 name 字段作为命名空间。
title
表情包标题,用于其显示名称,支持使用本地化文本组件。
author
作者信息,支持使用参考元数据组件。
license
授权协议,支持使用参考元数据组件。
地址前缀
为避免重复填写地址数据,可复用的地址片段存储于 path 字段中。
translate
翻译键名前缀,请注意末尾的 . 需手动填写。
images
图片路径前缀,请注意末尾的 / 需手动填写。
图片样式
图片样式信息存储于 image 字段中。
margin
图片外边距,包含以下字段:
start:逻辑行首外边距。end:逻辑行末外边距。-
left:左外边距,仅为兼容而保留,不建议使用。 -
right:右外边距,仅为兼容而保留,不建议使用。
以上字段默认值均为 unset。
rendering
图片重采样方式,可以是以下值:
auto:默认采样方式。pixelated:最近邻(硬边缘)采样。
review_size
图片在编辑器中的预览尺寸,可以是以下值:
small:最小。middle:适中,未填写等效于此值。large:最大。
size
图片在对话框中的尺寸,包含 width 和 height 字段,这两个字段包含以下字段:
value:目标尺寸。max:最大尺寸。min:最小尺寸。
以上字段包含 CSS 长度单位。
is_emoji
是否为文字表情。
show_title
是否在编辑器中鼠标悬停时显示标题,布尔值,默认为 true。搭配 is_emoji 使用可禁用文字表情的悬停提示标题。
内容
表情包内容存储于 content 字段中,类型为数组。
数组中的每一个元素都有一个 type 字段,可以是以下值:
emoji:表情,默认值。group:分组标题。
emoji 类型
当 type 字段为 emoji 时,有以下字段:
name:表情名称。title:表情标题,用于其显示名称,支持使用本地化文本组件,本地化键名前缀为emoji.<path.translate>emoji.。path:图片路径。
group 类型
当 type 字段为 group 时,有以下字段:
title:分组标题,用于其显示名称,支持使用本地化文本组件,本地化键名前缀为emoji.<path.translate>group.。
历史
| 版本 | 描述 |
|---|---|
| 1.5.0 | 加入了 echolive:emoji 注册表。 |
| 1.7.7 | image.margin 新增字段 start 和 end,用于表示逻辑行方向。left 和 right 字段默认值由 0.5em 改为 unset。left 和 right 字段出于兼容考虑仍然保留,但不建议使用。 |
| 1.7.8 | image.isEmoji 更名为 image.is_emoji。 |