nebula/tokens/typography/index.html

750 lines
26 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!doctype html>
<html lang="en" data-layout="default" data-shoelace-version="0.0.10">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta
name="description"
content="Typography tokens are used to maintain a consistent set of font styles throughout your app."
/>
<title>Typography</title>
<meta name="turbo-cache-control" />
<link rel="stylesheet" href="/assets/styles/docs.css" />
<link rel="stylesheet" href="/assets/styles/code-previews.css" />
<link rel="stylesheet" href="/assets/styles/search.css" />
<link rel="icon" href="/assets/images/logo.svg" type="image/x-icon" />
<meta name="twitter:card" content="summary" />
<meta name="twitter:creator" content="shoelace_style" />
<meta name="twitter:image" content="https://nebulaui.org/assets/images/og-image.png" />
<meta property="og:url" content="https://nebulaui.org/tokens/typography/" />
<meta property="og:title" content="Typography" />
<meta
property="og:description"
content="Typography tokens are used to maintain a consistent set of font styles throughout your app."
/>
<meta property="og:image" content="https://nebulaui.org/assets/images/og-image.png" />
<link rel="stylesheet" href="/dist/themes/light.css" />
<link rel="stylesheet" href="/dist/themes/dark.css" />
<script type="module" src="/dist/shoelace-autoloader.js"></script>
<script>
(() => {
const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
const theme = localStorage.getItem('theme') || 'auto';
document.documentElement.classList.toggle(
'sl-theme-dark',
theme === 'dark' || (theme === 'auto' && prefersDark)
);
})();
</script>
<script src="/assets/scripts/turbo.js" type="module"></script>
<script src="/assets/scripts/docs.js" defer=""></script>
<script src="/assets/scripts/code-previews.js" defer=""></script>
<script src="/assets/scripts/lunr.js" defer=""></script>
<script src="/assets/scripts/search.js" defer=""></script>
</head>
<body>
<a id="skip-to-main" class="visually-hidden" href="#main-content" data-smooth-link="false">
Skip to main content
</a>
<button id="menu-toggle" type="button" aria-label="Menu">
<svg width="148" height="148" viewBox="0 0 148 148" xmlns="http://www.w3.org/2000/svg">
<g stroke="currentColor" stroke-width="18" fill="none" fill-rule="evenodd" stroke-linecap="round">
<path d="M9.5 125.5h129M9.5 74.5h129M9.5 23.5h129"></path>
</g>
</svg>
</button>
<div id="icon-toolbar">
<a
href="https://github.com/onsonr/nebula"
title="View Nebula on GitHub"
class="external-link"
rel="noopener noreferrer"
target="_blank"
>
<sl-icon name="github"></sl-icon>
</a>
<a
href="https://twitter.com/shoelace_style"
title="Follow Nebula on Twitter"
class="external-link"
rel="noopener noreferrer"
target="_blank"
>
<sl-icon name="twitter"></sl-icon>
</a>
<sl-dropdown id="theme-selector" placement="bottom-end" distance="3">
<sl-button slot="trigger" size="small" variant="text" caret="" title="Press \ to toggle">
<sl-icon class="only-light" name="sun-fill"></sl-icon>
<sl-icon class="only-dark" name="moon-fill"></sl-icon>
</sl-button>
<sl-menu>
<sl-menu-item type="checkbox" value="light">Light</sl-menu-item>
<sl-menu-item type="checkbox" value="dark">Dark</sl-menu-item>
<sl-divider></sl-divider>
<sl-menu-item type="checkbox" value="auto">System</sl-menu-item>
</sl-menu>
</sl-dropdown>
</div>
<aside id="sidebar" data-preserve-scroll="">
<header>
<a href="/">
<img src="/assets/images/wordmark.svg" alt="Nebula" />
</a>
<div class="sidebar-version">0.0.10</div>
</header>
<div class="sidebar-buttons">
<sl-button
size="small"
class="repo-button repo-button--github"
href="https://github.com/onsonr/nebula"
target="_blank"
>
<sl-icon slot="prefix" name="github"></sl-icon> Code
</sl-button>
<sl-button
size="small"
class="repo-button repo-button--star"
href="https://github.com/onsonr/nebula/stargazers"
target="_blank"
>
<sl-icon slot="prefix" name="star-fill"></sl-icon> Star
</sl-button>
<sl-button
size="small"
class="repo-button repo-button--twitter"
href="https://twitter.com/shoelace_style"
target="_blank"
>
<sl-icon slot="prefix" name="twitter"></sl-icon> Follow
</sl-button>
</div>
<button class="search-box" type="button" title="Press / to search" aria-label="Search" data-plugin="search">
<sl-icon name="search"></sl-icon>
<span>Search</span>
</button>
<nav>
<ul>
<li>
<h2>Getting Started</h2>
<ul>
<li><a href="/">Home</a></li>
<li><a href="/getting-started/installation">Installation</a></li>
<li><a href="/getting-started/usage">Usage</a></li>
<li><a href="/getting-started/themes">Themes</a></li>
<li><a href="/getting-started/customizing">Customizing</a></li>
<li><a href="/getting-started/form-controls">Form Controls</a></li>
<li><a href="/getting-started/localization">Localization</a></li>
</ul>
</li>
<li>
<h2>Frameworks</h2>
<ul>
<li><a href="/frameworks/react">React</a></li>
<li><a href="/frameworks/vue">Vue</a></li>
<li><a href="/frameworks/angular">Angular</a></li>
</ul>
</li>
<li>
<h2>Resources</h2>
<ul>
<li><a href="/resources/community">Community</a></li>
<li>
<a
href="https://github.com/onsonr/nebula/discussions"
class="external-link"
rel="noopener noreferrer"
target="_blank"
>Help &amp; Support</a
>
</li>
<li><a href="/resources/accessibility">Accessibility</a></li>
<li><a href="/resources/contributing">Contributing</a></li>
<li><a href="/resources/changelog">Changelog</a></li>
</ul>
</li>
<li>
<h2>Components</h2>
<ul>
<li>
<a href="/components/alert"> Alert </a>
</li>
<li>
<a href="/components/animated-image"> Animated Image </a>
</li>
<li>
<a href="/components/animation"> Animation </a>
</li>
<li>
<a href="/components/avatar"> Avatar </a>
</li>
<li>
<a href="/components/badge"> Badge </a>
</li>
<li>
<a href="/components/breadcrumb"> Breadcrumb </a>
</li>
<li>
<a href="/components/breadcrumb-item"> Breadcrumb Item </a>
</li>
<li>
<a href="/components/button"> Button </a>
</li>
<li>
<a href="/components/button-group"> Button Group </a>
</li>
<li>
<a href="/components/card"> Card </a>
</li>
<li>
<a href="/components/carousel"> Carousel </a>
</li>
<li>
<a href="/components/carousel-item"> Carousel Item </a>
</li>
<li>
<a href="/components/checkbox"> Checkbox </a>
</li>
<li>
<a href="/components/color-picker"> Color Picker </a>
</li>
<li>
<a href="/components/copy-button"> Copy Button </a>
</li>
<li>
<a href="/components/details"> Details </a>
</li>
<li>
<a href="/components/dialog"> Dialog </a>
</li>
<li>
<a href="/components/divider"> Divider </a>
</li>
<li>
<a href="/components/drawer"> Drawer </a>
</li>
<li>
<a href="/components/dropdown"> Dropdown </a>
</li>
<li>
<a href="/components/format-bytes"> Format Bytes </a>
</li>
<li>
<a href="/components/format-date"> Format Date </a>
</li>
<li>
<a href="/components/format-number"> Format Number </a>
</li>
<li>
<a href="/components/icon"> Icon </a>
</li>
<li>
<a href="/components/icon-button"> Icon Button </a>
</li>
<li>
<a href="/components/image-comparer"> Image Comparer </a>
</li>
<li>
<a href="/components/include"> Include </a>
</li>
<li>
<a href="/components/input"> Input </a>
</li>
<li>
<a href="/components/menu"> Menu </a>
</li>
<li>
<a href="/components/menu-item"> Menu Item </a>
</li>
<li>
<a href="/components/menu-label"> Menu Label </a>
</li>
<li>
<a href="/components/mutation-observer"> Mutation Observer </a>
</li>
<li>
<a href="/components/option"> Option </a>
</li>
<li>
<a href="/components/popup"> Popup </a>
</li>
<li>
<a href="/components/progress-bar"> Progress Bar </a>
</li>
<li>
<a href="/components/progress-ring"> Progress Ring </a>
</li>
<li>
<a href="/components/qr-code"> QR Code </a>
</li>
<li>
<a href="/components/radio"> Radio </a>
</li>
<li>
<a href="/components/radio-button"> Radio Button </a>
</li>
<li>
<a href="/components/radio-group"> Radio Group </a>
</li>
<li>
<a href="/components/range"> Range </a>
</li>
<li>
<a href="/components/rating"> Rating </a>
</li>
<li>
<a href="/components/relative-time"> Relative Time </a>
</li>
<li>
<a href="/components/resize-observer"> Resize Observer </a>
</li>
<li>
<a href="/components/select"> Select </a>
</li>
<li>
<a href="/components/skeleton"> Skeleton </a>
</li>
<li>
<a href="/components/spinner"> Spinner </a>
</li>
<li>
<a href="/components/split-panel"> Split Panel </a>
</li>
<li>
<a href="/components/switch"> Switch </a>
</li>
<li>
<a href="/components/tab"> Tab </a>
</li>
<li>
<a href="/components/tab-group"> Tab Group </a>
</li>
<li>
<a href="/components/tab-panel"> Tab Panel </a>
</li>
<li>
<a href="/components/tag"> Tag </a>
</li>
<li>
<a href="/components/textarea"> Textarea </a>
</li>
<li>
<a href="/components/tooltip"> Tooltip </a>
</li>
<li>
<a href="/components/tree"> Tree </a>
</li>
<li>
<a href="/components/tree-item"> Tree Item </a>
</li>
<li>
<a href="/components/visually-hidden"> Visually Hidden </a>
</li>
</ul>
</li>
<li>
<h2>Design Tokens</h2>
<ul>
<li><a href="/tokens/typography" class="active-link">Typography</a></li>
<li><a href="/tokens/color">Color</a></li>
<li><a href="/tokens/spacing">Spacing</a></li>
<li><a href="/tokens/elevation">Elevation</a></li>
<li><a href="/tokens/border-radius">Border Radius</a></li>
<li><a href="/tokens/transition">Transition</a></li>
<li><a href="/tokens/z-index">Z-index</a></li>
<li><a href="/tokens/more">More Tokens</a></li>
</ul>
</li>
<li>
<h2>Tutorials</h2>
<ul>
<li><a href="/tutorials/integrating-with-astro">Integrating with Astro</a></li>
<li><a href="/tutorials/integrating-with-laravel">Integrating with Laravel</a></li>
<li><a href="/tutorials/integrating-with-nextjs">Integrating with NextJS</a></li>
<li><a href="/tutorials/integrating-with-rails">Integrating with Rails</a></li>
</ul>
</li>
</ul>
</nav>
</aside>
<main>
<a id="main-content"></a>
<article id="content" class="content content--with-toc">
<div class="content__toc">
<ul>
<li class="top"><a href="#">Typography</a></li>
<li data-level="2"><a href="#font-family">Font Family</a></li>
<li data-level="2"><a href="#font-size">Font Size</a></li>
<li data-level="2"><a href="#font-weight">Font Weight</a></li>
<li data-level="2"><a href="#letter-spacing">Letter Spacing</a></li>
<li data-level="2"><a href="#line-height">Line Height</a></li>
</ul>
</div>
<div class="content__body">
<h1>Typography Tokens</h1>
<p>Typography tokens are used to maintain a consistent set of font styles throughout your app.</p>
<h2 id="font-family" class="anchor-heading">
Font Family<a href="#font-family" aria-label='Direct link to "Font Family"'></a>
</h2>
<p>The default font stack is designed to be simple and highly available on as many devices as possible.</p>
<div class="table-scroll">
<table>
<thead>
<tr>
<th>Token</th>
<th>Value</th>
<th>Example</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>--sl-font-sans</code></td>
<td>
-apple-system, BlinkMacSystemFont, Segoe UI, Roboto, Helvetica, Arial, sans-serif, Apple Color
Emoji, Segoe UI Emoji, Segoe UI Symbol
</td>
<td>
<span style="font-family: var(--sl-font-sans)">The quick brown fox jumped over the lazy dog.</span>
</td>
</tr>
<tr>
<td><code>--sl-font-serif</code></td>
<td>Georgia, Times New Roman, serif</td>
<td>
<span style="font-family: var(--sl-font-serif)">The quick brown fox jumped over the lazy dog.</span>
</td>
</tr>
<tr>
<td><code>--sl-font-mono</code></td>
<td>SFMono-Regular, Consolas, Liberation Mono, Menlo, monospace;</td>
<td>
<span style="font-family: var(--sl-font-mono)">The quick brown fox jumped over the lazy dog.</span>
</td>
</tr>
</tbody>
</table>
</div>
<h2 id="font-size" class="anchor-heading">
Font Size<a href="#font-size" aria-label='Direct link to "Font Size"'></a>
</h2>
<p>
Font sizes use <code>rem</code> units so they scale with the base font size. The pixel values displayed are
based on a 16px font size.
</p>
<div class="table-scroll">
<table>
<thead>
<tr>
<th>Token</th>
<th>Value</th>
<th>Example</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>--sl-font-size-2x-small</code></td>
<td>0.625rem (10px)</td>
<td><span style="font-size: var(--sl-font-size-2x-small)">Aa</span></td>
</tr>
<tr>
<td><code>--sl-font-size-x-small</code></td>
<td>0.75rem (12px)</td>
<td><span style="font-size: var(--sl-font-size-x-small)">Aa</span></td>
</tr>
<tr>
<td><code>--sl-font-size-small</code></td>
<td>0.875rem (14px)</td>
<td><span style="font-size: var(--sl-font-size-small)">Aa</span></td>
</tr>
<tr>
<td><code>--sl-font-size-medium</code></td>
<td>1rem (16px)</td>
<td><span style="font-size: var(--sl-font-size-medium)">Aa</span></td>
</tr>
<tr>
<td><code>--sl-font-size-large</code></td>
<td>1.25rem (20px)</td>
<td><span style="font-size: var(--sl-font-size-large)">Aa</span></td>
</tr>
<tr>
<td><code>--sl-font-size-x-large</code></td>
<td>1.5rem (24px)</td>
<td><span style="font-size: var(--sl-font-size-x-large)">Aa</span></td>
</tr>
<tr>
<td><code>--sl-font-size-2x-large</code></td>
<td>2.25rem (36px)</td>
<td><span style="font-size: var(--sl-font-size-2x-large)">Aa</span></td>
</tr>
<tr>
<td><code>--sl-font-size-3x-large</code></td>
<td>3rem (48px)</td>
<td><span style="font-size: var(--sl-font-size-3x-large)">Aa</span></td>
</tr>
<tr>
<td><code>--sl-font-size-4x-large</code></td>
<td>4.5rem (72px)</td>
<td><span style="font-size: var(--sl-font-size-4x-large)">Aa</span></td>
</tr>
</tbody>
</table>
</div>
<h2 id="font-weight" class="anchor-heading">
Font Weight<a href="#font-weight" aria-label='Direct link to "Font Weight"'></a>
</h2>
<div class="table-scroll">
<table>
<thead>
<tr>
<th>Token</th>
<th>Value</th>
<th>Example</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>--sl-font-weight-light</code></td>
<td>300</td>
<td>
<span style="font-weight: var(--sl-font-weight-light)"
>The quick brown fox jumped over the lazy dog.</span
>
</td>
</tr>
<tr>
<td><code>--sl-font-weight-normal</code></td>
<td>400</td>
<td>
<span style="font-weight: var(--sl-font-weight-normal)"
>The quick brown fox jumped over the lazy dog.</span
>
</td>
</tr>
<tr>
<td><code>--sl-font-weight-semibold</code></td>
<td>500</td>
<td>
<span style="font-weight: var(--sl-font-weight-semibold)"
>The quick brown fox jumped over the lazy dog.</span
>
</td>
</tr>
<tr>
<td><code>--sl-font-weight-bold</code></td>
<td>700</td>
<td>
<span style="font-weight: var(--sl-font-weight-bold)"
>The quick brown fox jumped over the lazy dog.</span
>
</td>
</tr>
</tbody>
</table>
</div>
<h2 id="letter-spacing" class="anchor-heading">
Letter Spacing<a href="#letter-spacing" aria-label='Direct link to "Letter Spacing"'></a>
</h2>
<div class="table-scroll">
<table>
<thead>
<tr>
<th>Token</th>
<th>Value</th>
<th>Example</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>--sl-letter-spacing-denser</code></td>
<td>-0.03em</td>
<td>
<span style="letter-spacing: var(--sl-letter-spacing-denser)"
>The quick brown fox jumped over the lazy dog.</span
>
</td>
</tr>
<tr>
<td><code>--sl-letter-spacing-dense</code></td>
<td>-0.015em</td>
<td>
<span style="letter-spacing: var(--sl-letter-spacing-dense)"
>The quick brown fox jumped over the lazy dog.</span
>
</td>
</tr>
<tr>
<td><code>--sl-letter-spacing-normal</code></td>
<td>normal</td>
<td>
<span style="letter-spacing: var(--sl-letter-spacing-normal)"
>The quick brown fox jumped over the lazy dog.</span
>
</td>
</tr>
<tr>
<td><code>--sl-letter-spacing-loose</code></td>
<td>0.075em</td>
<td>
<span style="letter-spacing: var(--sl-letter-spacing-loose)"
>The quick brown fox jumped over the lazy dog.</span
>
</td>
</tr>
<tr>
<td><code>--sl-letter-spacing-looser</code></td>
<td>0.15em</td>
<td>
<span style="letter-spacing: var(--sl-letter-spacing-looser)"
>The quick brown fox jumped over the lazy dog.</span
>
</td>
</tr>
</tbody>
</table>
</div>
<h2 id="line-height" class="anchor-heading">
Line Height<a href="#line-height" aria-label='Direct link to "Line Height"'></a>
</h2>
<div class="table-scroll">
<table>
<thead>
<tr>
<th>Token</th>
<th>Value</th>
<th>Example</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>--sl-line-height-denser</code></td>
<td>1</td>
<td>
<div style="line-height: var(--sl-line-height-denser)">
The quick brown fox jumped over the lazy dog.<br />The quick brown fox jumped over the lazy
dog.<br />The quick brown fox jumped over the lazy dog.
</div>
</td>
</tr>
<tr>
<td><code>--sl-line-height-dense</code></td>
<td>1.4</td>
<td>
<div style="line-height: var(--sl-line-height-dense)">
The quick brown fox jumped over the lazy dog.<br />The quick brown fox jumped over the lazy
dog.<br />The quick brown fox jumped over the lazy dog.
</div>
</td>
</tr>
<tr>
<td><code>--sl-line-height-normal</code></td>
<td>1.8</td>
<td>
<div style="line-height: var(--sl-line-height-normal)">
The quick brown fox jumped over the lazy dog.<br />The quick brown fox jumped over the lazy
dog.<br />The quick brown fox jumped over the lazy dog.
</div>
</td>
</tr>
<tr>
<td><code>--sl-line-height-loose</code></td>
<td>2.2</td>
<td>
<div style="line-height: var(--sl-line-height-loose)">
The quick brown fox jumped over the lazy dog.<br />The quick brown fox jumped over the lazy
dog.<br />The quick brown fox jumped over the lazy dog.
</div>
</td>
</tr>
<tr>
<td><code>--sl-line-height-looser</code></td>
<td>2.6</td>
<td>
<div style="line-height: var(--sl-line-height-looser)">
The quick brown fox jumped over the lazy dog.<br />The quick brown fox jumped over the lazy
dog.<br />The quick brown fox jumped over the lazy dog.
</div>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</article>
</main>
</body>
</html>