display.md 3.84 KB
Newer Older
1
2
3
---
layout: docs
title: Display property
4
description: Quickly and responsively toggle the display value of components and more with our display utilities. Includes support for some of the more common values, as well as some extras for controlling display when printing.
5
group: utilities
6
toc: true
7
8
---

Andrew Murphy's avatar
Andrew Murphy committed
9
## How it works
10

Andrew Murphy's avatar
Andrew Murphy committed
11
Change the value of the [`display` property](https://developer.mozilla.org/en-US/docs/Web/CSS/display) with our responsive display utility classes. We purposely support only a subset of all possible values for `display`. Classes can be combined for various effects as you need.
12

13
14
## Notation

Andrew Murphy's avatar
Andrew Murphy committed
15
16
17
18
19
Display utility classes that apply to all [breakpoints]({{ site.baseurl }}/docs/{{ site.docs_version }}/layout/overview/#responsive-breakpoints), from `xs` to `xl`, have no breakpoint abbreviation in them. This is because those classes are applied from `min-width: 0` and up, and thus are not bound by a media query. The remaining breakpoints, however, do include a breakpoint abbreviation.

As such, the classes are named using the format:
* `.d-{value}` for `xs`
* `.d-{breakpoint}-{value}` for `sm`, `md`, `lg`, and `xl`.
20
21
22
23
24
25
26
27
28
29
30
31

Where *display* is one of:

* `none`
* `inline`
* `inline-block`
* `block`
* `table`
* `table-cell`
* `flex`
* `inline-flex`

Andrew Murphy's avatar
Andrew Murphy committed
32
The media queries effect screen widths with the given breakpoint *or larger*.
33

Andrew Murphy's avatar
typo    
Andrew Murphy committed
34
For example, `.d-lg-none` sets `display: none;` on both `lg` and `xl` screens.
35
36

## Examples
37
38
39
40
41
42
43
44

{% example html %}
<div class="d-inline bg-success">d-inline</div>
<div class="d-inline bg-success">d-inline</div>
{% endexample %}

{% example html %}
<span class="d-block bg-primary">d-block</span>
45
<span class="d-block bg-primary">d-block</span>
46
47
{% endexample %}

48
49
## Hiding Elements

50
51
For faster mobile-friendly development, use responsive display classes for showing and hiding elements by device. Avoid creating entirely different versions of the same site, instead hide element responsively for each screen size.

52
53
To hide elements simply use the `.d-none` class or one of the `.d-{sm,md,lg,xl}-none` classes for any responsive screen variation.

Andrew Murphy's avatar
Andrew Murphy committed
54
To show an element only on a given interval of screen sizes you can combine one `.d-*-none` class with a `.d-*-*` class, for example `.d-none .d-md-block .d-xl-none` will hide the element for all screen sizes except on medium and large devices.
55
56
57

| Screen Size        | Class |
| ---                | --- |
Andrew Murphy's avatar
Andrew Murphy committed
58
59
60
61
62
63
64
65
66
67
68
69
| Hidden on all      | `.d-none` |
| Hidden only on xs  | `.d-none .d-sm-block` |
| Hidden only on sm  | `.d-sm-none .d-md-block` |
| Hidden only on md  | `.d-md-none .d-lg-block` |
| Hidden only on lg  | `.d-lg-none .d-xl-block` |
| Hidden only on xl  | `.d-xl-none` |
| Visible on all     | `.d-block` |
| Visible only on xs | `.d-block .d-sm-none` |
| Visible only on sm | `.d-none .d-sm-block .d-md-none` |
| Visible only on md | `.d-none .d-md-block .d-lg-none` |
| Visible only on lg | `.d-none .d-lg-block .d-xl-none` |
| Visible only on xl | `.d-none .d-xl-block` |
70

71
72
73
74
75
{% example html %}
<div class="d-lg-none">hide on screens wider than lg</div>
<div class="d-none d-lg-block">hide on screens smaller than lg</div>
{% endexample %}

76
77
## Display in print

78
Change the `display` value of elements when printing with our print display utility classes.
79
80
81

| Class | Print style |
| --- | --- |
Andrew Murphy's avatar
Andrew Murphy committed
82
83
84
85
| `.d-print-block` | Applies `display: block;` to the element when printing |
| `.d-print-inline` | Applies `display: inline;` to the element when printing |
| `.d-print-inline-block` | Applies `display: inline-block;` to the element when printing |
| `.d-print-none` | Applies `display: none;` to the element when printing |
86
87
88
89

The print and display classes can be combined.

{% example html %}
Andrew Murphy's avatar
Andrew Murphy committed
90
91
92
<div class="d-print-none">Screen Only (Hide on print only)</div>
<div class="d-none d-print-block">Print Only (Hide on screen only)</div>
<div class="d-none d-lg-block d-print-block">Hide up to large on screen, but always show on print</div>
93
{% endexample %}