PiPButton

预计阅读时间: 2 分钟

画中画(PiP)切换按钮,具有键盘支持和状态反射功能。

结构

<PiPButton />

行为

切换画中画(PiP)模式。通过 availability 检测平台支持 — 当 PiP 为 "unsupported" 时,切换操作无效。

样式

你可以根据 PiP 状态设置按钮样式:

/* PiP 模式 */
.pip-button[data-pip] {
  background: red;
}

当不支持 PiP 时考虑隐藏按钮:

.pip-button[data-availability="unsupported"] {
  display: none;
}

无障碍

渲染一个 <button> 元素,带有自动的 aria-label:"Enter PiP" 或 "Exit PiP"。可通过 label 属性覆盖。键盘激活:Enter / Space

示例

基本用法

import { PiPButton } from '@videojs/react';

function Controls() {
  return <PiPButton />;
}

API 参考

属性

属性类型默认值描述
disabledbooleanfalse是否禁用按钮
labelstring自动覆盖默认的 aria-label
renderRenderProp-自定义渲染函数

状态

状态类型描述
availability"available" | "unsupported"PiP 功能的可用性
pipboolean是否处于画中画状态
labelstring当前按钮标签

Data 属性

属性描述
data-pip-当处于画中画状态时存在
data-availability"available" | "unsupported"PiP 功能的可用性状态

参见