Skip to content

表情包

你可以在 控制中心 的设置界面修改此配置,也可以通过 配置文件环境变量 进行配置。

在配置文件中,可在 frontend.emoticons 填入表情包列表 URL:

yaml
frontend:
  emoticons: https://raw.githubusercontent.com/ArtalkJS/Emoticons/master/grps/default.json

表情包预设

Artalk 社区提供许多表情包预设,你能够挑选几套喜欢的表情包,仅需简单的配置,轻松添加到你的评论系统中,前往仓库:@ArtalkJS/Emoticons

格式支持

OwO 格式

OwO 是作者 @DIYgod 开发的开源 JS 插件,能让输入框快速拥有插入表情符号的功能。

Artalk 的表情包功能借鉴了其优秀的设计,并且 Artalk 原生适配和兼容 OwO 格式的表情包数据文件,示例如下:

yaml
frontend:
  emoticons: https://raw.githubusercontent.com/DIYgod/OwO/master/demo/OwO.json
  # 直接使用 OwO 格式的表情包 ↑↑

社区也有许多可以直接使用的 OwO 格式表情包资源,例如:@2X-ercha/Twikoo-Magic

Artalk 表情包列表文件标准格式

Artalk 除了支持 OwO 格式外,还内置支持一种标准的表情包列表文件格式:

js
[
  {
    name: '颜表情',
    type: 'emoticon', // 字符类型
    items: [
      { key: 'Hi', val: '|´・ω・)ノ' },
      { key: '开心', val: 'ヾ(≧∇≦*)ゝ' },
      //...
    ],
  },
  {
    name: '滑稽',
    type: 'image', // 图片类型
    items: [
      {
        key: '原味稽',
        val: '<图片 URL>',
      },
      //...
    ],
  },
]

前端配置

在前端配置表情包列表,例如:

js
Artalk.init({
  // 默认表情包列表,动态引入 ↓↓
  emoticons:
    'https://raw.githubusercontent.com/ArtalkJS/Emoticons/master/grps/default.json',
})

TIP

配置文件和控制中心的表情包设置优先级高于前端配置。

关闭表情包

你可以将 emoticons 设置为 false 来禁用表情包功能:

js
Artalk.init({
  emoticons: false,
})

加载方式

动态加载

emoticons 属性设置为表情包数据文件的 URL,当打开表情包列表时,Artalk 会动态引入。

js
Artalk.init({
  emoticons: '<表情包数据文件 URL>',
})

远程的表情包文件支持 Artalk、OwO 格式,且支持嵌套、混合加载。

静态加载

相较于动态引入,可以将表情包列表对象,作为 Artalk 配置,静态保存在页面的 JS 代码中,避免动态加载:

js
Artalk.init({
  emoticons: [
    {
      name: '颜表情',
      type: 'emoticon', // 字符类型
      items: [
        { key: 'Hi', val: '|´・ω・)ノ' },
        { key: '开心', val: 'ヾ(≧∇≦*)ゝ' },
        //...
      ],
    },
    {
      name: '滑稽',
      type: 'image', // 图片类型
      items: [
        {
          key: '原味稽',
          val: '<图片 URL>',
        },
        //...
      ],
    },
  ],
})

混合加载

Artalk 支持 动态静态 混合加载,例如:

js
Artalk.init({
  emoticons: [
    // 动态加载
    'https://raw.githubusercontent.com/DIYgod/OwO/master/demo/OwO.json', // OwO 格式表情包
    'https://raw.githubusercontent.com/qwqcode/huaji/master/huaji.json',
    // 静态加载
    {
      name: '表情包名字',
      type: 'emoticon', // 字符类型
      items: [
        { key: '去吧大师球', val: '(╯°A°)╯︵○○○' },
        //...
      ],
    },
  ],
})

嵌套引入

Artalk 支持远程表情包资源中嵌套引入另外的表情包资源,例如:

js
Artalk.init({
  emoticons: ['https://example.org/表情包.json'],
})

文件 表情包.json 中的数据:

json
[
  "https://example.org/其他表情包.json",
  //...
  {
    // Artalk 格式、OwO 格式
    //...
  }
]

贡献者

页面历史