@gfazioli/mantine-video

中文文档
1.2.10发布于 2026/11/09MITTypeScriptESM + CJS零依赖近 30 天下载 5.3万

由Mantine所建的 React 的自定义视频播放器组件 。 曼汀生态系统风格中的复合API,无头使用Video钩,有主题感知的造型,可访问性,和全Styles API.

中文使用文档
文档目录9 节
  1. 概览
  2. 特征
  3. 安装
  4. 使用量
  5. 自定义控制
  6. 无头 useVideo
  7. 图片中的生命周期
  8. 备选案文
  9. 发起人

Maintine 视频组件

Mantine Video

mantine-video at a glance, refreshed daily: commits, releases, stars, issues and pull requests, a year of commit activity, the weekly rhythm, languages, latest commits and releases, contributors
制造的 外观卡 * 每日刷新

概览

此组件创建于 曼汀语Name 图书馆. 这需要 曼汀 9.x (英语) 财务报告和审定财务报表 反应 19。 。 。 .

曼汀视频 是一个基于标准 HTML 之上的 Mantine 本地视频播放器 <video> 键。 它将一个多态的根元件配对在一起 复合 API (单位:千美元)Video.Controls, (中文(简体) ), Video.PlayButton, (中文(简体) ), Video.Timeline, (中文(简体) ), Video.MuteButton, (中文(简体) ), Video.CaptionsButton, (中文(简体) ), Video.PiPButton, (中文(简体) ), Video.FullscreenButton, (中文(简体) ), Video.SkipButton, (中文(简体) ), Video.TimeDisplay) 和一个完全 无头 useVideo 钩子 因此,您可以使用电池 包括控制栏,用Mantine子组件组成自己的电池,或者在基础状态上建立100%的自定义用户界面。 每个部分都是主题认识(颜色方案,主题颜色,光度,大小),可以访问(ARIA标签,键盘快捷键,焦点管理),并且可以通过完整的曼汀自定义 样式 API (单位:千美元)classNames, (中文(简体) ), styles, (中文(简体) ), vars, (中文(简体) ), unstyled) (中文(简体) ). 四个内置 variant编号 - overlay, (中文(简体) ), minimal, (中文(简体) ), floating, (中文(简体) ), bordered ——覆盖箱外最常见的布局. 全屏和 图片 用于支持标准 API 的浏览器的线入,其中含有能力 QQAWARE 子 组件,在不支持时可以自行隐藏(因此在 Firefox 上从未看到一个被损坏的按钮).

特征

  • 🎬 化合物 API —— 说 Video.Controls, (中文(简体) ), Video.PlayButton, (中文(简体) ), Video.SkipButton, (中文(简体) ), Video.Timeline, (中文(简体) ), Video.TimeDisplay, (中文(简体) ), Video.MuteButton, (中文(简体) ), Video.CaptionsButton, (中文(简体) ), Video.PiPButton, (中文(简体) ), Video.FullscreenButton
  • 🪝 无头 useVideo 钩子 ——全州(playing, (中文(简体) ), currentTime, (中文(简体) ), duration, (中文(简体) ), buffered, (中文(简体) ), volume, (中文(简体) ), muted, (中文(简体) ), playbackRate, (中文(简体) ), fullscreen, (中文(简体) ), pip, (中文(简体) ), canPlay, (中文(简体) ), canFullscreen, (中文(简体) ), canPiP, (中文(简体) ), isLoading, (中文(简体) ), error和行动play, (中文(简体) ), pause, (中文(简体) ), toggle, (中文(简体) ), seek, (中文(简体) ), seekBy, (中文(简体) ), setVolume, (中文(简体) ), toggleMute, (中文(简体) ), setPlaybackRate, (中文(简体) ), toggleFullscreen, (中文(简体) ), togglePiP(中文(简体) )
  • 🎭 四个变体 —— 说 overlay (默认,YouTube-style), minimal, (中文(简体) ), floating, (中文(简体) ), bordered
  • 🎨 曼汀主题集成 —— 说 color, (中文(简体) ), radius, (中文(简体) ), size 道具加全色- 化学意识
  • 🎨 样式 API —— 说 classNames, (中文(简体) ), styles, (中文(简体) ), vars, (中文(简体) ), unstyled 在每一个方面
  • ⌨️ 键盘快捷键 - 空间/K(播放/暂停)、J/L(±10s)、←/(±5s)、↑/↓(音量)、M(mute)、F(全屏)、P(PiP)
  • 🖥️ 全屏 + 图片 + 图片 离开盒子,能力知觉
  • 🗣️ 说明/字幕 通过本地 <track> ——当没有音轨时切换自动按键
  • 🔀 多个来源 - 通过一个 sources 数组可以传送多个格式/代码,并让浏览器选择第一个可以播放的格式/代码(每个条目支持) type 财务报告和审定财务报表 media),与 fallbackSrc 如果每个源在运行时失败, 则装入
  • 🎛️ 受控+无控 页:1 playing, (中文(简体) ), currentTime, (中文(简体) ), volume, (中文(简体) ), playbackRate
  • ♿ 无障碍 - ARIA标签, aria-pressed 切换图,焦点可看到大纲
  • 📦 类型脚本 ——全型安全,每道道具有记载

[!注]

→ 演示文稿和文件 → Youtube 视频 → 更多曼汀组件

安装

