npm 包 asciinema-player 使用教程

阅读时长 4 分钟读完

在前端开发中,有时候需要展示一些终端命令操作或者录制的终端会话,这时候可以使用 asciinema 进行录制和分享。而 asciinema-player 是一个基于 JavaScript 的 asciinema 播放器库,它可以让你在网页上播放录制好的 asciinema 文件。本文将介绍如何使用 asciinema-player 库,并提供一些示例代码及指导意义。

安装

你可以通过 NPM 来安装 asciinema-player 库:

如何使用

引入库文件

在 HTML 页面中引入 asciinema-player.js 文件:

或者,你也可以通过 CDN 引用:

创建播放器

在 HTML 中创建一个容器元素,给它分配一个 ID。该元素将作为 asciinema 播放器的容器。

接下来,在 JavaScript 中使用 asciinema.player.js 提供的 AsciinemaPlayer 类创建一个播放器实例,并将其连接到容器元素中:

注意,第二个参数传递的是录制好的 asciinema 文件的路径。你还需要将该文件上传到服务器或者使用本地文件系统中的绝对路径。

配置选项

AsciinemaPlayer 构造函数还接受一个可选的配置对象,可以用于配置播放器的行为,例如控制播放速度、隐藏命令提示符等。以下是一些常见的选项:

  • loop: 指定是否循环播放,默认值为 false
  • autoplay: 指定是否自动播放,默认值为 false
  • preload: 指定是否预加载 asciinema 文件,默认值为 auto。可以设置为 none 表示不预加载,或者设置为 metadata 表示只预加载元数据。
  • poster: 指定封面图像的 URL,当 asciinema 文件无法加载时会显示该图像。

例如,要创建一个自动播放的 asciinema 播放器,并隐藏命令提示符,可以这样配置选项:

控制播放器

AsciinemaPlayer 实例提供了一些方法和事件,用于控制播放器的行为,例如暂停/继续、跳转到指定时间等。

此外,AsciinemaPlayer 实例还提供了一些事件,在特定的播放器状态下触发。例如,当播放器开始播放时触发 play 事件:

示例代码

以下是一个完整的示例,它将创建一个 asciinema 播放器,并在页面加载后自动播放录制好的 asciinema 文件。

-- -------------------- ---- -------
--------- -----
------
  ------
    ----- --------------- --
    ----------------------- ------------
    ------- -------------------------------------------------------

- ----------------------------------------------------------- --------
----------------------------------------------------------------------------------
纠错
反馈