@financial-times/o-editorial-typography v2.4.1
o-editorial-typography
Typography styles for editorial content.
o-typography provides fundamental typographic tooling and styles for user interfaces. o-editorial-typography builds on that with typography for editorial content including headlines, tags, and bylines. It makes no assumption about where the editorial typography will be used -- it could be a page, another component, or email for example -- so no default margins are provided. To apply typography and layout editorial typography within an article see o-editorial-layout.
Usage
Check out how to include Origami components in your project to get started with o-editorial-typography
.
Markup
Headings
Headings 1-6 are provided with the class 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>
Heading level 1 is suitable for most cases but for more emphasis use o-editorial-typography-headline
instead.
<h1 class="o-editorial-typography-headline">Don’t settle for black and white</h1>
Body
For paragraphs use the o-editorial-typography-body
class:
<p class="o-editorial-typography-body">Lorem ipsum dolor sit amet consectetur adipisicing elit.</p>
Lists
There are styles for both ordered and unordered lists. Use the class o-editorial-typography-list
along with o-editorial-typography-list--ordered
or o-editorial-typography-list--unordered
.
So lists may be used in different contexts they inherit font properties such as size and family. It's therefore required to apply font styles to a parent element. E.g. this could be done with o-editorial-typography-body
.
<div class="o-editorial-typography-body">
<ul class="o-editorial-typography-list o-editorial-typography-list--unordered">
<li>Lorem ipsum 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 adipiscing elit.</li>
<li>Sed feugiat turpis at massa tristique.</li>
<li>Curabitu r accumsan elit luctus.</li>
</ol>
</div>
Topic Tag
Reference categories of content with topic tags. A topic tag is usually an anchor but does not have to be if there is no page to link to.
No font size is set so the tag may be used in different contexts.
<a class="o-editorial-typography-topic" href="#">Topic Link</a>
<span class="o-editorial-typography-topic">Topic Without Link</span>
Links
Links are styled using o-editorial-typography-link
inside a o-editorial-typography-body
container.
<p class="o-editorial-typography-body">
An article by
<a href="https://ft.com/" class="o-editorial-typography-link">The Financial Times</a>.
</p>
An inverse style is also provided for use on dark backgrounds. Use o-editorial-typography-body--inverse
on the container to enable inverse styles.
<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>
Author Tag
Style an author tag using the class o-editorial-typography-author
. An author tag is usually an anchor but does not have to be if there is no author page to link to.
<a class="o-editorial-typography-author" href="#">Joe Doe</a>
<span class="o-editorial-typography-author">Joe Doe</span>
Timestamp
o-editorial-typography-timestamp
styles a timestamp. It does not set font size or family so may be used in different contexts, such as an article byline or comments section.
<time class="o-editorial-typography-timestamp" datetime="2019-10-11T20:51:54Z" title="October 11 2019 9:51 pm">October 11 2019</time>
Byline
A story byline may be styled using o-editorial-typography-byline
. It's often used along with author and timestamp styles.
<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>
Captions
Style captions using o-editorial-typography-caption
.
<figure>
<img alt="" src="#">
<figcaption class="o-editorial-typography-caption">
©Lorem John Doe
</figcaption>
</figure>
Sass
Include all o-editorial-typography styles by including the oEditorialTypography
mixin.
@import "@financial-times/o-editorial-typography/main";
@include oEditorialTypography();
To include just the styles you need we recommend setting the options $opts
argument.
For example to include only heading levels 1-3 and body copy styles.
@include oEditorialTypography($opts: (
'body': true,
'headings': (1, 2, 3)
));
This example shows all options:
@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
));
We recommend including styles with oEditorialTypography
and using default markup to reduce duplicated CSS in your project. However you may also use typography mixins provided if you are unable to update your markup to o-editorial-typography
classes. Mixins include:
oEditorialTypographyHeadline
oEditorialTypographyHeading
oEditorialTypographyBody
oEditorialTypographyList
oEditorialTypographyCaption
oEditorialTypographyStandfirst
oEditorialTypographyByline
oEditorialTypographyTimestamp
oEditorialTypographyTag
oEditorialTypographyDecorated
For example to output a heading:
.my-h2 {
@include oEditorialTypographyHeading(2);
}
Or a topic tag:
.my-topic-tag {
@include oEditorialTypographyTag('topic');
}
See the o-editorial-typography Sassdoc for full details and more examples.
Font Loading
Calling oEditorialTypography
will output font faces to download custom Financial Times fonts. However IE11 may download fonts which are not used. To include font faces more granularly based on your use set $o-editorial-typography-load-fonts: false
and use o-fonts. This is not required if your project also uses o-typography and has already set $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();
Migration
State | Major Version | Last Minor Release | Migration guide |
---|---|---|---|
✨ active | 2 | N/A | migrate to v2 |
⚠ maintained | 1 | 1.1 | N/A |
Contact
If you have any questions or comments about this component, or need help using it, please either raise an issue, visit #ft-origami or email Origami Support.
Licence
This software is published by the Financial Times under the MIT licence.
1 year ago
1 year ago
1 year ago
2 years ago
2 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago