@financial-times/o-header

中文文档
15.5.2发布于 2026/07/14MITES Module零依赖近 30 天下载 3476

财政反应 带有初级和二级导航、降下特大菜单和可折叠抽屉的时代页头

中文使用文档
文档目录9 节
  1. 使用量
  2. 标记
  3. Java 脚本
  4. 活动
  5. 萨斯
  6. 浏览器支持
  7. 移徙指南
  8. 联系人
  9. 许可证

头部

FT品牌网站响应头. 见 折纸导航服务 要填充 o-header 以真实导航数据标记.

使用量

检查出来 如何将 Origami 组件纳入您的项目 开始 o-header。 。 。 .

标记

由于标题有不同之处,而且每个标题的加分都具体和比较广泛,我们建议访问 组件页 在故事书中找到最适合你的产品的标记。 组件页面上的演示不会使用真实的导航数据,因为它可能会过时. 见 折纸导航服务 要填充 o-header 以真实导航数据标记。 Origami导航服务是一个JSON API,它提供导航结构,供跨FT网站使用.

我们无意在客户端这么做 故意在输入和输出之间不设课 这个留给产品处理.

信头内部的一些元素需要特定的数据属性,所以JavaScript可以正确添加一些行为. 它们是:

  • data-o-header-no-js:应用于根元素. 当 JavaScript 通知时此数据属性被删除
  • 数据-o-header-sticky:应用于标题的粘性变异
  • 数据-o-header-mega:应用于根 <div> 大菜单
  • 数据-o-header-搜索:应用于根 <div> 会 议 日 程 和 议 程 增强 搜索行。 有两个搜索行,一个用于增强,另一个用于核心
  • 数据-o-header-绘图器:应用于根 <div> 抽屉
  • data-o-header-subnav: 应用到根上 div 子导航菜单
  • 数据-o-header-subnav-wrapper: 应用到内包装器 div 让JS能处理滚动
  • data-o-header-search-state:可选,可以是"打开"或"关闭"来表示搜索栏的默认能见度.

子导航头可以使用modifer类 o-header__subnav--primary 实现符合主导航的样式,其中项目链接为粗体并大写,背景颜色为 paper。 。 。 .

Java 脚本

必须为每个 <header> 您的页面中含有使用此组件的内容.

import oHeader from '@financial-times/o-header';
const headerEl = document.querySelector('.o-header');
const header = new oHeader(headerEl);

O-header 构建器接受一个可选选项对象,用于控制某些行为:

  • searchState:可能是"打开"或"关闭",以确定信头的搜索栏是否立即可见. 默认情况下,搜索栏会被隐藏.
import oHeader from '@financial-times/o-header';
const headerEl = document.querySelector('.o-header');
const header = new oHeader(headerEl, {searchBarOpen: true});

或者,a o.DOMContentLoaded 事件可以在文档中发出,为每个元素自动构造一个 o-header 对象,并带有 data-o-component="o-header" 属性 :

import '@financial-times/o-header';
document.addEventListener('DOMContentLoaded', function () {
    document.dispatchEvent(new CustomEvent('o.DOMContentLoaded'));
});

活动

o-header发射以下事件:

  • oHeader.MegaMenuShow: 当显示一个巨型菜单时。 事件的目标是菜单本身.
  • oHeader.MegaMenuClose:当一个特大菜单被关闭时. 事件的目标是菜单本身.
  • oHeader.Sticky:当信头更改为或从粘相. 活动细节将包括: isActive 布尔表示粘不粘。 事件的目标是菜单本身.

萨斯

标题由各种特征组成(如. nav, (中文(简体) ), search,以及 drawer) (中文(简体) ). 为了得到一切,使用 oHeader() 无参数混合。 要得到所需的东西,你可以通过一个选项列表作为第一个参数.

备选方案清单如下:

  • top: 第一行头的样式,包括抽屉菜单和搜索栏的标志和按钮.
  • nav:主导航,是直接坐落在头部上部的导航.
  • search:当用户按下搜索图标时出现的搜索栏.
  • anon: 当用户未登录时出现的行样式.
  • sticky:向下滚动时使页眉粘住页顶的样式.
  • simple: 文章页所减少的更瘦头的样式.
  • transparent: 无背景颜色和白色文字及标志的"反向"标题的样式. 仅供黑暗背景使用。 目前不支持导航抽屉( 如果您想要使用此变体的抽屉, 请向 Origami 报告 ).
  • megamenu: 当用户在导航项目上徘徊时出现的特大菜单的样式.
  • drawer: 用作小屏幕上主导航的抽屉菜单样式.

仅用于特性的输出样式,不包括所有特性所需的基准标题样式,通过 false 作为第二个论点.

举个例子 为了获得FT主页所需的所有CSS,你会打电话:

@include oHeader(('sticky', 'simple', 'anon', 'search', 'nav', 'megamenu'));

浏览器支持

用于 o-header 设置一个 核心和增强的经验 在你的项目. o-header 取决于 o--if-js 财务报告和审定财务报表 o--if-no-js 课程.

移徙指南

状态主要版本最后一个小版本移徙指南
维护页:1不详迁移到 v14
已贬值第13条13.1 国家迁移到 v13
已贬值第12条不详迁移到 v12
已贬值第11个不详迁移到 v11
已贬值10个不详迁移到 v10
已贬值第9条不详迁移到 v9
已贬值第8条8.6 请检查date=中的日期值 (帮助)迁移到 v8
已贬值第7条7.8 请检查date=中的日期值 (帮助)迁移到 v7
已贬值6个6.14 联合国迁移到 v6
已贬值页:15.0 (中文(简体) )- 说吧
已贬值页:14.0 (韩语)- 说吧
已贬值3个3.0 调用- 说吧
已贬值2个2.5 国家- 说吧
已贬值1个1.1 国家- 说吧

联系人

如果您对本部分有任何问题或评论,或需要帮助使用本部分,请 提出问题访问 #origami - 支持 或电子邮件 折纸支持。 。 。 .


许可证

本软件由金融时报根据以下规定出版: 麻省理工学院许可证。 。 。 .

版本与发布记录

@financial-times/o-header 共发布 91 个版本,首次发布于 2019/02/13;过去 12 个月发布了 6 个版本。

版本发布日期距今
15.5.2latest2026/07/144 个月前
15.5.12026/07/094 个月前
15.5.02026/04/087 个月前
15.4.12026/03/247 个月前
15.4.02026/03/048 个月前
15.3.12026/02/149 个月前

其他发布通道:prerelease → 9.0.0-beta.0。

关于 @financial-times/o-header 的常见问题

@financial-times/o-header 是什么?

财政反应 带有初级和二级导航、降下特大菜单和可折叠抽屉的时代页头

如何安装 @financial-times/o-header?

在项目目录运行 npm install @financial-times/o-header,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@financial-times/math(^1.0.0)、@financial-times/o-brand(^4.1.0)、@financial-times/o-forms(^10.0.0)、@financial-times/o-utils(^2.0.0)、@financial-times/o-toggle(^3.2.6)、@financial-times/o-viewport(^5.1.2)、@financial-times/o-private-foundation(^1.0.4)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@financial-times/o-header 支持 TypeScript 吗?

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

@financial-times/o-header 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@financial-times/o-header 可以商用吗?

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

@financial-times/o-header 的下载量有多少?

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

@financial-times/o-header 还在维护吗?

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