# BootstrapBlazor

> Enterprise-class Blazor UI component library based on Bootstrap 5

## Quick Start

```bash
dotnet add package BootstrapBlazor
```

### Configuration

```csharp
// Program.cs
builder.Services.AddBootstrapBlazor();
```

```razor
@* _Imports.razor *@
@using BootstrapBlazor.Components
```

```html
<!-- App.razor or _Host.cshtml -->
<link href="_content/BootstrapBlazor/css/bootstrap.blazor.bundle.min.css" rel="stylesheet" />
<script src="_content/BootstrapBlazor/js/bootstrap.blazor.bundle.min.js"></script>
```

## Components

Each component has its own documentation file in the `components/` directory.
Use `components/{ComponentName}.txt` to get detailed API information.

### Buttons

Button, button group, dropdown button, split button

- [Button](components/Button.txt) - Button 按钮组件
- [ButtonBase](components/ButtonBase.txt) - Button 按钮组件
- [ButtonUpload](components/ButtonUpload.txt) - 按钮上传组件 <para>ButtonUpload Component</para>
- [DialButton](components/DialButton.txt) - 拨号按钮组件
- [FilterButton](components/FilterButton.txt) - FilterButton 组件
- [FullScreenButton](components/FullScreenButton.txt) - FullScreenButton 组件
- [GoTop](components/GoTop.txt) - GoTop 组件
- [NavbarToggleButton](components/NavbarToggleButton.txt) - NavbarToggleButton 组件
- [PopConfirmButton](components/PopConfirmButton.txt) - PopConfirmButton 组件
- [PopConfirmButtonBase](components/PopConfirmButtonBase.txt) - 确认弹窗按钮组件
- [PopConfirmButtonContent](components/PopConfirmButtonContent.txt) - Popover Confirm 组件
- [PrintButton](components/PrintButton.txt) - PrintButton 打印按钮
- [PulseButton](components/PulseButton.txt) - PulseButton 按钮组件
- [SlideButton](components/SlideButton.txt) - SlideButton 组件
- [SwitchButton](components/SwitchButton.txt) - Switch Button
- [TabToolbarButton](components/TabToolbarButton.txt) - TabToolbarButton component
- [ToggleButton](components/ToggleButton.txt) - Toggle Button 按钮组件
- [ToolbarButtonGroup](components/ToolbarButtonGroup.txt) - ToolbarGroup 组件用于在工具栏中添加一组按钮
- [TreeViewToolbarEditButton](components/TreeViewToolbarEditButton.txt) - TreeViewToolbarEditButton component

### Containers

Card, collapse, group box, split, layout

- [Card](components/Card.txt) - Card 组件
- [CardUpload](components/CardUpload.txt) - CardUpload component
- [Collapse](components/Collapse.txt) - Collapse 组件
- [GroupBox](components/GroupBox.txt)

### Dialogs & Feedback

Modal, drawer, dialog service, message, toast

- [DialogBase](components/DialogBase.txt) - Dialog 组件基类
- [Drawer](components/Drawer.txt) - Drawer component
- [EditDialog](components/EditDialog.txt) - 编辑弹窗组件
- [IconDialog](components/IconDialog.txt) - IconDialog Component
- [Message](components/Message.txt) - Message 组件
- [Modal](components/Modal.txt) - Modal component
- [ModalDialog](components/ModalDialog.txt) - ModalDialog 组件
- [ResultDialogFooter](components/ResultDialogFooter.txt) - ResultDialog 对话框类
- [SearchDialog](components/SearchDialog.txt) - 查询弹窗组件
- [Toast](components/Toast.txt) - ToastBox 组件
- [ToastContainer](components/ToastContainer.txt) - Toast 弹出窗组件

### Form Validation

ValidateForm, editor form, validation rules

- [EditorForm](components/EditorForm.txt) - 编辑表单基类
- [ValidateForm](components/ValidateForm.txt) - ValidateForm 组件类

### Form Inputs

Text input, number input, textarea, date picker

