Skip to content
On this page

Frontend API

初始化 Artalk.init

创建 Artalk 实例化对象。

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

更新配置 Artalk.update

修改 Artalk 当前配置。

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

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

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

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

重新加载 Artalk.reload

刷新 Artalk 评论列表。

js
Artalk.reload()
Artalk.reload()

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

释放资源 Artalk.destroy

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

js
Artalk.destroy()
Artalk.destroy()

事件监听 Artalk.on

添加 Artalk 事件监听。

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

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

解除监听 Artalk.off

解除 Artalk 事件监听。

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

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

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

触发事件 Artalk.trigger

触发 Artalk 事件。

js
Artalk.trigger('list-loaded')
Artalk.trigger('list-loaded')

扩展插件 Artalk.use

该 API 用于扩展 Artalk。

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

详情见:插件开发

夜间模式 Artalk.setDarkMode

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

js
Artalk.setDarkMode(true)
Artalk.setDarkMode(true)

浏览量组件 Artalk.loadCountWidget

详情见:浏览量统计