npm install @gfazioli/mantine-video

或者说

yarn add @gfazioli/mantine-video

在应用程序根部安装导入包样式后:

import '@gfazioli/mantine-video/styles.css';

或使用内部分层版本 @layer mantine-video数字 :

import '@gfazioli/mantine-video/styles.layer.css';

使用量

最简单的用法——通过 src,可选 poster 财务报告和审定财务报表 aspectRatio,然后得到一个完全的主题播放器,其中包含播放 / 暂停,可搜索的时间线,时间显示,音量,字幕,图片 in 图片和全屏出框 :

import { Video } from '@gfazioli/mantine-video';

function Demo() {
  return (
    <Video
      src="https://example.com/video.mp4"
      poster="https://example.com/poster.jpg"
      aspectRatio={16 / 9}
    />
  );
}

自定义控制

默认控制栏只是复合子组件的合理组成。 过 controls={false} 并提供自己的 <Video.Controls> 孩子们可以完全自定义布局——重新排序、放出、添加或主题任意部分:

import { Video } from '@gfazioli/mantine-video';

function Demo() {
  return (
    <Video src="https://example.com/video.mp4" aspectRatio={16 / 9} controls={false}>
      <Video.Controls>
        <Video.PlayButton />
        <Video.SkipButton seconds={-10} />
        <Video.SkipButton seconds={10} />
        <Video.Timeline />
        <Video.TimeDisplay format="current/-remaining" />
        <Video.MuteButton />
        <Video.CaptionsButton />
        <Video.PiPButton />
        <Video.FullscreenButton />
      </Video.Controls>
    </Video>
  );
}

无头 useVideo

如果您需要完全自定义的用户界面, 请跳过 <Video> 并使用 useVideo 直接钩入. 它返回视频状态和整套动作 videoRef 对本地人 <video> 元素 :

import { ActionIcon, Slider } from '@mantine/core';
import { IconPlayerPauseFilled, IconPlayerPlayFilled } from '@tabler/icons-react';
import { useVideo } from '@gfazioli/mantine-video';

function Demo() {
  const video = useVideo();

  return (
    <div>
      <video ref={video.videoRef} src="https://example.com/video.mp4" />
      <ActionIcon onClick={video.toggle}>
        {video.playing ? <IconPlayerPauseFilled /> : <IconPlayerPlayFilled />}
      </ActionIcon>
      <Slider value={video.currentTime} max={video.duration} onChange={video.seek} />
    </div>
  );
}

图片中的生命周期

进入用户打开视频的出入口,例如暗化一个侧边栏,或在页面的别处显示"在PiP中玩"指标:

<Video
  src="..."
  onEnterPictureInPicture={() => console.log('entered PiP')}
  onLeavePictureInPicture={() => console.log('left PiP')}
/>

备选案文

备选案文说明
overlay (默认)控制在视频底部以梯度为背景浮出水面,在徘徊时逐渐淡出,在播放时自动隐藏
minimal在页面流中放在视频下方的控件, 没有覆盖
floating喜欢 overlay 但酒吧是圆形浮牌,背景模糊
bordered将相接的容器包装在下面的视频和控制器,这是卡片/列表的理想

发起人

你的支持帮助了我:

  • 积极维护项目,及时修复错误并更新安全信息
  • 添加新特性, 提高性能,并完善开发者的经验
  • 扩大测试范围和文件,以更顺利地采用
  • 确保长期可持续性而不依赖临时自由时间
  • 优先处理最重要的社区请求和路线图项目

开放源码的繁荣,如果受益的人能够回报——即使每月的小额捐款也会产生真正的变化。 赞助有助于覆盖维护时间、基础设施和无数使项目保持健康的无形任务.

你的帮助真的很重要.

💚 成为提案国 今天,帮助我保持这一项目的可靠性,更新,并为每个人成长.

版本与发布记录

@gfazioli/mantine-video 共发布 19 个版本,首次发布于 2026/05/18;过去 12 个月发布了 19 个版本。

版本发布日期距今
1.2.10latest2026/11/096 天前
1.2.92026/11/069 天前
1.2.82026/10/2621 天前
1.2.72026/10/2224 天前
1.2.62026/10/131 个月前
1.2.52026/10/101 个月前

关于 @gfazioli/mantine-video 的常见问题

@gfazioli/mantine-video 是什么?

由Mantine所建的 React 的自定义视频播放器组件 。 曼汀生态系统风格中的复合API,无头使用Video钩,有主题感知的造型,可访问性,和全Styles API.

如何安装 @gfazioli/mantine-video?

在项目目录运行 npm install @gfazioli/mantine-video,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18.x || ^19.x)、react-dom(^18.x || ^19.x)、@mantine/core(>=9.0.0)、@mantine/hooks(>=9.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@gfazioli/mantine-video 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@gfazioli/mantine-video 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@gfazioli/mantine-video 可以商用吗?

@gfazioli/mantine-video 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gfazioli/mantine-video 的下载量有多少?

根据 npm 官方下载统计,@gfazioli/mantine-video 在 2026/10/17 – 2026/11/15 这 30 天内被下载 53,275 次,日均约 1,776 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gfazioli/mantine-video 还在维护吗?

最新版本 1.2.10 发布于 2026/11/09(6 天前);至今共发布 19 个版本,其中过去 12 个月发布了 19 个;首次发布于 2026/05/18。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。