- [BootstrapInput](components/BootstrapInput.txt) - BootstrapInput 组件
- [BootstrapInputBase](components/BootstrapInputBase.txt) - Base class for BootstrapInput components
- [BootstrapInputEventBase](components/BootstrapInputEventBase.txt) - 输入框基类
- [BootstrapInputGroup](components/BootstrapInputGroup.txt) - BootstrapInputGroup 组件
- [BootstrapInputGroupIcon](components/BootstrapInputGroupIcon.txt)
- [BootstrapInputNumber](components/BootstrapInputNumber.txt) - An input component for editing numeric values. Supported ...
- [InputUpload](components/InputUpload.txt) - InputUpload 组件
- [OtpInput](components/OtpInput.txt) - OTP input component
- [Textarea](components/Textarea.txt) - Textarea component

### Navigation

Menu, tabs, breadcrumb, steps, pagination

- [Anchor](components/Anchor.txt) - Anchor 组件部分类
- [AnchorLink](components/AnchorLink.txt) - AnchorLink 组件
- [Breadcrumb](components/Breadcrumb.txt) - Breadcrumb 组件
- [ContextMenu](components/ContextMenu.txt) - ContextMenu 组件
- [ContextMenuZone](components/ContextMenuZone.txt) - ContextMenuZone 组件
- [GotoNavigator](components/GotoNavigator.txt)
- [Menu](components/Menu.txt) - Menu 组件基类
- [MenuLink](components/MenuLink.txt) - MenuLink 组件内部封装 NavLink 组件
- [Nav](components/Nav.txt) - NavMenu 组件基类
- [Navbar](components/Navbar.txt) - Navbar 组件
- [NavbarBrand](components/NavbarBrand.txt) - NavBrand 组件
- [NavbarCollapse](components/NavbarCollapse.txt) - NavbarCollapse 组件用于在导航栏中适配响应式布局
- [NavbarGroup](components/NavbarGroup.txt) - NavbarGroup 组件用于在导航栏中分组
- [NavbarItem](components/NavbarItem.txt) - NavbarItem 组件用于在导航栏中添加子组件
- [NavbarLink](components/NavbarLink.txt) - NavbarLink 组件用于在导航栏中添加链接
- [RibbonTab](components/RibbonTab.txt) - RibbonTab 组件
- [RibbonTabHeader](components/RibbonTabHeader.txt) - Header 组件
- [SideMenu](components/SideMenu.txt) - SideMenu 组件
- [SkeletonAvatar](components/SkeletonAvatar.txt)
- [Step](components/Step.txt) - Step 组件类
- [SubMenu](components/SubMenu.txt)
- [Tab](components/Tab.txt) - Tab component
- [TabLink](components/TabLink.txt) - Represents a link within a tab component.
- [TopMenu](components/TopMenu.txt) - 顶栏菜单

### Other Components

Miscellaneous components

