@financial-times/o-editorial-typography

中文文档
2.4.2发布于 2026/02/26MITES Module零依赖近 30 天下载 1.2万

编辑内容的打字风格.

中文使用文档
文档目录6 节
  1. 使用量
  2. 标记
  3. 萨斯
  4. 移徙
  5. 联系人
  6. 许可证

⚠️ 注: o-编辑-打字法已替换为 o3 编辑-打字法请参看 移徙指南 用于升级的步骤.

o-编辑-打字法

编辑内容的打字风格.

o-打字法 为用户界面提供基本的打字工具和样式. o-编辑-打字法以编辑内容的打字法为基础,包括头条、标签和副线。 它没有假设编辑打字法将在哪里使用 -- -- 它可以是一页、另一个组件或电子邮件等 -- -- 因此没有提供默认边距。 在文章中应用打字和排版编辑打字 o-编辑外传。 。 。 .

使用量

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

标记

标题

标题1 -6为课目 o-editorial-typography-heading-level-[level]数字 :

<h1 class="o-editorial-typography-heading-level-1">Heading level 1</h1>
<h2 class="o-editorial-typography-heading-level-2">Heading level 2</h2>
<h3 class="o-editorial-typography-heading-level-3">Heading level 3</h3>
<h4 class="o-editorial-typography-heading-level-4">Heading level 4</h4>
<h5 class="o-editorial-typography-heading-level-5">Heading level 5</h5>

标题1适用于大多数情况,但更注重使用 o-editorial-typography-headline 换句话说.

<h1 class="o-editorial-typography-headline">Don&rsquo;t settle for black and white</h1>

体质

段落使用 o-editorial-typography-body 类 :

<p class="o-editorial-typography-body">Lorem ipsum dolor sit amet consectetur adipisicing elit.</p>

名单

顺序列表和无顺序列表都有样式. 使用类 o-editorial-typography-list 和 o-editorial-typography-list--ordered 或者说 o-editorial-typography-list--unordered。 。 。 .

因此列表可能被用于不同的上下文,它们继承了大小和家族等字体属性. 因此它需要将字体样式应用到母元素上. 例如,可以用下列方法做到这一点: o-editorial-typography-body。 。 。 .

<div class="o-editorial-typography-body">
    <ul class="o-editorial-typography-list o-editorial-typography-list--unordered">
        <li>Lorem ipsum&nbsp;adipiscing elit.</li>
        <li>Sed feugiat turpis at massa tristique.</li>
        <li>Curabitu r accumsan elit luctus.</li>
    </ul>
</div>
<div class="o-editorial-typography-body">
    <ol class="o-editorial-typography-list o-editorial-typography-list--ordered">
        <li>Lorem ipsum&nbsp;adipiscing elit.</li>
        <li>Sed feugiat turpis at massa tristique.</li>
        <li>Curabitu r accumsan elit luctus.</li>
    </ol>
</div>

主题标记

有主题标签的内容的参考类别. 主题标记通常是一个锚,但如果没有页面链接则不必是.

没有设置字体大小, 因此标记可能用于不同的上下文 .

<a class="o-editorial-typography-topic" href="#">Topic Link</a>
<span class="o-editorial-typography-topic">Topic Without Link</span>

链接使用 o-editorial-typography-link 内置 a o-editorial-typography-body 集装箱.

<p class="o-editorial-typography-body">
    An article by
    <a href="https://ft.com/" class="o-editorial-typography-link">The Financial Times</a>.
</p>

也提供反向样式,用于暗色背景. 使用 o-editorial-typography-body--inverse 在容器上允许反向样式.

<p class="o-editorial-typography-body o-editorial-typography-body--inverse">
    An article by
    <a href="https://ft.com/" class="o-editorial-typography-link">The Financial Times</a>.
</p>

作者标记

使用类设置作者标签样式 o-editorial-typography-author。一个作者标签通常是一个锚,但如果没有作者页面可以链接,则不必.

<a class="o-editorial-typography-author" href="#">Joe Doe</a>
<span class="o-editorial-typography-author">Joe Doe</span>

时间戳

o-editorial-typography-timestamp 样式为时间戳。 它没有设置字体大小或家族,因此可以用于不同的上下文,例如文章的旁线或评论部分.

<time class="o-editorial-typography-timestamp" datetime="2019-10-11T20:51:54Z" title="October 11 2019 9:51 pm">October 11 2019</time>

按线

故事的旁线可能使用 o-editorial-typography-byline. 常与作者和时间戳样式同时使用.

