| 1 |
efrain |
1 |
---
|
|
|
2 |
layout: docs
|
|
|
3 |
title: Typography
|
|
|
4 |
description: Documentation and examples for Bootstrap typography, including global settings, headings, body text, lists, and more.
|
|
|
5 |
group: content
|
|
|
6 |
toc: true
|
|
|
7 |
---
|
|
|
8 |
|
|
|
9 |
## Global settings
|
|
|
10 |
|
|
|
11 |
Bootstrap sets basic global display, typography, and link styles. When more control is needed, check out the [textual utility classes]({{< docsref "/utilities/text" >}}).
|
|
|
12 |
|
|
|
13 |
- Use a [native font stack]({{< docsref "/content/reboot#native-font-stack" >}}) that selects the best `font-family` for each OS and device.
|
|
|
14 |
- For a more inclusive and accessible type scale, we use the browser's default root `font-size` (typically 16px) so visitors can customize their browser defaults as needed.
|
|
|
15 |
- Use the `$font-family-base`, `$font-size-base`, and `$line-height-base` attributes as our typographic base applied to the `<body>`.
|
|
|
16 |
- Set the global link color via `$link-color` and apply link underlines only on `:hover`.
|
|
|
17 |
- Use `$body-bg` to set a `background-color` on the `<body>` (`#fff` by default).
|
|
|
18 |
|
|
|
19 |
These styles can be found within `_reboot.scss`, and the global variables are defined in `_variables.scss`. Make sure to set `$font-size-base` in `rem`.
|
|
|
20 |
|
|
|
21 |
## Headings
|
|
|
22 |
|
|
|
23 |
All HTML headings, `<h1>` through `<h6>`, are available.
|
|
|
24 |
|
|
|
25 |
<table>
|
|
|
26 |
<thead>
|
|
|
27 |
<tr>
|
|
|
28 |
<th>Heading</th>
|
|
|
29 |
<th>Example</th>
|
|
|
30 |
</tr>
|
|
|
31 |
</thead>
|
|
|
32 |
<tbody>
|
|
|
33 |
<tr>
|
|
|
34 |
<td>
|
|
|
35 |
{{< markdown >}}`<h1></h1>`{{< /markdown >}}
|
|
|
36 |
</td>
|
|
|
37 |
<td><span class="h1">h1. Bootstrap heading</span></td>
|
|
|
38 |
</tr>
|
|
|
39 |
<tr>
|
|
|
40 |
<td>
|
|
|
41 |
{{< markdown >}}`<h2></h2>`{{< /markdown >}}
|
|
|
42 |
</td>
|
|
|
43 |
<td><span class="h2">h2. Bootstrap heading</span></td>
|
|
|
44 |
</tr>
|
|
|
45 |
<tr>
|
|
|
46 |
<td>
|
|
|
47 |
{{< markdown >}}`<h3></h3>`{{< /markdown >}}
|
|
|
48 |
</td>
|
|
|
49 |
<td><span class="h3">h3. Bootstrap heading</span></td>
|
|
|
50 |
</tr>
|
|
|
51 |
<tr>
|
|
|
52 |
<td>
|
|
|
53 |
{{< markdown >}}`<h4></h4>`{{< /markdown >}}
|
|
|
54 |
</td>
|
|
|
55 |
<td><span class="h4">h4. Bootstrap heading</span></td>
|
|
|
56 |
</tr>
|
|
|
57 |
<tr>
|
|
|
58 |
<td>
|
|
|
59 |
{{< markdown >}}`<h5></h5>`{{< /markdown >}}
|
|
|
60 |
</td>
|
|
|
61 |
<td><span class="h5">h5. Bootstrap heading</span></td>
|
|
|
62 |
</tr>
|
|
|
63 |
<tr>
|
|
|
64 |
<td>
|
|
|
65 |
{{< markdown >}}`<h6></h6>`{{< /markdown >}}
|
|
|
66 |
</td>
|
|
|
67 |
<td><span class="h6">h6. Bootstrap heading</span></td>
|
|
|
68 |
</tr>
|
|
|
69 |
</tbody>
|
|
|
70 |
</table>
|
|
|
71 |
|
|
|
72 |
```html
|
|
|
73 |
<h1>h1. Bootstrap heading</h1>
|
|
|
74 |
<h2>h2. Bootstrap heading</h2>
|
|
|
75 |
<h3>h3. Bootstrap heading</h3>
|
|
|
76 |
<h4>h4. Bootstrap heading</h4>
|
|
|
77 |
<h5>h5. Bootstrap heading</h5>
|
|
|
78 |
<h6>h6. Bootstrap heading</h6>
|
|
|
79 |
```
|
|
|
80 |
|
|
|
81 |
`.h1` through `.h6` classes are also available, for when you want to match the font styling of a heading but cannot use the associated HTML element.
|
|
|
82 |
|
|
|
83 |
{{< example >}}
|
|
|
84 |
<p class="h1">h1. Bootstrap heading</p>
|
|
|
85 |
<p class="h2">h2. Bootstrap heading</p>
|
|
|
86 |
<p class="h3">h3. Bootstrap heading</p>
|
|
|
87 |
<p class="h4">h4. Bootstrap heading</p>
|
|
|
88 |
<p class="h5">h5. Bootstrap heading</p>
|
|
|
89 |
<p class="h6">h6. Bootstrap heading</p>
|
|
|
90 |
{{< /example >}}
|
|
|
91 |
|
|
|
92 |
### Customizing headings
|
|
|
93 |
|
|
|
94 |
Use the included utility classes to recreate the small secondary heading text from Bootstrap 3.
|
|
|
95 |
|
|
|
96 |
{{< example >}}
|
|
|
97 |
<h3>
|
|
|
98 |
Fancy display heading
|
|
|
99 |
<small class="text-muted">With faded secondary text</small>
|
|
|
100 |
</h3>
|
|
|
101 |
{{< /example >}}
|
|
|
102 |
|
|
|
103 |
## Display headings
|
|
|
104 |
|
|
|
105 |
Traditional heading elements are designed to work best in the meat of your page content. When you need a heading to stand out, consider using a **display heading**—a larger, slightly more opinionated heading style. Keep in mind these headings are not responsive by default, but it's possible to enable [responsive font sizes](#responsive-font-sizes).
|
|
|
106 |
|
|
|
107 |
<div class="bd-example bd-example-type">
|
|
|
108 |
<table class="table">
|
|
|
109 |
<tbody>
|
|
|
110 |
<tr>
|
|
|
111 |
<td><span class="display-1">Display 1</span></td>
|
|
|
112 |
</tr>
|
|
|
113 |
<tr>
|
|
|
114 |
<td><span class="display-2">Display 2</span></td>
|
|
|
115 |
</tr>
|
|
|
116 |
<tr>
|
|
|
117 |
<td><span class="display-3">Display 3</span></td>
|
|
|
118 |
</tr>
|
|
|
119 |
<tr>
|
|
|
120 |
<td><span class="display-4">Display 4</span></td>
|
|
|
121 |
</tr>
|
|
|
122 |
</tbody>
|
|
|
123 |
</table>
|
|
|
124 |
</div>
|
|
|
125 |
|
|
|
126 |
```html
|
|
|
127 |
<h1 class="display-1">Display 1</h1>
|
|
|
128 |
<h1 class="display-2">Display 2</h1>
|
|
|
129 |
<h1 class="display-3">Display 3</h1>
|
|
|
130 |
<h1 class="display-4">Display 4</h1>
|
|
|
131 |
```
|
|
|
132 |
|
|
|
133 |
## Lead
|
|
|
134 |
|
|
|
135 |
Make a paragraph stand out by adding `.lead`.
|
|
|
136 |
|
|
|
137 |
{{< example >}}
|
|
|
138 |
<p class="lead">
|
|
|
139 |
This is a lead paragraph. It stands out from regular paragraphs.
|
|
|
140 |
</p>
|
|
|
141 |
{{< /example >}}
|
|
|
142 |
|
|
|
143 |
## Inline text elements
|
|
|
144 |
|
|
|
145 |
Styling for common inline HTML5 elements.
|
|
|
146 |
|
|
|
147 |
{{< example >}}
|
|
|
148 |
<p>You can use the mark tag to <mark>highlight</mark> text.</p>
|
|
|
149 |
<p><del>This line of text is meant to be treated as deleted text.</del></p>
|
|
|
150 |
<p><s>This line of text is meant to be treated as no longer accurate.</s></p>
|
|
|
151 |
<p><ins>This line of text is meant to be treated as an addition to the document.</ins></p>
|
|
|
152 |
<p><u>This line of text will render as underlined</u></p>
|
|
|
153 |
<p><small>This line of text is meant to be treated as fine print.</small></p>
|
|
|
154 |
<p><strong>This line rendered as bold text.</strong></p>
|
|
|
155 |
<p><em>This line rendered as italicized text.</em></p>
|
|
|
156 |
{{< /example >}}
|
|
|
157 |
|
|
|
158 |
`.mark` and `.small` classes are also available to apply the same styles as `<mark>` and `<small>` while avoiding any unwanted semantic implications that the tags would bring.
|
|
|
159 |
|
|
|
160 |
While not shown above, feel free to use `<b>` and `<i>` in HTML5. `<b>` is meant to highlight words or phrases without conveying additional importance while `<i>` is mostly for voice, technical terms, etc.
|
|
|
161 |
|
|
|
162 |
## Text utilities
|
|
|
163 |
|
|
|
164 |
Change text alignment, transform, style, weight, and color with our [text utilities]({{< docsref "/utilities/text" >}}) and [color utilities]({{< docsref "/utilities/colors" >}}).
|
|
|
165 |
|
|
|
166 |
## Abbreviations
|
|
|
167 |
|
|
|
168 |
Stylized implementation of HTML's `<abbr>` element for abbreviations and acronyms to show the expanded version on hover. Abbreviations have a default underline and gain a help cursor to provide additional context on hover and to users of assistive technologies.
|
|
|
169 |
|
|
|
170 |
Add `.initialism` to an abbreviation for a slightly smaller font-size.
|
|
|
171 |
|
|
|
172 |
{{< example >}}
|
|
|
173 |
<p><abbr title="attribute">attr</abbr></p>
|
|
|
174 |
<p><abbr title="HyperText Markup Language" class="initialism">HTML</abbr></p>
|
|
|
175 |
{{< /example >}}
|
|
|
176 |
|
|
|
177 |
## Blockquotes
|
|
|
178 |
|
|
|
179 |
For quoting blocks of content from another source within your document. Wrap `<blockquote class="blockquote">` around any <abbr title="HyperText Markup Language">HTML</abbr> as the quote.
|
|
|
180 |
|
|
|
181 |
{{< example >}}
|
|
|
182 |
<blockquote class="blockquote">
|
|
|
183 |
<p class="mb-0">A well-known quote, contained in a blockquote element.</p>
|
|
|
184 |
</blockquote>
|
|
|
185 |
{{< /example >}}
|
|
|
186 |
|
|
|
187 |
### Naming a source
|
|
|
188 |
|
|
|
189 |
Add a `<footer class="blockquote-footer">` for identifying the source. Wrap the name of the source work in `<cite>`.
|
|
|
190 |
|
|
|
191 |
{{< example >}}
|
|
|
192 |
<blockquote class="blockquote">
|
|
|
193 |
<p class="mb-0">A well-known quote, contained in a blockquote element.</p>
|
|
|
194 |
<footer class="blockquote-footer">Someone famous in <cite title="Source Title">Source Title</cite></footer>
|
|
|
195 |
</blockquote>
|
|
|
196 |
{{< /example >}}
|
|
|
197 |
|
|
|
198 |
### Alignment
|
|
|
199 |
|
|
|
200 |
Use text utilities as needed to change the alignment of your blockquote.
|
|
|
201 |
|
|
|
202 |
{{< example >}}
|
|
|
203 |
<blockquote class="blockquote text-center">
|
|
|
204 |
<p class="mb-0">A well-known quote, contained in a blockquote element.</p>
|
|
|
205 |
<footer class="blockquote-footer">Someone famous in <cite title="Source Title">Source Title</cite></footer>
|
|
|
206 |
</blockquote>
|
|
|
207 |
{{< /example >}}
|
|
|
208 |
|
|
|
209 |
{{< example >}}
|
|
|
210 |
<blockquote class="blockquote text-right">
|
|
|
211 |
<p class="mb-0">A well-known quote, contained in a blockquote element.</p>
|
|
|
212 |
<footer class="blockquote-footer">Someone famous in <cite title="Source Title">Source Title</cite></footer>
|
|
|
213 |
</blockquote>
|
|
|
214 |
{{< /example >}}
|
|
|
215 |
|
|
|
216 |
## Lists
|
|
|
217 |
|
|
|
218 |
### Unstyled
|
|
|
219 |
|
|
|
220 |
Remove the default `list-style` and left margin on list items (immediate children only). **This only applies to immediate children list items**, meaning you will need to add the class for any nested lists as well.
|
|
|
221 |
|
|
|
222 |
{{< example >}}
|
|
|
223 |
<ul class="list-unstyled">
|
|
|
224 |
<li>This is a list.</li>
|
|
|
225 |
<li>It appears completely unstyled.</li>
|
|
|
226 |
<li>Structurally, it's still a list.</li>
|
|
|
227 |
<li>However, this style only applies to immediate child elements.</li>
|
|
|
228 |
<li>Nested lists:
|
|
|
229 |
<ul>
|
|
|
230 |
<li>are unaffected by this style</li>
|
|
|
231 |
<li>will still show a bullet</li>
|
|
|
232 |
<li>and have appropriate left margin</li>
|
|
|
233 |
</ul>
|
|
|
234 |
</li>
|
|
|
235 |
<li>This may still come in handy in some situations.</li>
|
|
|
236 |
</ul>
|
|
|
237 |
{{< /example >}}
|
|
|
238 |
|
|
|
239 |
### Inline
|
|
|
240 |
|
|
|
241 |
Remove a list's bullets and apply some light `margin` with a combination of two classes, `.list-inline` and `.list-inline-item`.
|
|
|
242 |
|
|
|
243 |
{{< example >}}
|
|
|
244 |
<ul class="list-inline">
|
|
|
245 |
<li class="list-inline-item">This is a list item.</li>
|
|
|
246 |
<li class="list-inline-item">And another one.</li>
|
|
|
247 |
<li class="list-inline-item">But they're displayed inline.</li>
|
|
|
248 |
</ul>
|
|
|
249 |
{{< /example >}}
|
|
|
250 |
|
|
|
251 |
### Description list alignment
|
|
|
252 |
|
|
|
253 |
Align terms and descriptions horizontally by using our grid system's predefined classes (or semantic mixins). For longer terms, you can optionally add a `.text-truncate` class to truncate the text with an ellipsis.
|
|
|
254 |
|
|
|
255 |
{{< example >}}
|
|
|
256 |
<dl class="row">
|
|
|
257 |
<dt class="col-sm-3">Description lists</dt>
|
|
|
258 |
<dd class="col-sm-9">A description list is perfect for defining terms.</dd>
|
|
|
259 |
|
|
|
260 |
<dt class="col-sm-3">Term</dt>
|
|
|
261 |
<dd class="col-sm-9">
|
|
|
262 |
<p>Definition for the term.</p>
|
|
|
263 |
<p>And some more placeholder definition text.</p>
|
|
|
264 |
</dd>
|
|
|
265 |
|
|
|
266 |
<dt class="col-sm-3">Another term</dt>
|
|
|
267 |
<dd class="col-sm-9">This definition is short, so no extra paragraphs or anything.</dd>
|
|
|
268 |
|
|
|
269 |
<dt class="col-sm-3 text-truncate">Truncated term is truncated</dt>
|
|
|
270 |
<dd class="col-sm-9">This can be useful when space is tight. Adds an ellipsis at the end.</dd>
|
|
|
271 |
|
|
|
272 |
<dt class="col-sm-3">Nesting</dt>
|
|
|
273 |
<dd class="col-sm-9">
|
|
|
274 |
<dl class="row">
|
|
|
275 |
<dt class="col-sm-4">Nested definition list</dt>
|
|
|
276 |
<dd class="col-sm-8">I heard you like definition lists. Let me put a definition list inside your definition list.</dd>
|
|
|
277 |
</dl>
|
|
|
278 |
</dd>
|
|
|
279 |
</dl>
|
|
|
280 |
{{< /example >}}
|
|
|
281 |
|
|
|
282 |
## Responsive font sizes
|
|
|
283 |
|
|
|
284 |
As of v4.3.0, Bootstrap ships with the option to enable responsive font sizes, allowing text to scale more naturally across device and viewport sizes. <abbr title="Responsive font sizes">RFS</abbr> can be enabled by changing the `$enable-responsive-font-sizes` Sass variable to `true` and recompiling Bootstrap.
|
|
|
285 |
|
|
|
286 |
To support <abbr title="Responsive font sizes">RFS</abbr>, we use a Sass mixin to replace our normal `font-size` properties. Responsive font sizes will be compiled into `calc()` functions with a mix of `rem` and viewport units to enable the responsive scaling behavior. More about <abbr title="Responsive font sizes">RFS</abbr> and its configuration can be found on its [GitHub repository](https://github.com/twbs/rfs/tree/v8.1.0).
|