1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
//! # dioxus-bootstrap-css
//!
//! Type-safe Bootstrap 5.3 components for [Dioxus](https://dioxuslabs.com/).
//!
//! This crate provides a 1-to-1 mapping of every Bootstrap 5.3 component as Dioxus RSX
//! components. All interactive behaviors (modals, dropdowns, accordions, carousels, etc.)
//! are driven by Dioxus signals — **zero JavaScript required**.
//!
//! ## Quick Start
//!
//! ```rust,no_run
//! use dioxus::prelude::*;
//! use dioxus_bootstrap_css::prelude::*;
//!
//! fn app() -> Element {
//! let theme = use_signal(|| Theme::Dark);
//! rsx! {
//! ThemeProvider { theme }
//! BootstrapHead {}
//! Container {
//! h1 { "Hello Bootstrap!" }
//! Button { color: Color::Primary, "Click me" }
//! }
//! }
//! }
//! ```
//!
//! ## Bootstrap HTML → Dioxus RSX
//!
//! | Bootstrap HTML | Dioxus RSX |
//! |---|---|
//! | `<div class="container">` | `Container { }` |
//! | `<div class="row"><div class="col-md-6">` | `Row { Col { md: ColumnSize::Span(6) } }` |
//! | `<button class="btn btn-primary">` | `Button { color: Color::Primary }` |
//! | `<a class="btn btn-primary" href="/page">` | `Button { color: Color::Primary, href: "/page" }` |
//! | `<div class="card"><div class="card-body">` | `Card { body: rsx! { } }` |
//! | `<div class="alert alert-danger">` | `Alert { color: Color::Danger }` |
//! | `<span class="badge text-bg-success">` | `Badge { color: Color::Success }` |
//! | `<i class="bi bi-search">` | `Icon { name: "search" }` |
//! | `<div class="modal">` + JS | `Modal { show: signal, title: "..." }` |
//! | `<div class="dropdown">` + JS | `Dropdown { open: signal, toggle: rsx! { }, menu: rsx! { } }` |
//! | `<div class="carousel">` + JS | `Carousel { active: signal, slides: vec![...] }` |
//! | `<div class="accordion">` + JS | `Accordion { open: signal }` |
//! | `<div class="toast">` + JS | `Toast { show: signal, title: "..." }` |
//! | `<div class="offcanvas">` + JS | `Offcanvas { show: signal, title: "..." }` |
//! | `<div class="tooltip">` + JS | `Tooltip { text: "...", children }` |
//! | `<div class="popover">` + JS | `Popover { title: "...", body: rsx! { }, children }` |
//! | `<html data-bs-theme="dark">` | `ThemeProvider { theme: signal }` |
//! | `<nav><ol class="breadcrumb">` | `Breadcrumb { BreadcrumbItem { } }` |
//! | `<ul class="list-group">` | `ListGroup { ListGroupItem { } }` |
//! | `<div class="input-group">` | `InputGroup { InputGroupText { }, Input { } }` |
//! | `<div class="progress">` | `Progress { ProgressBar { value: 50.0 } }` |
//! | `<div class="spinner-border">` | `Spinner { }` |
//! | `data-bs-spy="scroll"` | `Scrollspy { target: "body", active: signal }` |
//!
//! ## Modules
//!
//! Every Bootstrap component has its own module. Import everything via the [`prelude`].
/// Prelude — import everything with `use dioxus_bootstrap_css::prelude::*`.