@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.
Files changed (145) hide show
  1. package/docs/emails/index.mdx +14 -0
  2. package/docs/emails/introduction/compiled-html.mdx +29 -0
  3. package/docs/emails/introduction/contents.mdx +63 -0
  4. package/docs/emails/introduction/index.mdx +9 -0
  5. package/docs/emails/introduction/source-html.mdx +26 -0
  6. package/docs/icons/index.mdx +13 -0
  7. package/docs/icons/libraries/index.mdx +5 -0
  8. package/docs/icons/libraries/preact.mdx +42 -0
  9. package/docs/icons/libraries/react.mdx +42 -0
  10. package/docs/icons/libraries/solidjs.mdx +42 -0
  11. package/docs/icons/libraries/svelte.mdx +43 -0
  12. package/docs/icons/libraries/vue.mdx +50 -0
  13. package/docs/icons/libraries/webfont.mdx +60 -0
  14. package/docs/icons/plugins/figma.mdx +15 -0
  15. package/docs/icons/plugins/index.mdx +4 -0
  16. package/docs/icons/static-files/eps.mdx +15 -0
  17. package/docs/icons/static-files/index.mdx +5 -0
  18. package/docs/icons/static-files/pdf.mdx +15 -0
  19. package/docs/icons/static-files/png.mdx +31 -0
  20. package/docs/icons/static-files/svg.mdx +85 -0
  21. package/docs/illustrations/index.mdx +8 -0
  22. package/docs/illustrations/introduction/contents.mdx +77 -0
  23. package/docs/illustrations/introduction/customization.mdx +1198 -0
  24. package/docs/illustrations/introduction/index.mdx +5 -0
  25. package/docs/illustrations/introduction/license.mdx +90 -0
  26. package/docs/img/browsers/brave.svg +1 -0
  27. package/docs/img/browsers/chrome.svg +1 -0
  28. package/docs/img/browsers/edge.svg +1 -0
  29. package/docs/img/browsers/electron.svg +1 -0
  30. package/docs/img/browsers/firefox.svg +1 -0
  31. package/docs/img/browsers/internet-explorer.svg +1 -0
  32. package/docs/img/browsers/opera.svg +1 -0
  33. package/docs/img/browsers/safari.svg +1 -0
  34. package/docs/img/browsers/vivaldi.svg +1 -0
  35. package/docs/img/cover-illustrations-dark.png +0 -0
  36. package/docs/img/cover-illustrations.png +0 -0
  37. package/docs/img/cover-tabler-dark.png +0 -0
  38. package/docs/img/cover-tabler.png +0 -0
  39. package/docs/img/icons/figma-plugin.png +0 -0
  40. package/docs/img/icons/package-angular-dark.png +0 -0
  41. package/docs/img/icons/package-angular.png +0 -0
  42. package/docs/img/icons/package-eps-dark.png +0 -0
  43. package/docs/img/icons/package-eps.png +0 -0
  44. package/docs/img/icons/package-js-dark.png +0 -0
  45. package/docs/img/icons/package-js.png +0 -0
  46. package/docs/img/icons/package-pdf-dark.png +0 -0
  47. package/docs/img/icons/package-pdf.png +0 -0
  48. package/docs/img/icons/package-png-dark.png +0 -0
  49. package/docs/img/icons/package-png.png +0 -0
  50. package/docs/img/icons/package-preact-dark.png +0 -0
  51. package/docs/img/icons/package-preact.png +0 -0
  52. package/docs/img/icons/package-react-dark.png +0 -0
  53. package/docs/img/icons/package-react-native-dark.png +0 -0
  54. package/docs/img/icons/package-react-native.png +0 -0
  55. package/docs/img/icons/package-react.png +0 -0
  56. package/docs/img/icons/package-solidjs-dark.png +0 -0
  57. package/docs/img/icons/package-solidjs.png +0 -0
  58. package/docs/img/icons/package-sprite-dark.png +0 -0
  59. package/docs/img/icons/package-sprite.png +0 -0
  60. package/docs/img/icons/package-svelte-dark.png +0 -0
  61. package/docs/img/icons/package-svelte.png +0 -0
  62. package/docs/img/icons/package-svg-dark.png +0 -0
  63. package/docs/img/icons/package-svg.png +0 -0
  64. package/docs/img/icons/package-vue-dark.png +0 -0
  65. package/docs/img/icons/package-vue.png +0 -0
  66. package/docs/img/icons/package-webfont-dark.png +0 -0
  67. package/docs/img/icons/package-webfont.png +0 -0
  68. package/docs/index.mdx +16 -0
  69. package/docs/ui/base/colors.mdx +83 -0
  70. package/docs/ui/base/index.mdx +6 -0
  71. package/docs/ui/base/typography.mdx +311 -0
  72. package/docs/ui/components/alerts.mdx +406 -0
  73. package/docs/ui/components/autosize.mdx +25 -0
  74. package/docs/ui/components/avatars.mdx +227 -0
  75. package/docs/ui/components/badges.mdx +112 -0
  76. package/docs/ui/components/breadcrumb.mdx +199 -0
  77. package/docs/ui/components/buttons.mdx +1213 -0
  78. package/docs/ui/components/cards.mdx +417 -0
  79. package/docs/ui/components/carousel.mdx +459 -0
  80. package/docs/ui/components/charts.mdx +697 -0
  81. package/docs/ui/components/countup.mdx +165 -0
  82. package/docs/ui/components/datagrid.mdx +120 -0
  83. package/docs/ui/components/divider.mdx +68 -0
  84. package/docs/ui/components/dropdowns.mdx +302 -0
  85. package/docs/ui/components/dropzone.mdx +88 -0
  86. package/docs/ui/components/empty.mdx +149 -0
  87. package/docs/ui/components/icons.mdx +392 -0
  88. package/docs/ui/components/index.mdx +6 -0
  89. package/docs/ui/components/inline-player.mdx +58 -0
  90. package/docs/ui/components/modals.mdx +297 -0
  91. package/docs/ui/components/offcanvas.mdx +70 -0
  92. package/docs/ui/components/placeholder.mdx +273 -0
  93. package/docs/ui/components/popover.mdx +142 -0
  94. package/docs/ui/components/progress.mdx +241 -0
  95. package/docs/ui/components/range-slider.mdx +32 -0
  96. package/docs/ui/components/ribbons.mdx +207 -0
  97. package/docs/ui/components/segmented-control.mdx +401 -0
  98. package/docs/ui/components/spinners.mdx +135 -0
  99. package/docs/ui/components/statuses.mdx +322 -0
  100. package/docs/ui/components/steps.mdx +174 -0
  101. package/docs/ui/components/switch-icon.mdx +386 -0
  102. package/docs/ui/components/tables.mdx +397 -0
  103. package/docs/ui/components/tabs.mdx +396 -0
  104. package/docs/ui/components/timelines.mdx +697 -0
  105. package/docs/ui/components/tinymce.mdx +46 -0
  106. package/docs/ui/components/toasts.mdx +126 -0
  107. package/docs/ui/components/tooltips.mdx +65 -0
  108. package/docs/ui/components/tracking.mdx +548 -0
  109. package/docs/ui/components/vector-maps.mdx +166 -0
  110. package/docs/ui/forms/form-color-check.mdx +220 -0
  111. package/docs/ui/forms/form-elements.mdx +632 -0
  112. package/docs/ui/forms/form-fieldset.mdx +45 -0
  113. package/docs/ui/forms/form-helpers.mdx +91 -0
  114. package/docs/ui/forms/form-image-check.mdx +213 -0
  115. package/docs/ui/forms/form-input-mask.mdx +61 -0
  116. package/docs/ui/forms/form-selectboxes.mdx +398 -0
  117. package/docs/ui/forms/form-validation.mdx +62 -0
  118. package/docs/ui/forms/index.mdx +6 -0
  119. package/docs/ui/getting-started/browser-support.mdx +28 -0
  120. package/docs/ui/getting-started/customize.mdx +28 -0
  121. package/docs/ui/getting-started/download.mdx +44 -0
  122. package/docs/ui/getting-started/faq.mdx +30 -0
  123. package/docs/ui/getting-started/how-to-contribute.mdx +84 -0
  124. package/docs/ui/getting-started/index.mdx +16 -0
  125. package/docs/ui/getting-started/installation.mdx +67 -0
  126. package/docs/ui/getting-started/license.mdx +30 -0
  127. package/docs/ui/index.mdx +8 -0
  128. package/docs/ui/layout/index.mdx +6 -0
  129. package/docs/ui/layout/navbars.mdx +164 -0
  130. package/docs/ui/layout/navs-tabls.mdx +201 -0
  131. package/docs/ui/layout/page-headers.mdx +365 -0
  132. package/docs/ui/layout/page-layouts.mdx +213 -0
  133. package/docs/ui/plugins/flags.mdx +316 -0
  134. package/docs/ui/plugins/index.mdx +6 -0
  135. package/docs/ui/plugins/payments.mdx +152 -0
  136. package/docs/ui/plugins/social-icons.mdx +135 -0
  137. package/docs/ui/utilities/borders.mdx +260 -0
  138. package/docs/ui/utilities/cursors.mdx +63 -0
  139. package/docs/ui/utilities/index.mdx +5 -0
  140. package/docs/ui/utilities/interactions.mdx +26 -0
  141. package/docs/ui/utilities/margins.mdx +234 -0
  142. package/docs/ui/utilities/vertical-align.mdx +66 -0
  143. package/docs/ui/utilities/visually-hidden.mdx +12 -0
  144. package/package.json +6 -6
  145. 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
+ ```