- [Affix](components/Affix.txt) - Affix 固钉组件
- [Alert](components/Alert.txt) - Alert 组件
- [AlertBase](components/AlertBase.txt) - Alert 警告框组件
- [AutoFill](components/AutoFill.txt) - AutoFill component
- [Avatar](components/Avatar.txt) - Avatar 头像框组件
- [AvatarUpload](components/AvatarUpload.txt) - 头像上传组件 <para>AvatarUpload Component</para>
- [Badge](components/Badge.txt) - Badge component
- [BoolFilter](components/BoolFilter.txt) - BoolFilter component is used for boolean value filtering ...
- [BootstrapBlazorIcon](components/BootstrapBlazorIcon.txt) - Icon 组件
- [BootstrapBlazorRoot](components/BootstrapBlazorRoot.txt) - BootstrapBlazorRoot 组件
- [BootstrapComponentBase](components/BootstrapComponentBase.txt) - Bootstrap Blazor 组件基类
- [BootstrapLabel](components/BootstrapLabel.txt) - BootstrapLabel 组件
- [BootstrapLabelSetting](components/BootstrapLabelSetting.txt) - BootstrapLabelSetting 组件类
- [Calendar](components/Calendar.txt) - 日历框组件
- [Camera](components/Camera.txt) - Camera 组件
- [Captcha](components/Captcha.txt) - Captcha 组件
- [Carousel](components/Carousel.txt) - Carousel 组件
- [Checkbox](components/Checkbox.txt) - Checkbox 组件
- [CheckboxList](components/CheckboxList.txt) - CheckboxList 组件基类
- [CheckboxListGeneric](components/CheckboxListGeneric.txt) - CheckboxList 组件基类
- [Circle](components/Circle.txt)
- [CircleBase](components/CircleBase.txt) - Circle 组件基类
- [ClockPicker](components/ClockPicker.txt) - ClockPicker 组件
- [ColorPicker](components/ColorPicker.txt) - ColorPicker 颜色拾取器组件
- [Console](components/Console.txt) - 控制台消息组件
- [ConsoleLogger](components/ConsoleLogger.txt) - Logger 组件
- [CountUp](components/CountUp.txt) - CountUp 组件
- [DatePickerBody](components/DatePickerBody.txt) - 日期选择组件
- [DatePickerCell](components/DatePickerCell.txt) - DateTimePickerCell 组件
- [DateTimeFilter](components/DateTimeFilter.txt) - DateTime filter component
- [DateTimePicker](components/DateTimePicker.txt) - DateTimePicker 组件
- [DateTimeRange](components/DateTimeRange.txt) - DateTimeRange 时间范围组件
- [Display](components/Display.txt) - Display 组件
- [DisplayBase](components/DisplayBase.txt) - 显示组件基类
- [Divider](components/Divider.txt) - Divider 组件
- [DropUpload](components/DropUpload.txt) - DropUpload 组件
- [Dropzone](components/Dropzone.txt) - 拖拽容器
- [Empty](components/Empty.txt)
- [EnumFilter](components/EnumFilter.txt) - Enum filter component
- [FileIcon](components/FileIcon.txt) - Icon 图标组件
- [FileListUploadBase](components/FileListUploadBase.txt) - FileListUploadBase 基类
- [FilterBase](components/FilterBase.txt) - 过滤器基类
- [FilterLogicItem](components/FilterLogicItem.txt) - FilterLogicItem 组件用于选择过滤条件的逻辑运算符
- [FilterProvider](components/FilterProvider.txt) - FilterProvider component
- [FlipClock](components/FlipClock.txt) - FlipClock 组件
- [FloatingLabel](components/FloatingLabel.txt) - FloatingLabel 组件
- [Footer](components/Footer.txt) - Footer 组件
- [Handwritten](components/Handwritten.txt) - Handwritten 手写签名
- [IdComponentBase](components/IdComponentBase.txt) - 自动生成客户端 ID 组件基类
- [IFrame](components/IFrame.txt) - Frame component encapsulates the Html iframe element
- [ImagePreviewer](components/ImagePreviewer.txt) - 图片预览组件
- [ImageViewer](components/ImageViewer.txt) - Image 组件
- [IntersectionObserver](components/IntersectionObserver.txt) - 可见检测组件
- [IntersectionObserverItem](components/IntersectionObserverItem.txt) - 检测交叉组件子组件
- [Layout](components/Layout.txt) - Layout 组件
- [LayoutSplitBar](components/LayoutSplitBar.txt) - LayoutSidebar 组件
- [Light](components/Light.txt) - 指示灯组件
- [Link](components/Link.txt) - Link 组件
- [ListGroup](components/ListGroup.txt) - ListGroup 组件
- [ListView](components/ListView.txt) - ListView 组件基类
- [LoadMore](components/LoadMore.txt) - 加载更多组件
- [Logout](components/Logout.txt) - ListView 组件基类
- [LogoutLink](components/LogoutLink.txt)
- [Marquee](components/Marquee.txt) - Marquee 字幕滚动组件
- [MultiFilter](components/MultiFilter.txt) - 多选过滤器组件
- [NetworkMonitorIndicator](components/NetworkMonitorIndicator.txt) - Represents a network monitor indicator with customizable ...
- [NotSupportFilter](components/NotSupportFilter.txt) - NotSupportFilter component
- [NullSwitch](components/NullSwitch.txt) - 可为空布尔值组件
- [NumberFilter](components/NumberFilter.txt) - NumberFilter component
- [Pagination](components/Pagination.txt) - Pagination 组件
- [PaginationItem](components/PaginationItem.txt)
- [Popover](components/Popover.txt) - Popover 弹出窗组件
- [PopoverCompleteBase](components/PopoverCompleteBase.txt) - 弹窗可悬浮组件基类
- [Progress](components/Progress.txt) - Progress 组件
- [QueryBuilder](components/QueryBuilder.txt) - QueryBuilder 组件
- [QueryGroup](components/QueryGroup.txt) - QueryGroup 组件
- [Radio](components/Radio.txt) - Radio 单选框组件
- [RadioList](components/RadioList.txt) - 单选框组合组件
- [RadioListGeneric](components/RadioListGeneric.txt) - 单选框组合组件
- [Rate](components/Rate.txt) - Rate 组件
- [ReconnectorContent](components/ReconnectorContent.txt) - ReconnectorContent 组件
- [RenderTemplate](components/RenderTemplate.txt) - RenderTemplate component
- [Repeater](components/Repeater.txt) - Repeat 组件
- [Row](components/Row.txt) - Row 组件
- [Script](components/Script.txt) - Script 组件
- [Scroll](components/Scroll.txt) - Scroll 组件
- [Search](components/Search.txt) - Search component
- [Segmented](components/Segmented.txt) - Segmented 组件
- [ShieldBadge](components/ShieldBadge.txt) - ShieldBadge component
- [SkeletonBase](components/SkeletonBase.txt) - 骨架屏组件基类
- [Slider](components/Slider.txt) - Range 组件
- [SpeechWave](components/SpeechWave.txt) - 语音识别波形图组件
- [Spinner](components/Spinner.txt) - Spinner 组件基类
- [Split](components/Split.txt) - Split 组件
- [Stack](components/Stack.txt)
- [StringFilter](components/StringFilter.txt) - StringFilter component
- [SvgIcon](components/SvgIcon.txt) - SvgIcon 组件
- [SweetAlertBody](components/SweetAlertBody.txt)
- [Switch](components/Switch.txt)
- [ThemeProvider](components/ThemeProvider.txt) - ThemeProvider 组件
- [Timeline](components/Timeline.txt) - 时间线组件基类
- [TimePicker](components/TimePicker.txt) - TimePicker 组件
- [TimePickerCell](components/TimePickerCell.txt) - 时间选择滚轮单元组件
- [Timer](components/Timer.txt) - Timer 组件
- [Toggle](components/Toggle.txt)
- [ToggleBase](components/ToggleBase.txt) - Toggle 开关组件
- [Toolbar](components/Toolbar.txt) - Toolbar 组件用于显示工具栏内容
- [ToolbarItem](components/ToolbarItem.txt) - ToolbarItem 组件用于在工具栏中添加子组件
- [Tooltip](components/Tooltip.txt) - Tooltip 组件
- [TooltipWrapperBase](components/TooltipWrapperBase.txt) - TooltipWrapperBase 基类
- [Transition](components/Transition.txt) - Transition 动画组件
- [Typed](components/Typed.txt) - TypedJs 组件类
- [UploadBase](components/UploadBase.txt) - Upload 组件基类
- [UploadPreviewList](components/UploadPreviewList.txt) - UploadPreviewList component
- [ValidateBase](components/ValidateBase.txt) - 支持客户端验证的文本框基类
- [Waterfall](components/Waterfall.txt) - Waterfall 组件
- [Watermark](components/Watermark.txt) - Watermark 组件

