src/scss/bootstrap-4.0.0-alpha.6/docs/content/typography.md

   1 ---
   2 layout: docs
   3 title: Typography
   4 description: Documentation and examples for Bootstrap typography, including global settings, body text, lists, and more.
   5 group: content
   6 ---
   7
   8 Bootstrap includes simple and easily customized typography for headings, body text, lists, and more. For even more control, check out the [textual utility classes]({{ site.baseurl }}/utilities/typography/).
   9
  10 ## Contents
  11
  12 * Will be replaced with the ToC, excluding the "Contents" header
  13 {:toc}
  14
  15 ## Global settings
  16
  17 Bootstrap sets basic global display, typography, and link styles. Specifically, we:
  18
  19 - Use a [native font stack]({{ site.baseurl }}/content/reboot/#native-font-stack) that selects the best `font-family` for each OS and device.
  20 - For a more inclusive and accessible type scale, we assume the browser default root `font-size` (typically 16px) so visitors can customize their browser defaults as needed.
  21 - Use the `$font-family-base`, `$font-size-base`, and `$line-height-base` attributes as our typographic base applied to the `<body>`.
  22 - Set the global link color via `$link-color` and apply link underlines only on `:hover`.
  23 - Use `$body-bg` to set a `background-color` on the `<body>` (`#fff` by default).
  24
  25 These styles can be found within `_reboot.scss`, and the global variables are defined in `_variables.scss`.
  26
  27 ## Headings
  28
  29 All HTML headings, `<h1>` through `<h6>`, are available.
  30
  31 <div class="bd-example bd-example-type">
  32   <table class="table">
  33     <tbody>
  34       <tr>
  35         <td><h1>h1. Bootstrap heading</h1></td>
  36         <td class="type-info">Semibold 2.5rem (40px)</td>
  37       </tr>
  38       <tr>
  39         <td><h2>h2. Bootstrap heading</h2></td>
  40         <td class="type-info">Semibold 2rem (32px)</td>
  41       </tr>
  42       <tr>
  43         <td><h3>h3. Bootstrap heading</h3></td>
  44         <td class="type-info">Semibold 1.75rem (28px)</td>
  45       </tr>
  46       <tr>
  47         <td><h4>h4. Bootstrap heading</h4></td>
  48         <td class="type-info">Semibold 1.5rem (24px)</td>
  49       </tr>
  50       <tr>
  51         <td><h5>h5. Bootstrap heading</h5></td>
  52         <td class="type-info">Semibold 1.25rem (20px)</td>
  53       </tr>
  54       <tr>
  55         <td><h6>h6. Bootstrap heading</h6></td>
  56         <td class="type-info">Semibold 1rem (16px)</td>
  57       </tr>
  58     </tbody>
  59   </table>
  60 </div>
  61
  62 {% highlight html %}
  63 <h1>h1. Bootstrap heading</h1>
  64 <h2>h2. Bootstrap heading</h2>
  65 <h3>h3. Bootstrap heading</h3>
  66 <h4>h4. Bootstrap heading</h4>
  67 <h5>h5. Bootstrap heading</h5>
  68 <h6>h6. Bootstrap heading</h6>
  69 {% endhighlight %}
  70
  71 `.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.
  72
  73 {% example html %}
  74 <p class="h1">h1. Bootstrap heading</p>
  75 <p class="h2">h2. Bootstrap heading</p>
  76 <p class="h3">h3. Bootstrap heading</p>
  77 <p class="h4">h4. Bootstrap heading</p>
  78 <p class="h5">h5. Bootstrap heading</p>
  79 <p class="h6">h6. Bootstrap heading</p>
  80 {% endexample %}
  81
  82 ### Customizing headings
  83
  84 Use the included utility classes to recreate the small secondary heading text from Bootstrap 3.
  85
  86 {% example html %}
  87 <h3>
  88   Fancy display heading
  89   <small class="text-muted">With faded secondary text</small>
  90 </h3>
  91 {% endexample %}
  92
  93 ## Display headings
  94
  95 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.
  96
  97 <div class="bd-example bd-example-type">
  98   <table class="table">
  99     <tbody>
 100       <tr>
 101         <td><h1 class="display-1">Display 1</h1></td>
 102       </tr>
 103       <tr>
 104       <td><h1 class="display-2">Display 2</h1></td>
 105       </tr>
 106       <tr>
 107       <td><h1 class="display-3">Display 3</h1></td>
 108       </tr>
 109       <tr>
 110       <td><h1 class="display-4">Display 4</h1></td>
 111       </tr>
 112     </tbody>
 113   </table>
 114 </div>
 115
 116 {% highlight html %}
 117 <h1 class="display-1">Display 1</h1>
 118 <h1 class="display-2">Display 2</h1>
 119 <h1 class="display-3">Display 3</h1>
 120 <h1 class="display-4">Display 4</h1>
 121 {% endhighlight %}
 122
 123 ## Lead
 124
 125 Make a paragraph stand out by adding `.lead`.
 126
 127 {% example html %}
 128 <p class="lead">
 129   Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Duis mollis, est non commodo luctus.
 130 </p>
 131 {% endexample %}
 132
 133 ## Inline text elements
 134
 135 Styling for common inline HTML5 elements.
 136
 137 {% example html %}
 138 <p>You can use the mark tag to <mark>highlight</mark> text.</p>
 139 <p><del>This line of text is meant to be treated as deleted text.</del></p>
 140 <p><s>This line of text is meant to be treated as no longer accurate.</s></p>
 141 <p><ins>This line of text is meant to be treated as an addition to the document.</ins></p>
 142 <p><u>This line of text will render as underlined</u></p>
 143 <p><small>This line of text is meant to be treated as fine print.</small></p>
 144 <p><strong>This line rendered as bold text.</strong></p>
 145 <p><em>This line rendered as italicized text.</em></p>
 146 {% endexample %}
 147
 148 `.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.
 149
 150 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.
 151
 152 ## Text utilities
 153
 154 Change text alignment, transform, style, weight, and color with our [text utilities]({{ site.baseurl }}/utilities/typography/#text-alignment).
 155
 156 ## Abbreviations
 157
 158 Stylized implementation of HTML's `<abbr>` element for abbreviations and acronyms to show the expanded version on hover. Abbreviations have a default underline from Normalize.css and gain a help cursor to provide additional context on hover and to users of assistive technologies.
 159
 160 Add `.initialism` to an abbreviation for a slightly smaller font-size.
 161
 162 {% example html %}
 163 <p><abbr title="attribute">attr</abbr></p>
 164 <p><abbr title="HyperText Markup Language" class="initialism">HTML</abbr></p>
 165 {% endexample %}
 166
 167 ## Blockquotes
 168
 169 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.
 170
 171 {% example html %}
 172 <blockquote class="blockquote">
 173   <p class="mb-0">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
 174 </blockquote>
 175 {% endexample %}
 176
 177 ### Naming a source
 178
 179 Add a `<footer class="blockquote-footer">` for identifying the source. Wrap the name of the source work in `<cite>`.
 180
 181 {% example html %}
 182 <blockquote class="blockquote">
 183   <p class="mb-0">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
 184   <footer class="blockquote-footer">Someone famous in <cite title="Source Title">Source Title</cite></footer>
 185 </blockquote>
 186 {% endexample %}
 187
 188 ### Reverse layout
 189
 190 Add `.blockquote-reverse` for a blockquote with right-aligned content.
 191
 192 {% example html %}
 193 <blockquote class="blockquote blockquote-reverse">
 194   <p class="mb-0">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
 195   <footer class="blockquote-footer">Someone famous in <cite title="Source Title">Source Title</cite></footer>
 196 </blockquote>
 197 {% endexample %}
 198
 199 ## Lists
 200
 201 ### Unstyled
 202
 203 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.
 204
 205 {% example html %}
 206 <ul class="list-unstyled">
 207   <li>Lorem ipsum dolor sit amet</li>
 208   <li>Consectetur adipiscing elit</li>
 209   <li>Integer molestie lorem at massa</li>
 210   <li>Facilisis in pretium nisl aliquet</li>
 211   <li>Nulla volutpat aliquam velit
 212     <ul>
 213       <li>Phasellus iaculis neque</li>
 214       <li>Purus sodales ultricies</li>
 215       <li>Vestibulum laoreet porttitor sem</li>
 216       <li>Ac tristique libero volutpat at</li>
 217     </ul>
 218   </li>
 219   <li>Faucibus porta lacus fringilla vel</li>
 220   <li>Aenean sit amet erat nunc</li>
 221   <li>Eget porttitor lorem</li>
 222 </ul>
 223 {% endexample %}
 224
 225 ### Inline
 226
 227 Remove a list's bullets and apply some light `margin` with a combination of two classes, `.list-inline` and `.list-inline-item`.
 228
 229 {% example html %}
 230 <ul class="list-inline">
 231   <li class="list-inline-item">Lorem ipsum</li>
 232   <li class="list-inline-item">Phasellus iaculis</li>
 233   <li class="list-inline-item">Nulla volutpat</li>
 234 </ul>
 235 {% endexample %}
 236
 237 ### Description list alignment
 238
 239 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.
 240
 241 {% example html %}
 242 <dl class="row">
 243   <dt class="col-sm-3">Description lists</dt>
 244   <dd class="col-sm-9">A description list is perfect for defining terms.</dd>
 245
 246   <dt class="col-sm-3">Euismod</dt>
 247   <dd class="col-sm-9">Vestibulum id ligula porta felis euismod semper eget lacinia odio sem nec elit.</dd>
 248   <dd class="col-sm-9 offset-sm-3">Donec id elit non mi porta gravida at eget metus.</dd>
 249
 250   <dt class="col-sm-3">Malesuada porta</dt>
 251   <dd class="col-sm-9">Etiam porta sem malesuada magna mollis euismod.</dd>
 252
 253   <dt class="col-sm-3 text-truncate">Truncated term is truncated</dt>
 254   <dd class="col-sm-9">Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</dd>
 255
 256   <dt class="col-sm-3">Nesting</dt>
 257   <dd class="col-sm-9">
 258     <dl class="row">
 259       <dt class="col-sm-4">Nested definition list</dt>
 260       <dd class="col-sm-8">Aenean posuere, tortor sed cursus feugiat, nunc augue blandit nunc.</dd>
 261     </dl>
 262   </dd>
 263 </dl>
 264 {% endexample %}
 265
 266 ## Responsive typography
 267
 268 *Responsive typography* refers to scaling text and components by simply adjusting the root element's `font-size` within a series of media queries. Bootstrap doesn't do this for you, but it's fairly easy to add if you need it.
 269
 270 Here's an example of it in practice. Choose whatever `font-size`s and media queries you wish.
 271
 272 {% highlight scss %}
 273 html {
 274   font-size: 14px;
 275 }
 276
 277 @include media-breakpoint-up(sm) {
 278   html {
 279     font-size: 16px;
 280   }
 281 }
 282
 283 @include media-breakpoint-up(md) {
 284   html {
 285     font-size: 20px;
 286   }
 287 }
 288
 289 @include media-breakpoint-up(lg) {
 290   html {
 291     font-size: 28px;
 292   }
 293 }
 294 {% endhighlight %}