@tabler/core 1.1.0 → 1.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/docs/emails/index.mdx +14 -0
- package/docs/emails/introduction/compiled-html.mdx +29 -0
- package/docs/emails/introduction/contents.mdx +63 -0
- package/docs/emails/introduction/index.mdx +9 -0
- package/docs/emails/introduction/source-html.mdx +26 -0
- package/docs/icons/index.mdx +13 -0
- package/docs/icons/libraries/index.mdx +5 -0
- package/docs/icons/libraries/preact.mdx +42 -0
- package/docs/icons/libraries/react.mdx +42 -0
- package/docs/icons/libraries/solidjs.mdx +42 -0
- package/docs/icons/libraries/svelte.mdx +43 -0
- package/docs/icons/libraries/vue.mdx +50 -0
- package/docs/icons/libraries/webfont.mdx +60 -0
- package/docs/icons/plugins/figma.mdx +15 -0
- package/docs/icons/plugins/index.mdx +4 -0
- package/docs/icons/static-files/eps.mdx +15 -0
- package/docs/icons/static-files/index.mdx +5 -0
- package/docs/icons/static-files/pdf.mdx +15 -0
- package/docs/icons/static-files/png.mdx +31 -0
- package/docs/icons/static-files/svg.mdx +85 -0
- package/docs/illustrations/index.mdx +8 -0
- package/docs/illustrations/introduction/contents.mdx +77 -0
- package/docs/illustrations/introduction/customization.mdx +1198 -0
- package/docs/illustrations/introduction/index.mdx +5 -0
- package/docs/illustrations/introduction/license.mdx +90 -0
- package/docs/img/browsers/brave.svg +1 -0
- package/docs/img/browsers/chrome.svg +1 -0
- package/docs/img/browsers/edge.svg +1 -0
- package/docs/img/browsers/electron.svg +1 -0
- package/docs/img/browsers/firefox.svg +1 -0
- package/docs/img/browsers/internet-explorer.svg +1 -0
- package/docs/img/browsers/opera.svg +1 -0
- package/docs/img/browsers/safari.svg +1 -0
- package/docs/img/browsers/vivaldi.svg +1 -0
- package/docs/img/cover-illustrations-dark.png +0 -0
- package/docs/img/cover-illustrations.png +0 -0
- package/docs/img/cover-tabler-dark.png +0 -0
- package/docs/img/cover-tabler.png +0 -0
- package/docs/img/icons/figma-plugin.png +0 -0
- package/docs/img/icons/package-angular-dark.png +0 -0
- package/docs/img/icons/package-angular.png +0 -0
- package/docs/img/icons/package-eps-dark.png +0 -0
- package/docs/img/icons/package-eps.png +0 -0
- package/docs/img/icons/package-js-dark.png +0 -0
- package/docs/img/icons/package-js.png +0 -0
- package/docs/img/icons/package-pdf-dark.png +0 -0
- package/docs/img/icons/package-pdf.png +0 -0
- package/docs/img/icons/package-png-dark.png +0 -0
- package/docs/img/icons/package-png.png +0 -0
- package/docs/img/icons/package-preact-dark.png +0 -0
- package/docs/img/icons/package-preact.png +0 -0
- package/docs/img/icons/package-react-dark.png +0 -0
- package/docs/img/icons/package-react-native-dark.png +0 -0
- package/docs/img/icons/package-react-native.png +0 -0
- package/docs/img/icons/package-react.png +0 -0
- package/docs/img/icons/package-solidjs-dark.png +0 -0
- package/docs/img/icons/package-solidjs.png +0 -0
- package/docs/img/icons/package-sprite-dark.png +0 -0
- package/docs/img/icons/package-sprite.png +0 -0
- package/docs/img/icons/package-svelte-dark.png +0 -0
- package/docs/img/icons/package-svelte.png +0 -0
- package/docs/img/icons/package-svg-dark.png +0 -0
- package/docs/img/icons/package-svg.png +0 -0
- package/docs/img/icons/package-vue-dark.png +0 -0
- package/docs/img/icons/package-vue.png +0 -0
- package/docs/img/icons/package-webfont-dark.png +0 -0
- package/docs/img/icons/package-webfont.png +0 -0
- package/docs/index.mdx +16 -0
- package/docs/ui/base/colors.mdx +83 -0
- package/docs/ui/base/index.mdx +6 -0
- package/docs/ui/base/typography.mdx +311 -0
- package/docs/ui/components/alerts.mdx +406 -0
- package/docs/ui/components/autosize.mdx +25 -0
- package/docs/ui/components/avatars.mdx +227 -0
- package/docs/ui/components/badges.mdx +112 -0
- package/docs/ui/components/breadcrumb.mdx +199 -0
- package/docs/ui/components/buttons.mdx +1213 -0
- package/docs/ui/components/cards.mdx +417 -0
- package/docs/ui/components/carousel.mdx +459 -0
- package/docs/ui/components/charts.mdx +697 -0
- package/docs/ui/components/countup.mdx +165 -0
- package/docs/ui/components/datagrid.mdx +120 -0
- package/docs/ui/components/divider.mdx +68 -0
- package/docs/ui/components/dropdowns.mdx +302 -0
- package/docs/ui/components/dropzone.mdx +88 -0
- package/docs/ui/components/empty.mdx +149 -0
- package/docs/ui/components/icons.mdx +392 -0
- package/docs/ui/components/index.mdx +6 -0
- package/docs/ui/components/inline-player.mdx +58 -0
- package/docs/ui/components/modals.mdx +297 -0
- package/docs/ui/components/offcanvas.mdx +70 -0
- package/docs/ui/components/placeholder.mdx +273 -0
- package/docs/ui/components/popover.mdx +142 -0
- package/docs/ui/components/progress.mdx +241 -0
- package/docs/ui/components/range-slider.mdx +32 -0
- package/docs/ui/components/ribbons.mdx +207 -0
- package/docs/ui/components/segmented-control.mdx +401 -0
- package/docs/ui/components/spinners.mdx +135 -0
- package/docs/ui/components/statuses.mdx +322 -0
- package/docs/ui/components/steps.mdx +174 -0
- package/docs/ui/components/switch-icon.mdx +386 -0
- package/docs/ui/components/tables.mdx +397 -0
- package/docs/ui/components/tabs.mdx +396 -0
- package/docs/ui/components/timelines.mdx +697 -0
- package/docs/ui/components/tinymce.mdx +46 -0
- package/docs/ui/components/toasts.mdx +126 -0
- package/docs/ui/components/tooltips.mdx +65 -0
- package/docs/ui/components/tracking.mdx +548 -0
- package/docs/ui/components/vector-maps.mdx +166 -0
- package/docs/ui/forms/form-color-check.mdx +220 -0
- package/docs/ui/forms/form-elements.mdx +632 -0
- package/docs/ui/forms/form-fieldset.mdx +45 -0
- package/docs/ui/forms/form-helpers.mdx +91 -0
- package/docs/ui/forms/form-image-check.mdx +213 -0
- package/docs/ui/forms/form-input-mask.mdx +61 -0
- package/docs/ui/forms/form-selectboxes.mdx +398 -0
- package/docs/ui/forms/form-validation.mdx +62 -0
- package/docs/ui/forms/index.mdx +6 -0
- package/docs/ui/getting-started/browser-support.mdx +28 -0
- package/docs/ui/getting-started/customize.mdx +28 -0
- package/docs/ui/getting-started/download.mdx +44 -0
- package/docs/ui/getting-started/faq.mdx +30 -0
- package/docs/ui/getting-started/how-to-contribute.mdx +84 -0
- package/docs/ui/getting-started/index.mdx +16 -0
- package/docs/ui/getting-started/installation.mdx +67 -0
- package/docs/ui/getting-started/license.mdx +30 -0
- package/docs/ui/index.mdx +8 -0
- package/docs/ui/layout/index.mdx +6 -0
- package/docs/ui/layout/navbars.mdx +164 -0
- package/docs/ui/layout/navs-tabls.mdx +201 -0
- package/docs/ui/layout/page-headers.mdx +365 -0
- package/docs/ui/layout/page-layouts.mdx +213 -0
- package/docs/ui/plugins/flags.mdx +316 -0
- package/docs/ui/plugins/index.mdx +6 -0
- package/docs/ui/plugins/payments.mdx +152 -0
- package/docs/ui/plugins/social-icons.mdx +135 -0
- package/docs/ui/utilities/borders.mdx +260 -0
- package/docs/ui/utilities/cursors.mdx +63 -0
- package/docs/ui/utilities/index.mdx +5 -0
- package/docs/ui/utilities/interactions.mdx +26 -0
- package/docs/ui/utilities/margins.mdx +234 -0
- package/docs/ui/utilities/vertical-align.mdx +66 -0
- package/docs/ui/utilities/visually-hidden.mdx +12 -0
- package/package.json +6 -6
- package/LICENSE +0 -21
|
@@ -0,0 +1,165 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Countup
|
|
3
|
+
summary: A countup element is used to display numerical data in an interesting way and make the interface more interactive.
|
|
4
|
+
libs: countup
|
|
5
|
+
description: Display numbers dynamically with countups.
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
The countup component is used to display numbers dynamically. It is a great way to make the interface more interactive and engaging. The countup component is a simple and easy way to animate numbers in your application.
|
|
9
|
+
|
|
10
|
+
To be able to use the countup in your application you will need to install the countup.js dependency with `npm install countup.js`.
|
|
11
|
+
|
|
12
|
+
For more advanced features of countups, click [here](https://inorganik.github.io/countUp.js/) and see what more you can do.
|
|
13
|
+
|
|
14
|
+
## Basic usage
|
|
15
|
+
|
|
16
|
+
To create a countup, add `data-countup` to any HTML text tag and specify the number which is to be reached. The animation will be triggered as soon as the number enters the viewport.
|
|
17
|
+
|
|
18
|
+
```html
|
|
19
|
+
<h1 data-countup>30000</h1>
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
The results can be seen in the example below.
|
|
23
|
+
|
|
24
|
+
```html example libs="countup" centered
|
|
25
|
+
<h1 data-countup>30000</h1>
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
## Duration
|
|
29
|
+
|
|
30
|
+
Set the `duration` to determine how long the animation should take. By default, the duration is set to 2 seconds, but you can modify it as you wish.
|
|
31
|
+
|
|
32
|
+
```html
|
|
33
|
+
<h1 data-countup='{"duration":4}'>30000</h1>
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
Look at the example below to see how the duration affects the animation.
|
|
37
|
+
|
|
38
|
+
```html example libs="countup" centered vertical separated
|
|
39
|
+
<h1 data-countup>30000</h1>
|
|
40
|
+
<h1 data-countup='{"duration":4}'>30000</h1>
|
|
41
|
+
<h1 data-countup='{"duration":6}'>30000</h1>
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
## Starting value
|
|
45
|
+
|
|
46
|
+
By default the countup will start from zero. If you want to set a different start value use `startVal`.
|
|
47
|
+
You can also set the start value to be greater than the final value, so that it counts down instead of up.
|
|
48
|
+
|
|
49
|
+
```html
|
|
50
|
+
<h1 data-countup='{"startVal":12345}'>30000</h1>
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
To see how the starting value affects the animation, look at the example below.
|
|
54
|
+
|
|
55
|
+
```html example libs="countup" centered vertical separated
|
|
56
|
+
<h1 data-countup='{"startVal":12345}'>30000</h1>
|
|
57
|
+
<h1 data-countup='{"startVal":47655}'>30000</h1>
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
## Decimal places
|
|
61
|
+
|
|
62
|
+
Set how many decimal numbers should be displayed using `decimalPlaces`. By default, the number of decimal places is set to 0.
|
|
63
|
+
|
|
64
|
+
```html
|
|
65
|
+
<h1 data-countup='{"decimalPlaces":1}'>3.123</h1>
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
Look at the example below to see how the number of decimal places affects the animation.
|
|
69
|
+
|
|
70
|
+
```html example libs="countup" centered vertical separated height="20rem"
|
|
71
|
+
<h1 data-countup>3.123</h1>
|
|
72
|
+
<h1 data-countup='{"decimalPlaces":1}'>3.123</h1>
|
|
73
|
+
<h1 data-countup='{"decimalPlaces":2}'>3.123</h1>
|
|
74
|
+
<h1 data-countup='{"decimalPlaces":3}'>3.123</h1>
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
## Easing
|
|
78
|
+
|
|
79
|
+
Disable easing using `"useEasing": false`. Easing is set to `true` by default, so that the animation speed changes over the course of its duration. Easing can be disabled to make the animation linear.
|
|
80
|
+
|
|
81
|
+
```html
|
|
82
|
+
<h1 data-countup='{"useEasing": false}'>30000</h1>
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
Look at the example below to see how easing affects the animation.
|
|
86
|
+
|
|
87
|
+
```html example libs="countup" centered vertical separated
|
|
88
|
+
<h1 data-countup>30000</h1>
|
|
89
|
+
<h1 data-countup='{"useEasing": false}'>30000</h1>
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
## Use grouping
|
|
93
|
+
|
|
94
|
+
Disable grouping using `"useGrouping": false`. Grouping is set to `true` by default, so that the number is displayed with a separator.
|
|
95
|
+
|
|
96
|
+
```html
|
|
97
|
+
<h1 data-countup='{"useGrouping": false}'>30000</h1>
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
Example below shows how grouping affects the animation.
|
|
101
|
+
|
|
102
|
+
```html example libs="countup" centered vertical separated
|
|
103
|
+
<h1 data-countup>30000</h1>
|
|
104
|
+
<h1 data-countup='{"useGrouping": false}'>30000</h1>
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
## Separator
|
|
108
|
+
|
|
109
|
+
You can change the default separator using `separator` and specifying the one you wish to use.
|
|
110
|
+
|
|
111
|
+
```html
|
|
112
|
+
<h1 data-countup='{"separator":" "}'>3000000</h1>
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
This example shows how the separator affects the animation.
|
|
116
|
+
|
|
117
|
+
```html example libs="countup" centered vertical separated
|
|
118
|
+
<h1 data-countup>3000000</h1>
|
|
119
|
+
<h1 data-countup='{"separator":" "}'>3000000</h1>
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
## Decimal separator
|
|
123
|
+
|
|
124
|
+
You can change the default decimal separator using `decimal` and specifying the one you wish to use.
|
|
125
|
+
|
|
126
|
+
```html
|
|
127
|
+
<h1 data-countup='{"decimal":","}'>3.12</h1>
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
Look at the example below to see how the decimal separator affects the animation.
|
|
131
|
+
|
|
132
|
+
```html example libs="countup" centered vertical separated
|
|
133
|
+
<h1 data-countup='{"decimalPlaces":2}'>3.12</h1>
|
|
134
|
+
<h1 data-countup='{"decimalPlaces":2,"decimal":","}'>3.12</h1>
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
## Prefix
|
|
138
|
+
|
|
139
|
+
Set the countup prefix using `prefix` and specifying the prefix you want to add, for instance a currency symbol.
|
|
140
|
+
|
|
141
|
+
```html
|
|
142
|
+
<h1 data-countup='{"prefix":"$"}'>30000</h1>
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
Look at the example below to see how the prefix affects the animation.
|
|
146
|
+
|
|
147
|
+
```html example libs="countup" centered vertical separated
|
|
148
|
+
<h1 data-countup='{"prefix":"$"}'>30000</h1>
|
|
149
|
+
<h1 data-countup='{"prefix":"€"}'>30000</h1>
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
## Suffix
|
|
153
|
+
|
|
154
|
+
Set the countup suffix using `suffix` and specifying the suffix you want to add, for instance a percentage symbol.
|
|
155
|
+
|
|
156
|
+
```html
|
|
157
|
+
<h1 data-countup='{"suffix":"%"}'>300</h1>
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
Look at the example below to see how the suffix affects the animation.
|
|
161
|
+
|
|
162
|
+
```html example libs="countup" centered vertical separated
|
|
163
|
+
<h1 data-countup='{"suffix":"%"}'>300</h1>
|
|
164
|
+
<h1 data-countup='{"suffix":"‰"}'>300</h1>
|
|
165
|
+
```
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Data grid
|
|
3
|
+
summary: Use the data grid component to display detailed information about your product. The data is displayed as a column of items consisting of a title and content.
|
|
4
|
+
description: Detailed product information in grids.
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
```html example vcentered height="460px"
|
|
8
|
+
<div class="datagrid">
|
|
9
|
+
<div class="datagrid-item">
|
|
10
|
+
<div class="datagrid-title">Registrar</div>
|
|
11
|
+
<div class="datagrid-content">Third Party</div>
|
|
12
|
+
</div>
|
|
13
|
+
<div class="datagrid-item">
|
|
14
|
+
<div class="datagrid-title">Nameservers</div>
|
|
15
|
+
<div class="datagrid-content">Third Party</div>
|
|
16
|
+
</div>
|
|
17
|
+
<div class="datagrid-item">
|
|
18
|
+
<div class="datagrid-title">Port number</div>
|
|
19
|
+
<div class="datagrid-content">3306</div>
|
|
20
|
+
</div>
|
|
21
|
+
<div class="datagrid-item">
|
|
22
|
+
<div class="datagrid-title">Expiration date</div>
|
|
23
|
+
<div class="datagrid-content">–</div>
|
|
24
|
+
</div>
|
|
25
|
+
<div class="datagrid-item">
|
|
26
|
+
<div class="datagrid-title">Creator</div>
|
|
27
|
+
<div class="datagrid-content">
|
|
28
|
+
<div class="d-flex align-items-center">
|
|
29
|
+
<span
|
|
30
|
+
class="avatar avatar-xs me-2 rounded"
|
|
31
|
+
style="background-image: url(/samples/avatars/027m.jpg)"
|
|
32
|
+
></span>
|
|
33
|
+
Paweł Kuna
|
|
34
|
+
</div>
|
|
35
|
+
</div>
|
|
36
|
+
</div>
|
|
37
|
+
<div class="datagrid-item">
|
|
38
|
+
<div class="datagrid-title">Age</div>
|
|
39
|
+
<div class="datagrid-content">15 days</div>
|
|
40
|
+
</div>
|
|
41
|
+
<div class="datagrid-item">
|
|
42
|
+
<div class="datagrid-title">Edge network</div>
|
|
43
|
+
<div class="datagrid-content">
|
|
44
|
+
<span class="status status-green"> Active </span>
|
|
45
|
+
</div>
|
|
46
|
+
</div>
|
|
47
|
+
<div class="datagrid-item">
|
|
48
|
+
<div class="datagrid-title">Avatars list</div>
|
|
49
|
+
<div class="datagrid-content">
|
|
50
|
+
<div class="avatar-list avatar-list-stacked">
|
|
51
|
+
<span
|
|
52
|
+
class="avatar avatar-xs rounded"
|
|
53
|
+
style="background-image: url(/samples/avatars/029f.jpg)"
|
|
54
|
+
></span>
|
|
55
|
+
<span class="avatar avatar-xs rounded">JL</span>
|
|
56
|
+
<span
|
|
57
|
+
class="avatar avatar-xs rounded"
|
|
58
|
+
style="background-image: url(/samples/avatars/015f.jpg)"
|
|
59
|
+
></span>
|
|
60
|
+
<span
|
|
61
|
+
class="avatar avatar-xs rounded"
|
|
62
|
+
style="background-image: url(/samples/avatars/004m.jpg)"
|
|
63
|
+
></span>
|
|
64
|
+
<span
|
|
65
|
+
class="avatar avatar-xs rounded"
|
|
66
|
+
style="background-image: url(/samples/avatars/037m.jpg)"
|
|
67
|
+
></span>
|
|
68
|
+
<span class="avatar avatar-xs rounded">+3</span>
|
|
69
|
+
</div>
|
|
70
|
+
</div>
|
|
71
|
+
</div>
|
|
72
|
+
<div class="datagrid-item">
|
|
73
|
+
<div class="datagrid-title">Checkbox</div>
|
|
74
|
+
<div class="datagrid-content">
|
|
75
|
+
<label class="form-check">
|
|
76
|
+
<input class="form-check-input" type="checkbox" checked />
|
|
77
|
+
<span class="form-check-label">Click me</span>
|
|
78
|
+
</label>
|
|
79
|
+
</div>
|
|
80
|
+
</div>
|
|
81
|
+
<div class="datagrid-item">
|
|
82
|
+
<div class="datagrid-title">Icon</div>
|
|
83
|
+
<div class="datagrid-content">
|
|
84
|
+
<svg
|
|
85
|
+
xmlns="http://www.w3.org/2000/svg"
|
|
86
|
+
class="icon text-green"
|
|
87
|
+
width="24"
|
|
88
|
+
height="24"
|
|
89
|
+
viewBox="0 0 24 24"
|
|
90
|
+
stroke-width="2"
|
|
91
|
+
stroke="currentColor"
|
|
92
|
+
fill="none"
|
|
93
|
+
stroke-linecap="round"
|
|
94
|
+
stroke-linejoin="round"
|
|
95
|
+
>
|
|
96
|
+
<path stroke="none" d="M0 0h24v24H0z" fill="none" />
|
|
97
|
+
<path d="M5 12l5 5l10 -10" />
|
|
98
|
+
</svg>
|
|
99
|
+
Checked
|
|
100
|
+
</div>
|
|
101
|
+
</div>
|
|
102
|
+
<div class="datagrid-item">
|
|
103
|
+
<div class="datagrid-title">Form control</div>
|
|
104
|
+
<div class="datagrid-content">
|
|
105
|
+
<input type="text" class="form-control form-control-flush" placeholder="Input placeholder" />
|
|
106
|
+
</div>
|
|
107
|
+
</div>
|
|
108
|
+
<div class="datagrid-item">
|
|
109
|
+
<div class="datagrid-title">Longer description</div>
|
|
110
|
+
<div class="datagrid-content">Lorem ipsum dolor sit amet, consectetur adipisicing elit.</div>
|
|
111
|
+
</div>
|
|
112
|
+
</div>
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
You can adjust the datagrid to your needs by setting the values of variables:
|
|
116
|
+
|
|
117
|
+
| Variable | Description | Default |
|
|
118
|
+
|----------|-------------|---------|
|
|
119
|
+
| `--tblr-datagrid-item-width` | Width of the datagrid item | `15rem` |
|
|
120
|
+
| `--tblr-datagrid-padding` | Gap between the datagrid items | `1.5rem` |
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Divider
|
|
3
|
+
summary: Dividers help organize content and make the interface layout clear and uncluttered. Greater clarity adds up to better user experience and enhanced interaction with a website or app.
|
|
4
|
+
description: Separate content with clear dividers.
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Default markup
|
|
8
|
+
|
|
9
|
+
Use dividers to visually separate content into parts. You can use a line only or add text that will be centered by default.
|
|
10
|
+
|
|
11
|
+
```html example
|
|
12
|
+
<p>
|
|
13
|
+
Lorem ipsum dolor sit amet, consectetur adipisicing elit. Alias, dolore dolores doloribus est ex.
|
|
14
|
+
</p>
|
|
15
|
+
<div class="hr-text">See also</div>
|
|
16
|
+
<p>
|
|
17
|
+
Dicta error hic illo iure necessitatibus nihil officiis omnis perferendis, praesentium repellendus
|
|
18
|
+
rerum, saepe sed, sit!
|
|
19
|
+
</p>
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
## Text position
|
|
23
|
+
|
|
24
|
+
You can modify the position of the text which is to be included in a separator and make it left- or right-aligned. Otherwise, the text will remain centered.
|
|
25
|
+
|
|
26
|
+
```html example height="380px"
|
|
27
|
+
<p>
|
|
28
|
+
Lorem ipsum dolor sit amet, consectetur adipisicing elit. Alias, dolore dolores doloribus est ex.
|
|
29
|
+
</p>
|
|
30
|
+
<div class="hr-text hr-text-start">Start divider</div>
|
|
31
|
+
<p>
|
|
32
|
+
Dicta error hic illo iure necessitatibus nihil officiis omnis perferendis, praesentium repellendus
|
|
33
|
+
rerum, saepe sed, sit!
|
|
34
|
+
</p>
|
|
35
|
+
<div class="hr-text">Centered divider</div>
|
|
36
|
+
<p>
|
|
37
|
+
Lorem ipsum dolor sit amet, consectetur adipisicing elit. Alias, dolore dolores doloribus est ex.
|
|
38
|
+
</p>
|
|
39
|
+
<div class="hr-text hr-text-end">End divider</div>
|
|
40
|
+
<p>
|
|
41
|
+
Dicta error hic illo iure necessitatibus nihil officiis omnis perferendis, praesentium repellendus
|
|
42
|
+
rerum, saepe sed, sit!
|
|
43
|
+
</p>
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
## Divider color
|
|
47
|
+
|
|
48
|
+
Customize the color of dividers to make them go well with your design. Click [here](/docs/ui/base/colors) to see the list of available colors.
|
|
49
|
+
|
|
50
|
+
```html example height="380px"
|
|
51
|
+
<p>
|
|
52
|
+
Lorem ipsum dolor sit amet, consectetur adipisicing elit. Alias, dolore dolores doloribus est ex.
|
|
53
|
+
</p>
|
|
54
|
+
<div class="hr-text text-green">Green divider</div>
|
|
55
|
+
<p>
|
|
56
|
+
Dicta error hic illo iure necessitatibus nihil officiis omnis perferendis, praesentium repellendus
|
|
57
|
+
rerum, saepe sed, sit!
|
|
58
|
+
</p>
|
|
59
|
+
<div class="hr-text text-red">Red divider</div>
|
|
60
|
+
<p>
|
|
61
|
+
Lorem ipsum dolor sit amet, consectetur adipisicing elit. Alias, dolore dolores doloribus est ex.
|
|
62
|
+
</p>
|
|
63
|
+
<div class="hr-text text-primary">Primary divider</div>
|
|
64
|
+
<p>
|
|
65
|
+
Dicta error hic illo iure necessitatibus nihil officiis omnis perferendis, praesentium repellendus
|
|
66
|
+
rerum, saepe sed, sit!
|
|
67
|
+
</p>
|
|
68
|
+
```
|
|
@@ -0,0 +1,302 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Dropdowns
|
|
3
|
+
summary: Use dropdowns to display lists of options or include more items in a menu without overwhelming users with too many buttons and long lists. Dropdowns facilitate users' interaction with your website or software and make your design look clear.
|
|
4
|
+
bootstrapLink: components/dropdowns
|
|
5
|
+
description: Organize options with dropdown menus.
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## Default dropdown
|
|
9
|
+
|
|
10
|
+
With small markup changes, you can turn any `.btn` into a dropdown toggle and use it to display more options for users to choose from. Start with the default dropdown and then use additional classes to make your dropdown more user-friendly.
|
|
11
|
+
|
|
12
|
+
```html example height="16rem"
|
|
13
|
+
<div class="dropdown">
|
|
14
|
+
<a href="#" class="btn dropdown-toggle" data-bs-toggle="dropdown">Open dropdown</a>
|
|
15
|
+
<div class="dropdown-menu">
|
|
16
|
+
<a class="dropdown-item" href="#">Action</a>
|
|
17
|
+
<a class="dropdown-item" href="#">Another action</a>
|
|
18
|
+
<a class="dropdown-item" href="#">Third action</a>
|
|
19
|
+
</div>
|
|
20
|
+
</div>
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## Dropdown divider
|
|
24
|
+
|
|
25
|
+
Use dropdown dividers to separate groups of dropdown items for greater clarity.
|
|
26
|
+
|
|
27
|
+
```html example height="16rem"
|
|
28
|
+
<div class="dropdown">
|
|
29
|
+
<a href="#" class="btn dropdown-toggle" data-bs-toggle="dropdown">Open dropdown</a>
|
|
30
|
+
<div class="dropdown-menu">
|
|
31
|
+
<a class="dropdown-item" href="#"> Action </a>
|
|
32
|
+
<a class="dropdown-item" href="#"> Another action </a>
|
|
33
|
+
<div class="dropdown-divider"></div>
|
|
34
|
+
<a class="dropdown-item" href="#">Separated link</a>
|
|
35
|
+
</div>
|
|
36
|
+
</div>
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## Active state
|
|
40
|
+
|
|
41
|
+
Make a dropdown item look active, so that it highlights when a user hovers over a given option.
|
|
42
|
+
|
|
43
|
+
```html example height="16rem"
|
|
44
|
+
<div class="dropdown">
|
|
45
|
+
<a href="#" class="btn dropdown-toggle" data-bs-toggle="dropdown">Open dropdown</a>
|
|
46
|
+
<div class="dropdown-menu">
|
|
47
|
+
<a class="dropdown-item" href="#"> Action </a>
|
|
48
|
+
<a class="dropdown-item" href="#"> Another action </a>
|
|
49
|
+
<a class="dropdown-item active" href="#">Active action</a>
|
|
50
|
+
</div>
|
|
51
|
+
</div>
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
## Disabled state
|
|
55
|
+
|
|
56
|
+
Make a dropdown item look disabled to display options which are currently not available but can activate once certain conditions are met.
|
|
57
|
+
|
|
58
|
+
```html example height="16rem"
|
|
59
|
+
<div class="dropdown">
|
|
60
|
+
<a href="#" class="btn dropdown-toggle" data-bs-toggle="dropdown">Open dropdown</a>
|
|
61
|
+
<div class="dropdown-menu">
|
|
62
|
+
<a class="dropdown-item" href="#"> Action </a>
|
|
63
|
+
<a class="dropdown-item" href="#"> Another action </a>
|
|
64
|
+
<a class="dropdown-item disabled" href="#">Disabled action</a>
|
|
65
|
+
</div>
|
|
66
|
+
</div>
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
## Dropdown header
|
|
70
|
+
|
|
71
|
+
Add a dropdown header to group dropdown items into sections and name them accordingly.
|
|
72
|
+
|
|
73
|
+
```html example height="16rem"
|
|
74
|
+
<div class="dropdown">
|
|
75
|
+
<a href="#" class="btn dropdown-toggle" data-bs-toggle="dropdown">Open dropdown</a>
|
|
76
|
+
<div class="dropdown-menu">
|
|
77
|
+
<span class="dropdown-header">Dropdown header</span>
|
|
78
|
+
<a class="dropdown-item" href="#"> Action </a>
|
|
79
|
+
<a class="dropdown-item" href="#"> Another action </a>
|
|
80
|
+
</div>
|
|
81
|
+
</div>
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
## Dropdown with icons
|
|
85
|
+
|
|
86
|
+
Use icons in your dropdowns to add more visual content and make the options easy to identify for users.
|
|
87
|
+
|
|
88
|
+
```html example height="16rem"
|
|
89
|
+
<div class="dropdown">
|
|
90
|
+
<a href="#" class="btn dropdown-toggle" data-bs-toggle="dropdown">Open dropdown</a>
|
|
91
|
+
<div class="dropdown-menu">
|
|
92
|
+
<span class="dropdown-header">Dropdown header</span>
|
|
93
|
+
<a class="dropdown-item" href="#">
|
|
94
|
+
<svg
|
|
95
|
+
xmlns="http://www.w3.org/2000/svg"
|
|
96
|
+
class="icon dropdown-item-icon icon-tabler icon-tabler-settings"
|
|
97
|
+
width="24"
|
|
98
|
+
height="24"
|
|
99
|
+
viewBox="0 0 24 24"
|
|
100
|
+
stroke-width="2"
|
|
101
|
+
stroke="currentColor"
|
|
102
|
+
fill="none"
|
|
103
|
+
stroke-linecap="round"
|
|
104
|
+
stroke-linejoin="round"
|
|
105
|
+
>
|
|
106
|
+
<path stroke="none" d="M0 0h24v24H0z" fill="none"></path>
|
|
107
|
+
<path
|
|
108
|
+
d="M10.325 4.317c.426 -1.756 2.924 -1.756 3.35 0a1.724 1.724 0 0 0 2.573 1.066c1.543 -.94 3.31 .826 2.37 2.37a1.724 1.724 0 0 0 1.065 2.572c1.756 .426 1.756 2.924 0 3.35a1.724 1.724 0 0 0 -1.066 2.573c.94 1.543 -.826 3.31 -2.37 2.37a1.724 1.724 0 0 0 -2.572 1.065c-.426 1.756 -2.924 1.756 -3.35 0a1.724 1.724 0 0 0 -2.573 -1.066c-1.543 .94 -3.31 -.826 -2.37 -2.37a1.724 1.724 0 0 0 -1.065 -2.572c-1.756 -.426 -1.756 -2.924 0 -3.35a1.724 1.724 0 0 0 1.066 -2.573c-.94 -1.543 .826 -3.31 2.37 -2.37c1 .608 2.296 .07 2.572 -1.065z"
|
|
109
|
+
></path>
|
|
110
|
+
<path d="M12 12m-3 0a3 3 0 1 0 6 0a3 3 0 1 0 -6 0"></path>
|
|
111
|
+
</svg>
|
|
112
|
+
Action
|
|
113
|
+
</a>
|
|
114
|
+
<a class="dropdown-item" href="#">
|
|
115
|
+
<svg
|
|
116
|
+
xmlns="http://www.w3.org/2000/svg"
|
|
117
|
+
class="icon dropdown-item-icon icon-tabler icon-tabler-pencil"
|
|
118
|
+
width="24"
|
|
119
|
+
height="24"
|
|
120
|
+
viewBox="0 0 24 24"
|
|
121
|
+
stroke-width="2"
|
|
122
|
+
stroke="currentColor"
|
|
123
|
+
fill="none"
|
|
124
|
+
stroke-linecap="round"
|
|
125
|
+
stroke-linejoin="round"
|
|
126
|
+
>
|
|
127
|
+
<path stroke="none" d="M0 0h24v24H0z" fill="none"></path>
|
|
128
|
+
<path d="M4 20h4l10.5 -10.5a1.5 1.5 0 0 0 -4 -4l-10.5 10.5v4"></path>
|
|
129
|
+
<path d="M13.5 6.5l4 4"></path>
|
|
130
|
+
</svg>
|
|
131
|
+
Another action
|
|
132
|
+
</a>
|
|
133
|
+
</div>
|
|
134
|
+
</div>
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
## Dropdown with arrow
|
|
138
|
+
|
|
139
|
+
Add an arrow that points at the dropdown button.
|
|
140
|
+
|
|
141
|
+
```html example height="16rem"
|
|
142
|
+
<div class="dropdown">
|
|
143
|
+
<a href="#" class="btn dropdown-toggle" data-bs-toggle="dropdown">Open dropdown</a>
|
|
144
|
+
<div class="dropdown-menu dropdown-menu-arrow">
|
|
145
|
+
<a class="dropdown-item" href="#"> Action </a>
|
|
146
|
+
<a class="dropdown-item" href="#"> Another action </a>
|
|
147
|
+
</div>
|
|
148
|
+
</div>
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
## Dropdown with badge
|
|
152
|
+
|
|
153
|
+
Add a badge to your dropdown items to show additional information related to an item or distinguish it from other elements.
|
|
154
|
+
|
|
155
|
+
```html example height="16rem"
|
|
156
|
+
<div class="dropdown">
|
|
157
|
+
<a href="#" class="btn dropdown-toggle" data-bs-toggle="dropdown">Open dropdown</a>
|
|
158
|
+
<div class="dropdown-menu">
|
|
159
|
+
<a class="dropdown-item" href="#">
|
|
160
|
+
Action
|
|
161
|
+
<span class="badge bg-primary ms-auto">12</span>
|
|
162
|
+
</a>
|
|
163
|
+
<a class="dropdown-item" href="#">
|
|
164
|
+
Another action
|
|
165
|
+
<span class="badge bg-green ms-auto"></span>
|
|
166
|
+
</a>
|
|
167
|
+
</div>
|
|
168
|
+
</div>
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
## Dropdown with checkboxes
|
|
172
|
+
|
|
173
|
+
Use dropdowns with checkboxes to allow users to select options from a predefined list. Dropdowns with checkboxes are particularly useful for filtering.
|
|
174
|
+
|
|
175
|
+
```html example height="16rem"
|
|
176
|
+
<div class="dropdown">
|
|
177
|
+
<a href="#" class="btn dropdown-toggle" data-bs-toggle="dropdown">Open dropdown</a>
|
|
178
|
+
<div class="dropdown-menu">
|
|
179
|
+
<label class="dropdown-item">
|
|
180
|
+
<input class="form-check-input m-0 me-2" type="radio" /> Option 1
|
|
181
|
+
</label>
|
|
182
|
+
<label class="dropdown-item">
|
|
183
|
+
<input class="form-check-input m-0 me-2" type="radio" /> Option 2
|
|
184
|
+
</label>
|
|
185
|
+
<label class="dropdown-item">
|
|
186
|
+
<input class="form-check-input m-0 me-2" type="radio" /> Option 3
|
|
187
|
+
</label>
|
|
188
|
+
</div>
|
|
189
|
+
</div>
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
## Dark dropdown
|
|
193
|
+
|
|
194
|
+
Make your dropdown suit the dark mode of your website or software.
|
|
195
|
+
|
|
196
|
+
```html example height="16rem"
|
|
197
|
+
<div class="dropdown">
|
|
198
|
+
<a href="#" class="btn dropdown-toggle" data-bs-toggle="dropdown">Open dropdown</a>
|
|
199
|
+
<div class="dropdown-menu dropdown-menu-arrow bg-dark text-white">
|
|
200
|
+
<span class="dropdown-header">Dropdown header</span>
|
|
201
|
+
<a class="dropdown-item" href="#">
|
|
202
|
+
<svg
|
|
203
|
+
xmlns="http://www.w3.org/2000/svg"
|
|
204
|
+
class="icon dropdown-item-icon"
|
|
205
|
+
width="24"
|
|
206
|
+
height="24"
|
|
207
|
+
viewBox="0 0 24 24"
|
|
208
|
+
stroke-width="2"
|
|
209
|
+
stroke="currentColor"
|
|
210
|
+
fill="none"
|
|
211
|
+
stroke-linecap="round"
|
|
212
|
+
stroke-linejoin="round"
|
|
213
|
+
>
|
|
214
|
+
<path stroke="none" d="M0 0h24v24H0z" fill="none" />
|
|
215
|
+
<path
|
|
216
|
+
d="M10.325 4.317c.426 -1.756 2.924 -1.756 3.35 0a1.724 1.724 0 0 0 2.573 1.066c1.543 -.94 3.31 .826 2.37 2.37a1.724 1.724 0 0 0 1.065 2.572c1.756 .426 1.756 2.924 0 3.35a1.724 1.724 0 0 0 -1.066 2.573c.94 1.543 -.826 3.31 -2.37 2.37a1.724 1.724 0 0 0 -2.572 1.065c-.426 1.756 -2.924 1.756 -3.35 0a1.724 1.724 0 0 0 -2.573 -1.066c-1.543 .94 -3.31 -.826 -2.37 -2.37a1.724 1.724 0 0 0 -1.065 -2.572c-1.756 -.426 -1.756 -2.924 0 -3.35a1.724 1.724 0 0 0 1.066 -2.573c-.94 -1.543 .826 -3.31 2.37 -2.37c1 .608 2.296 .07 2.572 -1.065z"
|
|
217
|
+
/>
|
|
218
|
+
<circle cx="12" cy="12" r="3" />
|
|
219
|
+
</svg>
|
|
220
|
+
Action
|
|
221
|
+
</a>
|
|
222
|
+
<a class="dropdown-item" href="#">
|
|
223
|
+
<svg
|
|
224
|
+
xmlns="http://www.w3.org/2000/svg"
|
|
225
|
+
class="icon dropdown-item-icon"
|
|
226
|
+
width="24"
|
|
227
|
+
height="24"
|
|
228
|
+
viewBox="0 0 24 24"
|
|
229
|
+
stroke-width="2"
|
|
230
|
+
stroke="currentColor"
|
|
231
|
+
fill="none"
|
|
232
|
+
stroke-linecap="round"
|
|
233
|
+
stroke-linejoin="round"
|
|
234
|
+
>
|
|
235
|
+
<path stroke="none" d="M0 0h24v24H0z" fill="none" />
|
|
236
|
+
<path d="M7 7h-1a2 2 0 0 0 -2 2v9a2 2 0 0 0 2 2h9a2 2 0 0 0 2 -2v-1" />
|
|
237
|
+
<path d="M20.385 6.585a2.1 2.1 0 0 0 -2.97 -2.97l-8.415 8.385v3h3l8.385 -8.415z" />
|
|
238
|
+
<path d="M16 5l3 3" />
|
|
239
|
+
</svg>
|
|
240
|
+
Another action
|
|
241
|
+
</a>
|
|
242
|
+
</div>
|
|
243
|
+
</div>
|
|
244
|
+
```
|
|
245
|
+
|
|
246
|
+
## Dropdown with card content
|
|
247
|
+
|
|
248
|
+
Use a dropdown with card content to make it easy for users to get more information on a given subject and avoid ovewhelming them with too much content at once.
|
|
249
|
+
|
|
250
|
+
```html example height="35rem"
|
|
251
|
+
<div class="dropdown">
|
|
252
|
+
<a href="#" class="btn dropdown-toggle" data-bs-toggle="dropdown">Open dropdown</a>
|
|
253
|
+
<div class="dropdown-menu dropdown-menu-card" style="max-width: 16rem">
|
|
254
|
+
<div class="card d-flex flex-column">
|
|
255
|
+
<a href="#">
|
|
256
|
+
<img
|
|
257
|
+
class="card-img-top"
|
|
258
|
+
src="/samples/photos/friends-at-a-restaurant-drinking-wine.jpg"
|
|
259
|
+
alt="How do you know she is a witch?"
|
|
260
|
+
/>
|
|
261
|
+
</a>
|
|
262
|
+
<div class="card-body d-flex flex-column">
|
|
263
|
+
<h3 class="card-title">
|
|
264
|
+
<a href="#">How do you know she is a witch?</a>
|
|
265
|
+
</h3>
|
|
266
|
+
<div class="text-secondary">
|
|
267
|
+
Are you suggesting that coconuts migrate? No, no, no! Yes, yes. A bit. But she's got a
|
|
268
|
+
wart. You ...
|
|
269
|
+
</div>
|
|
270
|
+
<div class="d-flex align-items-center pt-4 mt-auto">
|
|
271
|
+
<span class="avatar" style="background-image: url(/samples/avatars/013m.jpg)"></span>
|
|
272
|
+
<div class="ms-3">
|
|
273
|
+
<a href="#" class="text-body">Maryjo Lebarree</a>
|
|
274
|
+
<div class="text-secondary">3 days ago</div>
|
|
275
|
+
</div>
|
|
276
|
+
<div class="ms-auto">
|
|
277
|
+
<a href="#" class="icon d-none d-md-inline-block ms-3 text-secondary">
|
|
278
|
+
<svg
|
|
279
|
+
xmlns="http://www.w3.org/2000/svg"
|
|
280
|
+
class="icon"
|
|
281
|
+
width="24"
|
|
282
|
+
height="24"
|
|
283
|
+
viewBox="0 0 24 24"
|
|
284
|
+
stroke-width="2"
|
|
285
|
+
stroke="currentColor"
|
|
286
|
+
fill="none"
|
|
287
|
+
stroke-linecap="round"
|
|
288
|
+
stroke-linejoin="round"
|
|
289
|
+
>
|
|
290
|
+
<path stroke="none" d="M0 0h24v24H0z" fill="none" />
|
|
291
|
+
<path
|
|
292
|
+
d="M19.5 12.572l-7.5 7.428l-7.5 -7.428m0 0a5 5 0 1 1 7.5 -6.566a5 5 0 1 1 7.5 6.572"
|
|
293
|
+
/>
|
|
294
|
+
</svg>
|
|
295
|
+
</a>
|
|
296
|
+
</div>
|
|
297
|
+
</div>
|
|
298
|
+
</div>
|
|
299
|
+
</div>
|
|
300
|
+
</div>
|
|
301
|
+
</div>
|
|
302
|
+
```
|