### Selection Components

Select, multi-select, autocomplete, cascader, transfer

- [AutoComplete](components/AutoComplete.txt) - AutoComplete component
- [Cascader](components/Cascader.txt) - Cascader 组件实现类
- [Dropdown](components/Dropdown.txt) - Dropdown 下拉框组件
- [DropdownItem](components/DropdownItem.txt) - DropdownItem 组件
- [DropdownWidget](components/DropdownWidget.txt) - DropdownWidget 组件
- [MultiSelect](components/MultiSelect.txt) - MultiSelect component
- [MultiSelectFilter](components/MultiSelectFilter.txt) - 多项选择下拉框过滤组件
- [MultiSelectGeneric](components/MultiSelectGeneric.txt) - MultiSelectGeneric component
- [NavbarDropdown](components/NavbarDropdown.txt) - NavbarDropdown 组件用于在导航栏中创建下拉菜单
- [NavbarDropdownItem](components/NavbarDropdownItem.txt) - NavbarDropdownItem 组件用于在导航栏下拉菜单中创建菜单项
- [PopoverDropdownBase](components/PopoverDropdownBase.txt)
- [PopoverSelectBase](components/PopoverSelectBase.txt) - PopoverSelectBase 基类
- [Select](components/Select.txt) - Select component
- [SelectBase](components/SelectBase.txt) - SelectBase component base class
- [SelectGeneric](components/SelectGeneric.txt) - Select 泛型组件实现类
- [SelectObject](components/SelectObject.txt) - Select 组件实现类
- [SelectTree](components/SelectTree.txt) - Select 组件实现类
- [SimpleSelectBase](components/SimpleSelectBase.txt) - SimpleSelectBase component base class
- [SubCascader](components/SubCascader.txt) - SubCascader 组件
- [Transfer](components/Transfer.txt) - 穿梭框组件
- [TransferPanel](components/TransferPanel.txt) - TransferPanelBase 穿梭框面板组件

