@bbc/psammead-media-indicator

中文文档
6.1.18发布于 2022/04/13Apache-2.0ESM + CJS近 30 天下载 6550

为媒体网页提供播放图标和媒体持续时间

中文使用文档
文档目录10 节
  1. 说明
  2. 安装
  3. 道具
  4. 支助 type 编号
  5. 使用量
  6. 何时使用此组件
  7. 无障碍说明
  8. 捐款
  9. 行为守则
  10. 许可证

半导体-媒体-指标 Known Vulnerabilities Dependency Status peerDependencies Status Storybook GitHub license npm version PRs Welcome

说明

这个 MediaIndicator 组件提供“ play” 、“ audio” 或“ camera” 图标, 以及可选择的持续时间时间戳, 取决于 type 道具 (英语). 组件默认使“ play” 图标 。 本部分既有提供期限也有不提供期限的选择。 如果不提供,它只会制作剧本、音频或相机图标.

安装

npm install @bbc/psammead-media-indicator

道具

参数类型需求默认示例
类型字符串没有"视频""音乐"
脚本对象对不详{ canon: { groupA: { fontSize: '28', lineHeight: '32',}, groupB: { fontSize: '32', lineHeight: '36', }, groupD: { fontSize: '44', lineHeight: '48', }, }, trafalgar: { groupA: { fontSize: '20', lineHeight: '24', }, groupB: { fontSize: '24', lineHeight: '28', }, groupD: { fontSize: '32', lineHeight: '36', }, }, }
服务字符串对不详'news'
目录字符串没有'ltr''rtl'
内在布尔没有虚假真实
儿童节点没有无效

支助 type编号

  • 'video'
  • 'audio'
  • 'photogallery'

使用量

此组件的典型使用大小写被放在了 promos 内部的图像上,用于在页面上方包含视频资产的文章. 它向用户表示,链接是一个视频,视频的持续时间有多长.

顶级剧情片也可以有相关故事链接 Index Alsos当索引项目也是视频、音频或相机时,应当使用 MediaIndicator 组件通过 isInline 道具 (英语).

import MediaIndicator from '@bbc/psammead-media-indicator';
import { latin } from '@bbc/gel-foundations/scripts';

<MediaIndicator type="audio" script={latin} service="news" />;

使用此组件时,确保您添加相关的间隔.

举个例子.

import styled from '@emotion/styled';
import MediaIndicator from '@bbc/psammead-media-indicator';
import { latin } from '@bbc/gel-foundations/scripts';

const TimeDuration = styled.time`
  margin: 0 ${GEL_SPACING_HLF};
`;

<MediaIndicator type="audio" script={latin} service="news">
  <TimeDuration datetime="PT2M15S">2:15</TimeDuration>
</MediaIndicator>;

何时使用此组件

这个 MediaIndicator 组件被设计用于一个图像上方,该图像正在链接到一个基于该图像的包含视频、音频或相片的页面。 它告诉用户期望网页上有视频、音频或相片内容,如果适用,需要多长时间.

而且,它被用于Top故事 ropos into Index Alsos 媒体链接.

无障碍说明

此组件标记为 aria-hidden="true",这意味着它应该被屏幕阅读器忽略. 预计媒体 " 舞会 " 将提供有关其内容的详细信息,例如宣传标题中以可视化隐藏文字显示的长度.

捐款

Psammead完全开源. 我们感谢任何贡献,无论是新的组件、错误修正还是总体改进。 请参看我们的主要贡献指南,可查阅: psammead 仓库的根。 。 。 .

行为守则

我们欢迎对这项工作的反馈和帮助。 通过参与这个项目,你同意遵守 行为守则请稍候再读一下.

许可证

萨姆米德 Apache 2.0 许可。 。 。 .

版本与发布记录

@bbc/psammead-media-indicator 共发布 127 个版本,首次发布于 2019/04/25;过去 12 个月发布了 0 个版本。

版本发布日期距今
6.1.18latest2022/04/134 年前
6.1.172022/04/084 年前
6.1.162022/03/304 年前
6.1.152022/03/294 年前
6.1.142022/01/064 年前
6.1.132021/11/304 年前

其他发布通道:alpha → 5.0.0-alpha.0。

关于 @bbc/psammead-media-indicator 的常见问题

@bbc/psammead-media-indicator 是什么?

为媒体网页提供播放图标和媒体持续时间

如何安装 @bbc/psammead-media-indicator?

在项目目录运行 npm install @bbc/psammead-media-indicator,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=16.9.0)、@emotion/styled(^11.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@bbc/psammead-media-indicator 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/bbc__psammead-media-indicator 是否存在。

@bbc/psammead-media-indicator 支持 ESM 还是 CommonJS?

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

@bbc/psammead-media-indicator 可以商用吗?

@bbc/psammead-media-indicator 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@bbc/psammead-media-indicator 的下载量有多少?

根据 npm 官方下载统计,@bbc/psammead-media-indicator 在 2026/10/08 – 2026/11/06 这 30 天内被下载 6,550 次,日均约 218 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@bbc/psammead-media-indicator 还在维护吗?

最新版本 6.1.18 发布于 2022/04/13(4 年前);至今共发布 127 个版本,其中过去 12 个月发布了 0 个;首次发布于 2019/04/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。