artalkjs/docs/develop/fe-api.md

Frontend API

初始化 Artalk.init

创建 Artalk 实例化对象。

Artalk.init({
  el:        '#Comments',
  pageKey:   '/post/1',
  pageTitle: '关于引入 Artalk 的这档子事',
  server:    'http://your_domain:8080',
  site:      'Artalk 的博客',
})

更新配置 Artalk.update

修改 Artalk 当前配置。

Artalk.update({
  // 新的配置...
})

该函数调用后，conf-loaded 事件将被触发。

更新配置不会自动刷新评论列表，可按需继续执行 Artalk.reload() 函数。

注：前端的一些配置将会被后端的配置覆盖，详情见：在后端控制前端

重新加载 Artalk.reload

刷新 Artalk 评论列表。

Artalk.reload()

列表加载前将触发 list-load 事件，加载完毕后将触发 list-loaded 事件。

释放资源 Artalk.destroy

销毁 Artalk 实例，用于资源释放。

Artalk.destroy()

事件监听 Artalk.on

添加 Artalk 事件监听。

Artalk.on('list-loaded', () => {
  alert('评论列表加载完毕')
})

可监听事件类型见：前端界面事件

解除监听 Artalk.off

解除 Artalk 事件监听。

const handler = () => {
  alert('评论列表加载完毕')
}

Artalk.on('list-loaded', handler)
Artalk.off('list-loaded', handler)

触发事件 Artalk.trigger

触发 Artalk 事件。

Artalk.trigger('list-loaded')

扩展插件 Artalk.use

该 API 用于扩展 Artalk。

Artalk.use((ctx) => {
  ctx.editor.setContent("Hello World")
})

详情见：插件开发

夜间模式 Artalk.setDarkMode

修改夜间模式，可以配合博客主题调用，例如当用户点击夜间模式切换按钮。

Artalk.setDarkMode(true)

浏览量组件 Artalk.loadCountWidget

详情见：浏览量统计