### Data Display - Table

Complex data table with sorting, filtering, paging, editing

- [SelectTable](components/SelectTable.txt) - 下拉表格组件实现类
- [SkeletonTable](components/SkeletonTable.txt) - 表格骨架屏组件
- [Table](components/Table.txt) - Table 组件基类
- [TableAdvancedSortDialog](components/TableAdvancedSortDialog.txt) - Table 高级排序弹窗的内容组件
- [TableColumnFilter](components/TableColumnFilter.txt) - TableFilter component
- [TableExtensionButton](components/TableExtensionButton.txt) - TableExtensionButton 表格扩展按钮类
- [TableFooterCell](components/TableFooterCell.txt) - TableFooterCell 组件
- [TableToolbar](components/TableToolbar.txt) - Table Toolbar 组件

### Tree Components

TreeView, tree select

- [SkeletonTree](components/SkeletonTree.txt) - 树状组件骨架屏组件
- [Tree](components/Tree.txt) - Tree 组件
- [TreeView](components/TreeView.txt) - Tree component
- [TreeViewRow](components/TreeViewRow.txt) - TreeViewRow component

## Source Code Reference

GitHub Repository: https://github.com/dotnetcore/BootstrapBlazor

When documentation is insufficient, consult the source code:

### File Structure

```
https://github.com/dotnetcore/BootstrapBlazor/blob/main/src/BootstrapBlazor/Components/{ComponentName}/
├── {Component}.razor          # Razor template
├── {Component}.razor.cs       # Component logic & parameters
├── {Component}Base.cs         # Base class (if exists)
├── {Component}Option.cs       # Configuration options
└── {Component}Service.cs      # Service class (Dialog, Toast, etc.)
```

### Examples

```
https://github.com/dotnetcore/BootstrapBlazor/blob/main/src/BootstrapBlazor.Server/Components/Samples/{ComponentName}s.razor
```

### Reading Component Parameters

Look for properties with `[Parameter]` attribute:

```csharp
/// <summary>
/// Gets or sets whether to show the toolbar
/// </summary>
[Parameter]
public bool ShowToolbar { get; set; }
```

---
Generated: 2026-01-16
Total Components: 219
Repository: https://github.com/dotnetcore/BootstrapBlazor/blob/main/