第36章 Flarum Emoji 扩展使用指南：渲染、设置与镜像配置

版本：2.x

Emoji

Emoji 扩展（flarum/emoji）会把帖子中的 emoji 显示为 Twemoji 图片，这样在所有设备上呈现效果都一致。它还能把 :) 这类文字表情符号自动转换成 emoji，并在编辑器中添加一个 emoji 选择器。这是一个内置扩展，默认已启用。

它没有权限设置：所有能发帖的用户都可以使用。

在帖子中添加 emoji

输入 : 加上 emoji 名称的开头，比如 :smi，然后从弹出的列表中选择即可。编辑器工具栏中的「插入 emoji」按钮也会打开同样的列表。用户也可以直接用键盘输入或粘贴 emoji。

从列表中选择的 emoji 会以真正的 emoji 字符插入帖子。如果直接输入完整名称（如 :rocket:）而不从列表中选择，它会保留为文字。

表情符号

以下文字表情符号会显示为对应的 emoji：

输入 得到 :) 🙂 :D 😃 :P 😛 :( 🙁 :| 😐 ;) 😉 :'( 😢 :O 😮 >:( 😡

emoji 的显示方式

帖子以普通字符的形式存储 emoji。帖子展示时，每个 emoji 会被替换为从 CDN 加载的 Twemoji 图片。这些图片采用懒加载方式，滚动到可视区域时才加载。

如果禁用该扩展，帖子中的 emoji 字符会保留，读者看到的是其设备自带的 emoji 样式。文字表情符号则恢复为原样显示，比如 :)。重新启用扩展后，它们又会显示为 emoji。

设置

设置 默认值 说明 CDN 镜像地址 https://cdn.jsdelivr.net/gh/jdecked/twemoji@[version]/assets/ Twemoji 图片的加载来源。[version] 会被替换为扩展所使用的 Twemoji 版本号，显示在该设置项下方。

可以修改此地址以使用镜像，例如当 jsDelivr 对你的用户来说太慢或被屏蔽时，或者用来自行托管这些图片。地址必须以 / 结尾，并能提供 Twemoji assets 中 72x72/ 文件夹下的 PNG 图片。