
本文将指导您如何在 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: ''
};那么,完整的代码如下:
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 函数中编写你的自定义逻辑,并根据需要调整按钮的位置和样式。