<div class="o-editorial-typography-byline">
    <a class="o-editorial-typography-author" href="#">Joe Doe</a>
    in London
    <time class="o-editorial-typography-timestamp" datetime="2019-10-11T20:51:54Z" title="October 11 2019 9:51 pm">October 11 2019</time>
</div>

说明

使用样式标题 o-editorial-typography-caption。 。 。 .

<figure>
    <img alt="" src="#">
    <figcaption class="o-editorial-typography-caption">
        ©Lorem John Doe
    </figcaption>
</figure>

萨斯

包含所有 o- Editorial- Typology 样式 oEditorialTypography 混合剂.

@import "@financial-times/o-editorial-typography/main";

@include oEditorialTypography();

为了包括你需要的样式 我们建议设置选项 $opts 参数.

例如只包含标题级别1-3和正文复制样式.

@include oEditorialTypography($opts: (
    'body': true,
    'headings': (1, 2, 3)
));

此示例显示所有选项 :

@include oEditorialTypography($opts: (
    'body': true,
    'lists': ('ordered', 'unordered'),
    'caption': true,
    'headline': true,
    'headings': (1, 2, 3, 4, 5),
    'standfirst': true,
    'author': true,
    'topic': true,
    'byline': true,
    'timestamp': true
));

我们建议包括风格与 oEditorialTypography ,并使用默认标记来减少项目中重复的 CSS 。 但是,如果无法更新标记到 o-editorial-typography 课程。 混合剂包括:

  • oEditorialTypographyHeadline
  • oEditorialTypographyHeading
  • oEditorialTypographyBody
  • oEditorialTypographyList
  • oEditorialTypographyCaption
  • oEditorialTypographyStandfirst
  • oEditorialTypographyByline
  • oEditorialTypographyTimestamp
  • oEditorialTypographyTag
  • oEditorialTypographyDecorated

例如,要输出一个标题:

.my-h2 {
    @include oEditorialTypographyHeading(2);
}

或主题标签 :

.my-topic-tag {
    @include oEditorialTypographyTag('topic');
}

见 o-编辑-打字 详细内容和更多实例.

字体加载

通话 oEditorialTypography 将输出字体面来下载自定义的"金融时报"字体。 然而,IE11可以下载未使用的字体。 要根据您的用法集, 包含更多外观的字体 $o-editorial-typography-load-fonts: false 和使用情况 o-fonts 数据。如果您的工程也使用了 o- typegraphy 并且已经设置 $o-typography-load-fonts (单位:千美元)。 。 。 .

// configure $o-editorial-typography-load-fonts to not include fonts
$o-editorial-typography-load-fonts: false;
// import dependencies
@import '@financial-times/o-editorial-typography/main';
// include css for select fonts manually
@include oFontsInclude(MetricWeb, semibold);
@include oFontsInclude(FinancierDisplayWeb, regular);
@include oFontsInclude(FinancierDisplayWeb, bold);
// include css for all editorial typography
@include oEditorialTypography();

移徙

状态主要版本最后一个小版本移徙指南
活动单位3不详迁移到 o3 编辑- 打字
维护3个不详迁移到 v3
维护2个不详迁移到 v2
维护1个1.1 国家不详

联系人

如果您对本部分有任何问题或评论,或需要帮助使用本部分,请 提出问题访问 {\fn黑体\fs20\shad2\2ah82\3ah20\4ah33\fscx95\3ch592001\be1}#毛发折射 或电子邮件 折纸支持。 。 。 .

许可证

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

版本与发布记录

@financial-times/o-editorial-typography 共发布 34 个版本,首次发布于 2019/11/06;过去 12 个月发布了 1 个版本。

版本发布日期距今
2.4.2latest2026/02/268 个月前
2.4.12023/10/273 年前
2.4.02023/10/163 年前
2.3.52023/08/253 年前
2.3.42023/04/283 年前
2.3.32022/12/213 年前

其他发布通道:prerelease → 2.0.0-beta.0,tag--v1.2.0 → 1.2.0,tag--v1.2.1 → 1.2.1。

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

@financial-times/o-editorial-typography 是什么?

编辑内容的打字风格.

如何安装 @financial-times/o-editorial-typography?

在项目目录运行 npm install @financial-times/o-editorial-typography,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@financial-times/o-fonts(^5.3.5)、@financial-times/o-colors(^6.7.0)、@financial-times/o-spacing(^3.2.5)、@financial-times/o-typography(^7.6.2)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@financial-times/o-editorial-typography 支持 TypeScript 吗?

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

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

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

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

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

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

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

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

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