本文将指导您如何在 Video.js 视频播放器的控制栏中添加自定义按钮，并确保这些按钮在各种设备上都能正常工作，尤其是在响应式模式下。正如摘要所述，关键在于使用 clickHandler 选项，它能同时响应鼠标点击和触摸事件，从而保证按钮在移动设备上的可交互性。
添加自定义按钮
Video.js 提供了灵活的组件系统，允许开发者轻松扩展播放器的功能。要向 ControlBar 添加自定义按钮，可以使用 addChild 方法。以下是一个示例：
let myButton = player?.controlBar.addChild('button', {
clickHandler: function () {
// 在这里编写按钮点击后的处理逻辑
console.log("自定义按钮被点击了！");
// 例如，你可以调用一个 dispatch 函数
dispatch();
}
});
myButton.controlText('Paramètres (o)'); // 设置按钮的提示文本
// 获取按钮的 DOM 元素
let buttonDom = myButton.el();
// 设置按钮的内容（例如，使用 SVG 图标）
buttonDom.innerHTML = SVG.SETTING_SVG;
// 将按钮插入到 ControlBar 中（在全屏按钮之前）
player?.controlBar
.el()
.insertBefore(myButton.el(), player?.controlBar.getChild('fullscreenToggle').el());代码解释：
- player?.controlBar.addChild('button', { clickHandler: ... }): 这行代码创建了一个新的按钮组件，并将其添加到 ControlBar 中。clickHandler 选项指定了一个函数，该函数将在按钮被点击或触摸时执行。
- clickHandler: function () { ... }: 这是按钮点击事件的处理函数。你可以在这里编写自定义的逻辑，例如调用 dispatch() 函数。
- myButton.controlText('Paramètres (o)'): 设置鼠标悬停在按钮上时显示的提示文本。
- buttonDom.innerHTML = SVG.SETTING_SVG: 设置按钮的内容。通常，你会使用 SVG 图标或其他 HTML 元素来美化按钮。SVG.SETTING_SVG 应该是一个包含 SVG 代码的变量。
- player?.controlBar.el().insertBefore(...): 这行代码将新创建的按钮插入到 ControlBar 中的特定位置。在这个例子中，它被插入到全屏按钮之前。
响应式模式下的注意事项
在响应式模式下，触摸事件的处理方式可能与鼠标点击事件不同。传统的 onclick 事件可能无法正确地处理触摸事件。这就是为什么建议使用 clickHandler 选项的原因。clickHandler 选项确保按钮在所有设备上都能正确响应用户的交互。
完整示例
假设 SVG.SETTING_SVG 的定义如下：
const SVG = {
SETTING_SVG: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><path fill="currentColor" d="M19.14 12.94c.04-.3.07-.59.07-.94s-.03-.64-.07-.94l2.03-1.58c.26-.2.29-.62.09-.85l-2.83-4.88c-.21-.36-.64-.43-.94-.25l-2.39 1.95c-.5-.38-1.03-.7-1.62-.94l-.36-2.54c-.05-.37-.41-.63-.78-.63h-4.15c-.37 0-.73.26-.78.63l-.36 2.54c-.59.24-1.13.56-1.62.94l-2.39-1.95c-.3-.18-.73-.11-.94.25l-2.83 4.88c-.2.23-.17.65.09.85l2.03 1.58c-.04.3-.07.59-.07.94s.03.64.07.94l-2.03 1.58c-.26.2-.29.62-.09.85l2.83 4.88c.21.36.64.43.94.25l2.39-1.95c.5.38 1.03.7 1.62.94l.36 2.54c.05.37.41.63.78.63h4.15c.37 0 .73-.26.78-.63l.36-2.54c.59-.24 1.13-.56 1.62-.94l2.39 1.95c.3.18.73.11.94-.25l2.83-4.88c.2-.23.17-.65-.09-.85l-2.03-1.58zM12 15.5c-1.93 0-3.5-1.57-3.5-3.5s1.57-3.5 3.5-3.5 3.5 1.57 3.5 3.5-1.57 3.5-3.5 3.5z"></path></svg>'
};那么，完整的代码如下：
let myButton = player?.controlBar.addChild('button', {
clickHandler: function () {
// 在这里编写按钮点击后的处理逻辑
console.log("自定义按钮被点击了！");
// 例如，你可以调用一个 dispatch 函数
dispatch();
}
});
myButton.controlText('Paramètres (o)'); // 设置按钮的提示文本
// 获取按钮的 DOM 元素
let buttonDom = myButton.el();
// 设置按钮的内容（例如，使用 SVG 图标）
buttonDom.innerHTML = SVG.SETTING_SVG;
// 将按钮插入到 ControlBar 中（在全屏按钮之前）
player?.controlBar
.el()
.insertBefore(myButton.el(), player?.controlBar.getChild('fullscreenToggle').el());总结
通过使用 clickHandler 选项，可以确保自定义按钮在 Video.js 播放器的 ControlBar 中正常工作，无论是在桌面设备还是移动设备上。这种方法简化了跨平台开发的复杂性，并提供了更好的用户体验。记住，在 clickHandler 函数中编写你的自定义逻辑，并根据需要调整按钮的位置和样式。
