Video.js 博客

Steve Heffernan2013-11-05

Video.js 4.3.0 版发布,附带全新 API 文档

此次更新最大的变化实际上是对 API 文档 的全面修订。新文档的最佳示例是 播放器文档,这是大多数 Video.js 用户将使用的 API。

新文档现在从代码和代码注释中自动生成,使其更容易与代码库中的当前内容保持同步。

关于文档生成器,一个有趣的方面是它使用了 esprima,一个读取 JavaScript 文件并返回抽象语法树的工具。

对于以下 JavaScript 代码

var hi;

Esprima 会生成

{
    "type": "Program",
    "body": [
        {
            "type": "VariableDeclaration",
            "declarations": [
                {
                    "type": "VariableDeclarator",
                    "id": {
                        "type": "Identifier",
                        "name": "hi"
                    },
                    "init": null
                }
            ],
            "kind": "var"
        }
    ]
}

我们我们正在使用 Video.js 代码库的 AST 来生成文档中的大部分信息,这意味着在持续构建过程中,保持文档的卓越性所需的注释和工作量更少。如果您有兴趣了解我们如何处理,请查看 doc-generator 仓库(它目前仅对 Video.js 代码库有用,但可以扩展以支持更多情况)。

新 CSS 选项

其他更新包括新的加载动画图标选项,以及用于居中显示大播放按钮的新类。

许多用户已经明确表示,他们希望大播放按钮位于视频中央。虽然我们认为趋势仍在朝着将播放按钮移出内容区域的方向发展,但我们希望使此功能更易于自定义。您现在可以在视频标签上使用 vjs-big-play-centered 类来居中播放按钮。

要尝试新的加载动画图标选项,请查看 设计器 并更改加载动画类使用的图标名称。

更多插件!

最后,最令人兴奋的进展实际上发生在 Video.js 社区中,越来越多的插件正在被构建。我们插件列表 中已有 26 个,并且还在不断增加。

如果您有一些代码,您已基于 Video.js 构建,并且您认为可能对他人有价值,请在插件列表上分享,或者如果您对插件流程有疑问,请在 Video.js 仓库上提交问题。

变更日志完整列表

  • 添加 Karma 用于跨浏览器单元测试 (查看)
  • 音量改变时取消静音 (查看)
  • 修复大播放按钮的可访问性问题 (查看)
  • 导出用户活动方法 (查看)
  • 添加类名以居中播放按钮和新的加载动画选项 (查看)
  • 添加 API 文档生成功能 (查看)
  • 添加对 Flash mime 类型中编解码器的支持 (查看)

新版本已在 videojs.com 上提供,并已添加到 CDN。

此致,

-heff