flowbite-mcp 1.1.3 → 1.1.5
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/README.md +49 -74
- package/build/index.js +20 -36
- package/data/components/accordion.md +39 -53
- package/data/components/alerts.md +27 -44
- package/data/components/avatar.md +20 -33
- package/data/components/badge.md +34 -47
- package/data/components/banner.md +10 -29
- package/data/components/bottom-navigation.md +16 -29
- package/data/components/breadcrumb.md +12 -25
- package/data/components/button-group.md +26 -39
- package/data/components/buttons.md +41 -67
- package/data/components/card.md +34 -47
- package/data/components/carousel.md +25 -39
- package/data/components/chat-bubble.md +36 -50
- package/data/components/clipboard.md +256 -252
- package/data/components/datepicker.md +56 -70
- package/data/components/device-mockups.md +16 -29
- package/data/components/drawer.md +42 -56
- package/data/components/dropdowns.md +66 -80
- package/data/components/footer.md +16 -29
- package/data/components/forms.md +32 -50
- package/data/components/gallery.md +16 -33
- package/data/components/indicators.md +18 -31
- package/data/components/jumbotron.md +12 -25
- package/data/components/kbd.md +14 -27
- package/data/components/list-group.md +14 -27
- package/data/components/mega-menu.md +10 -24
- package/data/components/modal.md +37 -51
- package/data/components/navbar.md +41 -55
- package/data/components/pagination.md +22 -35
- package/data/components/popover.md +36 -51
- package/data/components/progress.md +10 -23
- package/data/components/qr-code.md +41 -133
- package/data/components/rating.md +16 -29
- package/data/components/sidebar.md +15 -30
- package/data/components/skeleton.md +16 -29
- package/data/components/speed-dial.md +40 -55
- package/data/components/spinner.md +14 -27
- package/data/components/stepper.md +14 -27
- package/data/components/tables.md +45 -64
- package/data/components/tabs.md +30 -45
- package/data/components/timeline.md +10 -23
- package/data/components/toast.md +25 -39
- package/data/components/tooltips.md +24 -39
- package/data/components/typography.md +22 -35
- package/data/components/video.md +14 -27
- package/data/forms/checkbox.md +27 -43
- package/data/forms/file-input.md +12 -26
- package/data/forms/floating-label.md +12 -25
- package/data/forms/input-field.md +17 -32
- package/data/forms/number-input.md +83 -93
- package/data/forms/phone-input.md +42 -54
- package/data/forms/radio.md +23 -39
- package/data/forms/range.md +12 -26
- package/data/forms/search-input.md +14 -31
- package/data/forms/select.md +15 -30
- package/data/forms/textarea.md +8 -21
- package/data/forms/timepicker.md +30 -42
- package/data/forms/toggle.md +18 -31
- package/data/plugins/charts.md +542 -526
- package/data/plugins/datatables.md +285 -286
- package/data/plugins/wysiwyg.md +658 -650
- package/data/quickstart.md +24 -24
- package/data/typography/blockquote.md +24 -37
- package/data/typography/headings.md +30 -43
- package/data/typography/hr.md +10 -23
- package/data/typography/images.md +32 -45
- package/data/typography/links.md +16 -29
- package/data/typography/lists.md +22 -35
- package/data/typography/paragraphs.md +30 -43
- package/data/typography/text.md +42 -55
- package/package.json +1 -1
package/data/components/tabs.md
CHANGED
|
@@ -1,23 +1,10 @@
|
|
|
1
|
-
---
|
|
2
|
-
layout: docs
|
|
3
|
-
title: Tailwind CSS Tabs - Flowbite
|
|
4
|
-
description: Use these responsive tabs components to create a secondary navigational hierarchy for your website or toggle content inside a container
|
|
5
|
-
group: components
|
|
6
|
-
toc: true
|
|
7
|
-
|
|
8
|
-
previous: Tables
|
|
9
|
-
previousLink: components/tables/
|
|
10
|
-
next: Timeline
|
|
11
|
-
nextLink: components/timeline/
|
|
12
|
-
---
|
|
13
|
-
|
|
14
1
|
The tabs component can be used either as an extra navigational hierarchy complementing the main navbar or you can also use it to change content inside a container just below the tabs using the data attributes from Flowbite.
|
|
15
2
|
|
|
16
3
|
## Default tabs
|
|
17
4
|
|
|
18
5
|
Use the following default tabs component example to show a list of links that the user can navigate from on your website.
|
|
19
6
|
|
|
20
|
-
|
|
7
|
+
```html
|
|
21
8
|
|
|
22
9
|
<ul class="flex flex-wrap text-sm font-medium text-center text-body border-b border-default">
|
|
23
10
|
<li class="me-2">
|
|
@@ -36,13 +23,13 @@ Use the following default tabs component example to show a list of links that th
|
|
|
36
23
|
<a class="inline-block p-4 text-fg-disabled rounded-t-base cursor-not-allowed">Disabled</a>
|
|
37
24
|
</li>
|
|
38
25
|
</ul>
|
|
39
|
-
|
|
26
|
+
```
|
|
40
27
|
|
|
41
28
|
## Tabs with underline
|
|
42
29
|
|
|
43
30
|
Use this alternative tabs component style with an underline instead of a background when hovering and being active on a certain page.
|
|
44
31
|
|
|
45
|
-
|
|
32
|
+
```html
|
|
46
33
|
|
|
47
34
|
<div class="text-sm font-medium text-center text-body border-b border-default">
|
|
48
35
|
<ul class="flex flex-wrap -mb-px">
|
|
@@ -63,13 +50,13 @@ Use this alternative tabs component style with an underline instead of a backgro
|
|
|
63
50
|
</li>
|
|
64
51
|
</ul>
|
|
65
52
|
</div>
|
|
66
|
-
|
|
53
|
+
```
|
|
67
54
|
|
|
68
55
|
## Tabs with icons
|
|
69
56
|
|
|
70
57
|
This is an example of the tabs component where you can also use a SVG powered icon to complement the text within the navigational tabs.
|
|
71
58
|
|
|
72
|
-
|
|
59
|
+
```html
|
|
73
60
|
|
|
74
61
|
<div class="border-b border-default">
|
|
75
62
|
<ul class="flex flex-wrap -mb-px text-sm font-medium text-center text-body">
|
|
@@ -102,13 +89,13 @@ This is an example of the tabs component where you can also use a SVG powered ic
|
|
|
102
89
|
</li>
|
|
103
90
|
</ul>
|
|
104
91
|
</div>
|
|
105
|
-
|
|
92
|
+
```
|
|
106
93
|
|
|
107
94
|
## Pills tabs
|
|
108
95
|
|
|
109
96
|
If you want to use pills as a style for the tabs component you can do so by using this example.
|
|
110
97
|
|
|
111
|
-
|
|
98
|
+
```html
|
|
112
99
|
|
|
113
100
|
<ul class="flex flex-wrap text-sm font-medium text-center text-body">
|
|
114
101
|
<li class="me-2">
|
|
@@ -127,13 +114,13 @@ If you want to use pills as a style for the tabs component you can do so by usin
|
|
|
127
114
|
<a class="inline-block px-4 py-3 text-fg-disabled cursor-not-allowed">Tab 5</a>
|
|
128
115
|
</li>
|
|
129
116
|
</ul>
|
|
130
|
-
|
|
117
|
+
```
|
|
131
118
|
|
|
132
119
|
## Vertical tabs
|
|
133
120
|
|
|
134
121
|
Use this example to show a vertically aligned set of tabs on the left side of the page.
|
|
135
122
|
|
|
136
|
-
|
|
123
|
+
```html
|
|
137
124
|
|
|
138
125
|
<div class="md:flex">
|
|
139
126
|
<ul class="flex-column space-y space-y-4 text-sm font-medium text-body md:me-4 mb-4 md:mb-0">
|
|
@@ -175,14 +162,14 @@ Use this example to show a vertically aligned set of tabs on the left side of th
|
|
|
175
162
|
</div>
|
|
176
163
|
</div>
|
|
177
164
|
|
|
178
|
-
|
|
165
|
+
```
|
|
179
166
|
|
|
180
167
|
|
|
181
168
|
## Full width tabs
|
|
182
169
|
|
|
183
170
|
If you want to show the tabs on the full width relative to the parent element you can do so by using the full width tabs component example.
|
|
184
171
|
|
|
185
|
-
|
|
172
|
+
```html
|
|
186
173
|
|
|
187
174
|
<div class="sm:hidden">
|
|
188
175
|
<label for="tabs" class="sr-only">Select your country</label>
|
|
@@ -207,13 +194,13 @@ If you want to show the tabs on the full width relative to the parent element yo
|
|
|
207
194
|
<a href="#" class="inline-block w-full text-body bg-neutral-primary-soft border border-default rounded-e-base hover:bg-neutral-secondary-medium hover:text-heading focus:ring-4 focus:ring-neutral-secondary-strong font-medium leading-5 text-sm px-4 py-2.5 focus:outline-none">Invoice</a>
|
|
208
195
|
</li>
|
|
209
196
|
</ul>
|
|
210
|
-
|
|
197
|
+
```
|
|
211
198
|
|
|
212
199
|
## Tabs with icons
|
|
213
200
|
|
|
214
201
|
This example can be used to show a list of tabs with icons from our [SVG icons](https://flowbite.com/icons/).
|
|
215
202
|
|
|
216
|
-
|
|
203
|
+
```html
|
|
217
204
|
|
|
218
205
|
<div class="sm:hidden">
|
|
219
206
|
<label for="tabs-icons" class="sr-only">Select your country</label>
|
|
@@ -250,11 +237,9 @@ This example can be used to show a list of tabs with icons from our [SVG icons](
|
|
|
250
237
|
</a>
|
|
251
238
|
</li>
|
|
252
239
|
</ul>
|
|
253
|
-
|
|
240
|
+
```
|
|
241
|
+
|
|
254
242
|
|
|
255
|
-
<div class="mt-8 -mb-5">
|
|
256
|
-
{{< requires_js >}}
|
|
257
|
-
</div>
|
|
258
243
|
|
|
259
244
|
## Interactive tabs
|
|
260
245
|
|
|
@@ -268,7 +253,7 @@ Apply the `role="tabpanel"` data attribute to every tab content element and set
|
|
|
268
253
|
|
|
269
254
|
You can use multiple tab components on a single page but make sure that the id's are different.
|
|
270
255
|
|
|
271
|
-
|
|
256
|
+
```html
|
|
272
257
|
|
|
273
258
|
<div class="mb-4 border-b border-default">
|
|
274
259
|
<ul class="flex flex-wrap -mb-px text-sm font-medium text-center" id="default-tab" data-tabs-toggle="#default-tab-content" role="tablist">
|
|
@@ -300,13 +285,13 @@ You can use multiple tab components on a single page but make sure that the id's
|
|
|
300
285
|
<p class="text-sm text-body">This is some placeholder content the <strong class="font-medium text-heading">Contacts tab's associated content</strong>. Clicking another tab will toggle the visibility of this one for the next. The tab JavaScript swaps classes to control the content visibility and styling.</p>
|
|
301
286
|
</div>
|
|
302
287
|
</div>
|
|
303
|
-
|
|
288
|
+
```
|
|
304
289
|
|
|
305
290
|
## Active tab style
|
|
306
291
|
|
|
307
292
|
Use the `data-tabs-active-classes` and the `data-tabs-inactive-classes` to set the active and inactive tab Tailwind CSS classes. In this example we set the active classes to the purple color instead of blue.
|
|
308
293
|
|
|
309
|
-
|
|
294
|
+
```html
|
|
310
295
|
|
|
311
296
|
<div class="mb-4 border-b border-default">
|
|
312
297
|
<ul class="flex flex-wrap -mb-px text-sm font-medium text-center" id="default-styled-tab" data-tabs-toggle="#default-styled-tab-content" data-tabs-active-classes="text-purple hover:text-purple border-purple" data-tabs-inactive-classes="dark:border-transparent text-body hover:text-fg-brand border-default hover:border-brand" role="tablist">
|
|
@@ -338,7 +323,7 @@ Use the `data-tabs-active-classes` and the `data-tabs-inactive-classes` to set t
|
|
|
338
323
|
<p class="text-sm text-body">This is some placeholder content the <strong class="font-medium text-heading">Contacts tab's associated content</strong>. Clicking another tab will toggle the visibility of this one for the next. The tab JavaScript swaps classes to control the content visibility and styling.</p>
|
|
339
324
|
</div>
|
|
340
325
|
</div>
|
|
341
|
-
|
|
326
|
+
```
|
|
342
327
|
|
|
343
328
|
## JavaScript behaviour
|
|
344
329
|
|
|
@@ -546,7 +531,7 @@ Check out the following example to learn how to initialize and manipulate a Tabs
|
|
|
546
531
|
|
|
547
532
|
First of all, create an array of objects that contains the id, trigger element, and content element of each tab, set the active tab based on the id, and optionally set a callback function after a new tab has been shown.
|
|
548
533
|
|
|
549
|
-
|
|
534
|
+
```javascript
|
|
550
535
|
const tabsElement = document.getElementById('tabs-example');
|
|
551
536
|
|
|
552
537
|
// create an array of objects with the id, trigger element (eg. button), and the content element
|
|
@@ -590,11 +575,11 @@ const instanceOptions = {
|
|
|
590
575
|
id: 'tabs-example',
|
|
591
576
|
override: true
|
|
592
577
|
};
|
|
593
|
-
|
|
578
|
+
```
|
|
594
579
|
|
|
595
580
|
Create a new Tabs object based on the parameters we've previously set.
|
|
596
581
|
|
|
597
|
-
|
|
582
|
+
```javascript
|
|
598
583
|
import { Tabs } from 'flowbite';
|
|
599
584
|
|
|
600
585
|
/*
|
|
@@ -604,11 +589,11 @@ import { Tabs } from 'flowbite';
|
|
|
604
589
|
* instanceOptions (optional)
|
|
605
590
|
*/
|
|
606
591
|
const tabs = new Tabs(tabsElement, tabElements, options, instanceOptions);
|
|
607
|
-
|
|
592
|
+
```
|
|
608
593
|
|
|
609
594
|
Lastly, you can now use the methods on the Tabs object to show another tab element, get a tab element based on the id, or get the current active tab element.
|
|
610
595
|
|
|
611
|
-
|
|
596
|
+
```javascript
|
|
612
597
|
// shows another tab element
|
|
613
598
|
tabs.show('dashboard');
|
|
614
599
|
|
|
@@ -617,13 +602,13 @@ tabs.getTab('contacts');
|
|
|
617
602
|
|
|
618
603
|
// get the current active tab object
|
|
619
604
|
tabs.getActiveTab();
|
|
620
|
-
|
|
605
|
+
```
|
|
621
606
|
|
|
622
607
|
### HTML Markup
|
|
623
608
|
|
|
624
609
|
You can use this HTML code as an example for the JavaScript code from above.
|
|
625
610
|
|
|
626
|
-
|
|
611
|
+
```html
|
|
627
612
|
<div class="mb-4 border-b border-default dark:border-gray-700">
|
|
628
613
|
<ul class="flex flex-wrap -mb-px text-sm font-medium text-center text-body dark:text-gray-400" id="tabs-example" role="tablist">
|
|
629
614
|
<li class="me-2" role="presentation">
|
|
@@ -738,15 +723,15 @@ You can use this HTML code as an example for the JavaScript code from above.
|
|
|
738
723
|
</p>
|
|
739
724
|
</div>
|
|
740
725
|
</div>
|
|
741
|
-
|
|
726
|
+
```
|
|
742
727
|
|
|
743
728
|
### TypeScript
|
|
744
729
|
|
|
745
|
-
If you're using the
|
|
730
|
+
If you're using the TypeScript configuration from Flowbite then you can import the types for the Tabs class, parameters and its options.
|
|
746
731
|
|
|
747
732
|
Here's an example that applies the types from Flowbite to the code above:
|
|
748
733
|
|
|
749
|
-
|
|
734
|
+
```typescript
|
|
750
735
|
import { Tabs } from 'flowbite';
|
|
751
736
|
import type { TabsOptions, TabsInterface, TabItem } from 'flowbite';
|
|
752
737
|
import type { InstanceOptions } from 'flowbite';
|
|
@@ -805,4 +790,4 @@ const tabs: TabsInterface = new Tabs(tabsElement, tabElements, options, instance
|
|
|
805
790
|
|
|
806
791
|
// open tab item based on id
|
|
807
792
|
tabs.show('contacts');
|
|
808
|
-
|
|
793
|
+
```
|
|
@@ -1,16 +1,3 @@
|
|
|
1
|
-
---
|
|
2
|
-
layout: docs
|
|
3
|
-
title: Tailwind CSS Timeline - Flowbite
|
|
4
|
-
description: Get started with the responsive timeline component to show data in a chronological order with support for multiple styles, sizes, and variants
|
|
5
|
-
group: components
|
|
6
|
-
toc: true
|
|
7
|
-
|
|
8
|
-
previous: Tabs
|
|
9
|
-
previousLink: components/tabs/
|
|
10
|
-
next: Toast
|
|
11
|
-
nextLink: components/toast/
|
|
12
|
-
---
|
|
13
|
-
|
|
14
1
|
The timeline component can be used to show series of data in a chronological order for use cases such as activity feeds, user actions, application updates, and more. Get started with multiple vertical timeline styles built with the utility classes from Tailwind CSS and Flowbite.
|
|
15
2
|
|
|
16
3
|
## Default timeline
|
|
@@ -19,7 +6,7 @@ Use this responsive Tailwind CSS timeline component to show a series of data ent
|
|
|
19
6
|
|
|
20
7
|
Optionally, you can also add a CTA button to any of the timeline elements.
|
|
21
8
|
|
|
22
|
-
|
|
9
|
+
```html
|
|
23
10
|
<ol class="relative border-s border-default">
|
|
24
11
|
<li class="mb-10 ms-4">
|
|
25
12
|
<div class="absolute w-3 h-3 bg-neutral-quaternary rounded-full mt-1.5 -start-1.5 border border-buffer"></div>
|
|
@@ -45,13 +32,13 @@ Optionally, you can also add a CTA button to any of the timeline elements.
|
|
|
45
32
|
</li>
|
|
46
33
|
</ol>
|
|
47
34
|
|
|
48
|
-
|
|
35
|
+
```
|
|
49
36
|
|
|
50
37
|
## Vertical timeline
|
|
51
38
|
|
|
52
39
|
Use this vertical timeline component with icons and badges to show a more advanced set of data.
|
|
53
40
|
|
|
54
|
-
|
|
41
|
+
```html
|
|
55
42
|
<ol class="relative border-s border-default">
|
|
56
43
|
<li class="mb-10 ms-6">
|
|
57
44
|
<span class="absolute flex items-center justify-center w-6 h-6 bg-brand-softer rounded-full -start-3 ring-8 ring-buffer">
|
|
@@ -83,13 +70,13 @@ Use this vertical timeline component with icons and badges to show a more advanc
|
|
|
83
70
|
</li>
|
|
84
71
|
</ol>
|
|
85
72
|
|
|
86
|
-
|
|
73
|
+
```
|
|
87
74
|
|
|
88
75
|
## Stepper timeline
|
|
89
76
|
|
|
90
77
|
Use this horizontally aligned timeline component to show a series of data in a chronological order.
|
|
91
78
|
|
|
92
|
-
|
|
79
|
+
```html
|
|
93
80
|
<ol class="items-center sm:flex">
|
|
94
81
|
<li class="relative mb-6 sm:mb-0">
|
|
95
82
|
<div class="flex items-center">
|
|
@@ -135,13 +122,13 @@ Use this horizontally aligned timeline component to show a series of data in a c
|
|
|
135
122
|
</li>
|
|
136
123
|
</ol>
|
|
137
124
|
|
|
138
|
-
|
|
125
|
+
```
|
|
139
126
|
|
|
140
127
|
## Activity log
|
|
141
128
|
|
|
142
129
|
This component can be used to show the timline of a user's activity history inside your application by using an avatar, datetime, description, and links to specific pages.
|
|
143
130
|
|
|
144
|
-
|
|
131
|
+
```html
|
|
145
132
|
<ol class="relative border-s border-default">
|
|
146
133
|
<li class="mb-10 ms-6">
|
|
147
134
|
<span class="absolute flex items-center justify-center w-6 h-6 rounded-full -start-3 ring-8 ring-buffer">
|
|
@@ -182,13 +169,13 @@ This component can be used to show the timline of a user's activity history insi
|
|
|
182
169
|
</li>
|
|
183
170
|
</ol>
|
|
184
171
|
|
|
185
|
-
|
|
172
|
+
```
|
|
186
173
|
|
|
187
174
|
## Grouped timeline
|
|
188
175
|
|
|
189
176
|
Use this component to group multiple data entries inside a single date and show elements like the avatar, title, description, tag and link to a relevant page.
|
|
190
177
|
|
|
191
|
-
|
|
178
|
+
```html
|
|
192
179
|
<div class="p-5 bg-neutral-secondary-soft border border-default rounded-base mb-4">
|
|
193
180
|
<time class="text-lg font-semibold text-heading">January 15th, 2025</time>
|
|
194
181
|
<ol class="mt-3 divide-y divide-default">
|
|
@@ -301,4 +288,4 @@ Use this component to group multiple data entries inside a single date and show
|
|
|
301
288
|
</li>
|
|
302
289
|
</ol>
|
|
303
290
|
</div>
|
|
304
|
-
|
|
291
|
+
```
|
package/data/components/toast.md
CHANGED
|
@@ -1,24 +1,10 @@
|
|
|
1
|
-
---
|
|
2
|
-
layout: docs
|
|
3
|
-
title: Tailwind CSS Toast - Flowbite
|
|
4
|
-
description: Push notifications to your users using the toast component and choose from multiple sizes, colors, styles, and positions
|
|
5
|
-
group: components
|
|
6
|
-
requires_js: true
|
|
7
|
-
toc: true
|
|
8
|
-
|
|
9
|
-
previous: Timeline
|
|
10
|
-
previousLink: components/timeline/
|
|
11
|
-
next: Tooltips
|
|
12
|
-
nextLink: components/tooltips/
|
|
13
|
-
---
|
|
14
|
-
|
|
15
1
|
The toast component can be used to enhance your website's interactivity by pushing notifications to your visitors. You can choose from multiple styles, colors, sizes, and positions and even dismiss the component by using the `data-dismiss-target` data attribute from Flowbite.
|
|
16
2
|
|
|
17
3
|
## Default toast
|
|
18
4
|
|
|
19
5
|
Use this simple toast component with an icon, message, and dismissible close button to show alert messages to your website visitors. Make sure that you set the correct id for the `data-dismiss-target` data attribute to enable the dismissible feature.
|
|
20
6
|
|
|
21
|
-
|
|
7
|
+
```html
|
|
22
8
|
|
|
23
9
|
<div id="toast-default" class="flex items-center w-full max-w-xs p-4 text-body bg-neutral-primary-soft rounded-base shadow-xs border border-default" role="alert">
|
|
24
10
|
<svg class="w-6 h-6 text-fg-brand" aria-hidden="true" xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="none" viewBox="0 0 24 24"><path stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M18.122 17.645a7.185 7.185 0 0 1-2.656 2.495 7.06 7.06 0 0 1-3.52.853 6.617 6.617 0 0 1-3.306-.718 6.73 6.73 0 0 1-2.54-2.266c-2.672-4.57.287-8.846.887-9.668A4.448 4.448 0 0 0 8.07 6.31 4.49 4.49 0 0 0 7.997 4c1.284.965 6.43 3.258 5.525 10.631 1.496-1.136 2.7-3.046 2.846-6.216 1.43 1.061 3.985 5.462 1.754 9.23Z"/></svg>
|
|
@@ -29,13 +15,13 @@ Use this simple toast component with an icon, message, and dismissible close but
|
|
|
29
15
|
</button>
|
|
30
16
|
</div>
|
|
31
17
|
|
|
32
|
-
|
|
18
|
+
```
|
|
33
19
|
|
|
34
20
|
## Colors
|
|
35
21
|
|
|
36
22
|
Use these contextual toast components to show success, danger, or warning alert messages to your users.
|
|
37
23
|
|
|
38
|
-
|
|
24
|
+
```html
|
|
39
25
|
|
|
40
26
|
<div id="toast-success" class="flex items-center w-full max-w-sm p-4 text-body bg-neutral-primary-soft rounded-base shadow-xs border border-default" role="alert">
|
|
41
27
|
<div class="inline-flex items-center justify-center shrink-0 w-7 h-7 text-fg-success bg-success-soft rounded">
|
|
@@ -71,13 +57,13 @@ Use these contextual toast components to show success, danger, or warning alert
|
|
|
71
57
|
</button>
|
|
72
58
|
</div>
|
|
73
59
|
|
|
74
|
-
|
|
60
|
+
```
|
|
75
61
|
|
|
76
62
|
## Simple toast
|
|
77
63
|
|
|
78
64
|
This component can be used to show simple messages and notifications without the use of a close button.
|
|
79
65
|
|
|
80
|
-
|
|
66
|
+
```html
|
|
81
67
|
|
|
82
68
|
<div id="toast-simple" class="flex items-center w-full max-w-sm p-4 text-body bg-neutral-primary-soft rounded-base shadow-xs border border-default" role="alert">
|
|
83
69
|
<svg class="w-5 h-5 text-fg-brand" aria-hidden="true" xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="none" viewBox="0 0 24 24"><path stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="m12 18-7 3 7-18 7 18-7-3Zm0 0v-5"/></svg>
|
|
@@ -87,13 +73,13 @@ This component can be used to show simple messages and notifications without the
|
|
|
87
73
|
<svg class="w-5 h-5" aria-hidden="true" xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="none" viewBox="0 0 24 24"><path stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18 17.94 6M18 18 6.06 6"/></svg>
|
|
88
74
|
</button>
|
|
89
75
|
</div>
|
|
90
|
-
|
|
76
|
+
```
|
|
91
77
|
|
|
92
78
|
## Undo button
|
|
93
79
|
|
|
94
80
|
Use this toast component to also show an "undo" button to reverse the action of the user.
|
|
95
81
|
|
|
96
|
-
|
|
82
|
+
```html
|
|
97
83
|
|
|
98
84
|
<div id="toast-undo" class="flex items-center w-full max-w-xs p-4 text-body bg-neutral-primary-soft rounded-base shadow-xs border border-default" role="alert">
|
|
99
85
|
<div class="text-sm font-normal">
|
|
@@ -108,13 +94,13 @@ Use this toast component to also show an "undo" button to reverse the action of
|
|
|
108
94
|
</div>
|
|
109
95
|
</div>
|
|
110
96
|
|
|
111
|
-
|
|
97
|
+
```
|
|
112
98
|
|
|
113
99
|
## Toast message
|
|
114
100
|
|
|
115
101
|
This component can be used to show messages and a CTA button when receiving chat messages, comment notifications, and other use cases.
|
|
116
102
|
|
|
117
|
-
|
|
103
|
+
```html
|
|
118
104
|
|
|
119
105
|
<div id="toast-message-cta" class="relative flex items-center w-full max-w-xs p-4 text-body bg-neutral-primary-soft rounded-base shadow-xs border border-default" role="alert">
|
|
120
106
|
<div class="flex">
|
|
@@ -133,13 +119,13 @@ This component can be used to show messages and a CTA button when receiving chat
|
|
|
133
119
|
</button>
|
|
134
120
|
</div>
|
|
135
121
|
</div>
|
|
136
|
-
|
|
122
|
+
```
|
|
137
123
|
|
|
138
124
|
## Push notification
|
|
139
125
|
|
|
140
126
|
This component can be used to show notifications for an action from another user such as posting a comment, receiving a like, being tagged. You can show an avatar, icon, message, and the time of the notification.
|
|
141
127
|
|
|
142
|
-
|
|
128
|
+
```html
|
|
143
129
|
|
|
144
130
|
<div id="toast-notification" class="w-full space-y-4 max-w-xs p-3 text-body bg-neutral-primary-soft rounded-base shadow-xs border border-default" role="alert">
|
|
145
131
|
<div class="flex items-center bg-neutral-tertiary py-2 px-2.5 rounded">
|
|
@@ -164,13 +150,13 @@ This component can be used to show notifications for an action from another user
|
|
|
164
150
|
</div>
|
|
165
151
|
</div>
|
|
166
152
|
|
|
167
|
-
|
|
153
|
+
```
|
|
168
154
|
|
|
169
155
|
## Interactive toast
|
|
170
156
|
|
|
171
157
|
Use this interactive toast component to encourage users to make a certain action such as updating to the latest software version. You can set an icon, message, and two CTA buttons.
|
|
172
158
|
|
|
173
|
-
|
|
159
|
+
```html
|
|
174
160
|
|
|
175
161
|
<div id="toast-interactive" class="w-full space-y-4 max-w-xs p-3 text-body bg-neutral-primary-soft rounded-base shadow-xs border border-default" role="alert">
|
|
176
162
|
<div class="flex">
|
|
@@ -192,13 +178,13 @@ Use this interactive toast component to encourage users to make a certain action
|
|
|
192
178
|
</div>
|
|
193
179
|
</div>
|
|
194
180
|
|
|
195
|
-
|
|
181
|
+
```
|
|
196
182
|
|
|
197
183
|
## Toast illustration
|
|
198
184
|
|
|
199
185
|
This example can be used to show a notification as a toast component with an illustration.
|
|
200
186
|
|
|
201
|
-
|
|
187
|
+
```html
|
|
202
188
|
|
|
203
189
|
<div id="toast-illustration" class="w-full space-y-4 max-w-sm p-3 text-body bg-neutral-primary-soft rounded-base shadow-xs border border-default" role="alert">
|
|
204
190
|
<div class="flex items-start">
|
|
@@ -218,13 +204,13 @@ This example can be used to show a notification as a toast component with an ill
|
|
|
218
204
|
</div>
|
|
219
205
|
</div>
|
|
220
206
|
|
|
221
|
-
|
|
207
|
+
```
|
|
222
208
|
|
|
223
209
|
## Toast progress bar
|
|
224
210
|
|
|
225
211
|
Use this example to show a toast component that is dismissble with a progress bar.
|
|
226
212
|
|
|
227
|
-
|
|
213
|
+
```html
|
|
228
214
|
|
|
229
215
|
<div id="toast-interactive" class="w-full space-y-4 max-w-xs p-4 text-body bg-neutral-primary-soft rounded-base shadow-xs border border-default" role="alert">
|
|
230
216
|
<div class="inline-flex items-center justify-center shrink-0 w-9 h-9 text-fg-brand bg-brand-softer rounded">
|
|
@@ -249,13 +235,13 @@ Use this example to show a toast component that is dismissble with a progress ba
|
|
|
249
235
|
</div>
|
|
250
236
|
</div>
|
|
251
237
|
|
|
252
|
-
|
|
238
|
+
```
|
|
253
239
|
|
|
254
240
|
## Toast danger alert
|
|
255
241
|
|
|
256
242
|
Use this example to show an alert to your users inside a toast component with a description.
|
|
257
243
|
|
|
258
|
-
|
|
244
|
+
```html
|
|
259
245
|
|
|
260
246
|
<div id="toast-danger" class="w-full max-w-xs p-4 mb-4 text-sm text-fg-danger-strong rounded-base bg-danger-soft border border-danger-subtle" role="alert">
|
|
261
247
|
<h3 class="font-semibold">Whoops! Something went wrong</h3>
|
|
@@ -273,13 +259,13 @@ Use this example to show an alert to your users inside a toast component with a
|
|
|
273
259
|
</div>
|
|
274
260
|
</div>
|
|
275
261
|
|
|
276
|
-
|
|
262
|
+
```
|
|
277
263
|
|
|
278
264
|
## Toast warning alert
|
|
279
265
|
|
|
280
266
|
This example can be used to warn users before they perform a certain action inside a toast component.
|
|
281
267
|
|
|
282
|
-
|
|
268
|
+
```html
|
|
283
269
|
|
|
284
270
|
<div id="toast-warning" class="w-full max-w-md p-4 mb-4 text-sm text-fg-warning rounded-base bg-warning-soft border border-warning-subtle" role="alert">
|
|
285
271
|
<div class="flex items-center justify-between">
|
|
@@ -307,7 +293,7 @@ This example can be used to warn users before they perform a certain action insi
|
|
|
307
293
|
</div>
|
|
308
294
|
</div>
|
|
309
295
|
|
|
310
|
-
|
|
296
|
+
```
|
|
311
297
|
|
|
312
298
|
## Positioning
|
|
313
299
|
|
|
@@ -318,7 +304,7 @@ Use the `fixed` class from Tailwind CSS to position these toast components relat
|
|
|
318
304
|
- Bottom left: `fixed bottom-5 left-5`
|
|
319
305
|
- Bottom right: `fixed bottom-5 right-5`
|
|
320
306
|
|
|
321
|
-
|
|
307
|
+
```html
|
|
322
308
|
|
|
323
309
|
<div id="toast-top-left" class="fixed flex items-center w-full max-w-xs p-4 text-body bg-neutral-primary-soft rounded-base shadow-xs border border-default top-5 start-5" role="alert">
|
|
324
310
|
<div class="text-sm font-normal">Top left positioning.</div>
|
|
@@ -332,10 +318,10 @@ Use the `fixed` class from Tailwind CSS to position these toast components relat
|
|
|
332
318
|
<div id="toast-bottom-left" class="fixed flex items-center w-full max-w-xs p-4 text-body bg-neutral-primary-soft rounded-base shadow-xs border border-default bottom-5 start-5" role="alert">
|
|
333
319
|
<div class="text-sm font-normal">Bottom left positioning.</div>
|
|
334
320
|
</div>
|
|
335
|
-
|
|
321
|
+
```
|
|
336
322
|
|
|
337
323
|
You can set your own distance for the `top-*|right-*|bottom-*|left-*` positioning classes.
|
|
338
324
|
|
|
339
325
|
## JavaScript behaviour
|
|
340
326
|
|
|
341
|
-
Please check out the
|
|
327
|
+
Please check out the Dismiss object documentation to learn how to programmatically work with the toast component directly from JavaScript.
|