1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
|
(sd-dropdowns)=
# Dropdowns
Dropdowns can be used to toggle, usually *non-essential*, content and show it only when a user clicks on the header panel.
The dropdown can have a title, as the directive argument, and the `open` option can be used to initialise the dropdown in the open state.
:::{dropdown}
Dropdown content
:::
:::{dropdown} Dropdown title
Dropdown content
:::
:::{dropdown} Open dropdown
:open:
Dropdown content
:::
`````{dropdown-syntax}
````{tab-set-code}
```{literalinclude} ./snippets/myst/dropdown-basic.txt
:language: markdown
```
```{literalinclude} ./snippets/rst/dropdown-basic.txt
:language: rst
```
````
`````
## Opening animations
Use `:animate: fade-in` or `:animate: fade-in-slide-down` options to animate the reveal of the hidden content.
:::{dropdown} Dropdown `fade-in`
:animate: fade-in
{{ loremipsum }}
:::
:::{dropdown} Dropdown `fade-in-slide-down`
:animate: fade-in-slide-down
{{ loremipsum }}
:::
## More examples
:::{dropdown} Dropdown with icon
:icon: quote
Dropdown content
:::
:::{dropdown} Dropdown with icon and very long title, *lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec auctor, nunc nec fermentum ultricies, nunc sapien ultricies nunc, nec ultricies sapien sapien nec sapien*
:icon: quote
Dropdown content
:::
:::{dropdown} Using option `:chevron: down-up`
:chevron: down-up
Dropdown content
:::
## Dropdowns in other components
Dropdowns can be nested inside other components, such as inside parent dropdowns or within [grid items](./grids.md).
::::{admonition} Here is an admonition with a dropdown
Admonition content
:::{dropdown} Dropdown inside admonition
:icon: quote
{{ loremipsum }}
:::
::::
::::{dropdown} Parent dropdown title
:open:
:::{dropdown} Child dropdown title
:color: warning
:icon: alert
Dropdown content
:::
::::
:::::{grid} 1 1 2 2
:gutter: 1
::::{grid-item}
:::{dropdown} Dropdown Column 1
Dropdown content
:::
::::
::::{grid-item}
:::{dropdown} Dropdown Column 2
Dropdown content
:::
::::
:::::
## `dropdown` options
open
: Open the dropdown by default.
color
: Set the color of the dropdown header (background and font).
One of the semantic color names: `primary`, `secondary`, `success`, `danger`, `warning`, `info`, `light`, `dark`, `muted`.
icon
: Set an [octicon icon](icons) to prefix the dropdown header.
chevron
: The open-close direction of the chevron.
One of: `right-down`, `down-up`.
animate
: Animate the dropdown opening (`fade-in` or `fade-in-slide-down`).
margin
: Outer margin of grid.
One (all) or four (top bottom left right) values from: 0, 1, 2, 3, 4, 5, auto.
name
: Set a reference-able name for the dropdown container.
class-container
: Additional CSS classes for the container element.
class-title
: Additional CSS classes for the title element.
class-body
: Additional CSS classes for the body element.
|
