# BootstrapBlazor

> 基于 Bootstrap 5 的企业级 Blazor UI 组件库

## 快速开始

```bash
dotnet add package BootstrapBlazor
```

### 配置

```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/` 目录下都有独立的文档文件。
使用 `components/{ComponentName}.txt` 获取详细的 API 信息。

### 基类

- [BootstrapComponentBase](components/BootstrapComponentBase.txt) - Bootstrap Blazor 组件基类
- [BootstrapModuleComponentBase](components/BootstrapModuleComponentBase.txt) - BootstrapBlazor JavaScript 隔离基类
- [IdComponentBase](components/IdComponentBase.txt) - 自动生成客户端 ID 组件基类

### 工具类组件

- [ReconnectorContent](components/ReconnectorContent.txt) - ReconnectorContent 组件
- [RenderTemplate](components/RenderTemplate.txt) - RenderTemplate 组件
- [Script](components/Script.txt) - Script 组件
- [ThemeProvider](components/ThemeProvider.txt) - ThemeProvider 主题提供者组件

### 布局组件

- [BootstrapBlazorRoot](components/BootstrapBlazorRoot.txt) - BootstrapBlazorRoot 组件
- [Divider](components/Divider.txt) - Divider 组件
- [Footer](components/Footer.txt) - Footer 组件
- [Layout](components/Layout.txt) - Layout 组件
- [LayoutSplitBar](components/LayoutSplitBar.txt) - LayoutSplitBar 组件
- [Navbar](components/Navbar.txt) - Navbar 组件
- [Row](components/Row.txt) - Row 组件
- [Scroll](components/Scroll.txt) - Scroll 组件
- [Split](components/Split.txt) - Split 组件
- [Stack](components/Stack.txt) - Stack 组件
- [Toolbar](components/Toolbar.txt) - Toolbar 组件用于显示工具栏内容
- [ToolbarButtonGroup](components/ToolbarButtonGroup.txt) - ToolbarButtonGroup 组件用于在工具栏中添加一组按钮
- [ToolbarItem](components/ToolbarItem.txt) - ToolbarItem 组件用于在工具栏中添加子组件
- [ToolbarSeparator](components/ToolbarSeparator.txt) - ToolbarSeparator 组件用于在工具栏中添加分隔符
- [ToolbarSpace](components/ToolbarSpace.txt) - ToolbarSpace 组件用于在工具栏中添加空白空间

### 导航组件

- [Anchor](components/Anchor.txt) - Anchor 组件部分类
- [AnchorLink](components/AnchorLink.txt) - AnchorLink 组件
- [Breadcrumb](components/Breadcrumb.txt) - Breadcrumb 组件
- [Dropdown](components/Dropdown.txt) - Dropdown 下拉框组件
- [DropdownItem](components/DropdownItem.txt) - DropdownItem 组件
- [GotoNavigator](components/GotoNavigator.txt) - GotoNavigator 组件用于分页跳转导航
- [GoTop](components/GoTop.txt) - GoTop 组件
- [Logout](components/Logout.txt) - ListView 组件基类
- [Menu](components/Menu.txt) - Menu 组件基类
- [MenuLink](components/MenuLink.txt) - MenuLink 组件内部封装 NavLink 组件
- [Nav](components/Nav.txt) - NavMenu 组件基类
- [NavbarBrand](components/NavbarBrand.txt) - NavBrand 组件
- [NavbarCollapse](components/NavbarCollapse.txt) - NavbarCollapse 组件用于在导航栏中适配响应式布局
- [NavbarDropdown](components/NavbarDropdown.txt) - NavbarDropdown 组件用于在导航栏中创建下拉菜单
- [NavbarDropdownItem](components/NavbarDropdownItem.txt) - NavbarDropdownItem 组件用于在导航栏下拉菜单中创建菜单项
- [NavbarGroup](components/NavbarGroup.txt) - NavbarGroup 组件用于在导航栏中分组
- [NavbarItem](components/NavbarItem.txt) - NavbarItem 组件用于在导航栏中添加子组件
- [NavbarLink](components/NavbarLink.txt) - NavbarLink 组件用于在导航栏中添加链接
- [NavbarToggleButton](components/NavbarToggleButton.txt) - NavbarToggleButton 组件
- [Pagination](components/Pagination.txt) - Pagination 组件
- [PaginationItem](components/PaginationItem.txt) - PaginationItem 组件用于分页组件中的单个页码项
- [RibbonTab](components/RibbonTab.txt) - RibbonTab 组件
- [RibbonTabHeader](components/RibbonTabHeader.txt) - Header 组件
- [SideMenu](components/SideMenu.txt) - SideMenu 组件
- [Step](components/Step.txt) - Step 组件类
- [SubCascader](components/SubCascader.txt) - SubCascader 组件
- [SubMenu](components/SubMenu.txt) - 子菜单组件内部使用不推荐直接使用此组件
- [Tab](components/Tab.txt) - Tab 组件
- [TabLink](components/TabLink.txt) - 表示标签页组件内的链接
- [TabToolbarButton](components/TabToolbarButton.txt) - TabToolbarButton 组件
- [TopMenu](components/TopMenu.txt) - 顶栏菜单

### 表单组件

- [AutoComplete](components/AutoComplete.txt) - AutoComplete 组件
- [AutoFill](components/AutoFill.txt) - AutoFill 组件
- [BootstrapInput](components/BootstrapInput.txt) - BootstrapInput 组件
- [BootstrapInputBase](components/BootstrapInputBase.txt) - Input 组件基类
- [BootstrapInputEventBase](components/BootstrapInputEventBase.txt) - 输入框基类
- [BootstrapInputGroup](components/BootstrapInputGroup.txt) - BootstrapInputGroup 组件
- [BootstrapInputGroupIcon](components/BootstrapInputGroupIcon.txt) - BootstrapInputGroupIcon 组件
- [BootstrapInputNumber](components/BootstrapInputNumber.txt) - BootstrapInputNumber 组件
- [BootstrapInputNumberBase](components/BootstrapInputNumberBase.txt) - BootstrapInputNumber 基类
- [Button](components/Button.txt) - Button 按钮组件
- [ButtonBase](components/ButtonBase.txt) - Button 按钮组件
- [Cascader](components/Cascader.txt) - Cascader 组件实现类
- [Checkbox](components/Checkbox.txt) - Checkbox 组件
- [CheckboxList](components/CheckboxList.txt) - CheckboxList 组件基类
- [CheckboxListGeneric](components/CheckboxListGeneric.txt) - CheckboxList 组件基类
- [ClockPicker](components/ClockPicker.txt) - ClockPicker 组件
- [ColorPicker](components/ColorPicker.txt) - ColorPicker 颜色拾取器组件
- [DatePickerBody](components/DatePickerBody.txt) - 日期选择组件
- [DatePickerCell](components/DatePickerCell.txt) - DateTimePickerCell 组件
- [DateTimePicker](components/DateTimePicker.txt) - DateTimePicker 组件
- [DateTimeRange](components/DateTimeRange.txt) - DateTimeRange 时间范围组件
- [EditorForm](components/EditorForm.txt) - 编辑表单基类
- [FloatingLabel](components/FloatingLabel.txt) - FloatingLabel 组件
- [IpAddress](components/IpAddress.txt) - IpAddress 组件
- [ListGroup](components/ListGroup.txt) - ListGroup 组件
- [MultiSelect](components/MultiSelect.txt) - 多选组件
- [MultiSelectGeneric](components/MultiSelectGeneric.txt) - 多选泛型组件
- [NullSwitch](components/NullSwitch.txt) - 可为空布尔值组件
- [OtpInput](components/OtpInput.txt) - OTP 输入组件
- [PopoverCompleteBase](components/PopoverCompleteBase.txt) - 弹窗可悬浮组件基类
- [PopoverDropdownBase](components/PopoverDropdownBase.txt)
- [PopoverSelectBase](components/PopoverSelectBase.txt) - PopoverSelectBase 基类
- [PulseButton](components/PulseButton.txt) - PulseButton 按钮组件
- [Radio](components/Radio.txt) - Radio 单选框组件
- [RadioList](components/RadioList.txt) - 单选框组合组件
- [RadioListGeneric](components/RadioListGeneric.txt) - 单选框组合组件
- [Rate](components/Rate.txt) - Rate 组件
- [SearchForm](components/SearchForm.txt) - 搜索表单类
- [Select](components/Select.txt) - Select 组件
- [SelectBase](components/SelectBase.txt) - SelectBase 组件基类
- [SelectGeneric](components/SelectGeneric.txt) - Select 泛型组件实现类
- [SelectObject](components/SelectObject.txt) - Select 组件实现类
- [SelectTable](components/SelectTable.txt) - 下拉表格组件实现类
- [SelectTree](components/SelectTree.txt) - Select 组件实现类
- [SimpleSelectBase](components/SimpleSelectBase.txt) - SimpleSelectBase 组件基类
- [Slider](components/Slider.txt) - 滑块组件
- [Switch](components/Switch.txt) - Switch 组件
- [Textarea](components/Textarea.txt) - Textarea 文本域组件
- [TimePicker](components/TimePicker.txt) - TimePicker 组件
- [TimePickerCell](components/TimePickerCell.txt) - 时间选择滚轮单元组件
- [Toggle](components/Toggle.txt) - Toggle 组件
- [ToggleBase](components/ToggleBase.txt) - Toggle 开关组件基类
- [ToggleButton](components/ToggleButton.txt) - Toggle Button 按钮组件
- [TooltipWrapperBase](components/TooltipWrapperBase.txt) - TooltipWrapperBase 基类
- [Transfer](components/Transfer.txt) - Transfer 组件（穿梭框）
- [TransferPanel](components/TransferPanel.txt) - TransferPanel 穿梭框面板组件
- [ValidateBase](components/ValidateBase.txt) - 支持客户端验证的文本框基类
- [ValidateForm](components/ValidateForm.txt) - ValidateForm 组件类

### 上传组件

- [AvatarUpload](components/AvatarUpload.txt) - 头像上传组件
- [ButtonUpload](components/ButtonUpload.txt) - 按钮上传组件
- [CardUpload](components/CardUpload.txt) - CardUpload 组件
- [DropUpload](components/DropUpload.txt) - DropUpload 组件
- [FileListUploadBase](components/FileListUploadBase.txt) - FileListUploadBase 基类
- [InputUpload](components/InputUpload.txt) - InputUpload 组件
- [UploadBase](components/UploadBase.txt) - Upload 组件基类
- [UploadPreviewList](components/UploadPreviewList.txt) - UploadPreviewList 组件

### 表格组件

- [Table](components/Table.txt) - Table 组件基类
- [TableAdvancedSortDialog](components/TableAdvancedSortDialog.txt) - Table 高级排序弹窗的内容组件
- [TableExtensionButton](components/TableExtensionButton.txt) - TableExtensionButton 表格扩展按钮类
- [TableFooterCell](components/TableFooterCell.txt) - TableFooterCell 组件
- [TableToolbar](components/TableToolbar.txt) - Table Toolbar 组件

### 数据组件

- [Affix](components/Affix.txt) - Affix 固钉组件
- [Avatar](components/Avatar.txt) - Avatar 头像框组件
- [Badge](components/Badge.txt) - Badge 徽章组件
- [BootstrapBlazorIcon](components/BootstrapBlazorIcon.txt) - Icon 组件
- [BootstrapLabel](components/BootstrapLabel.txt) - BootstrapLabel 组件
- [BootstrapLabelSetting](components/BootstrapLabelSetting.txt) - BootstrapLabelSetting 组件类
- [Calendar](components/Calendar.txt) - 日历框组件
- [Camera](components/Camera.txt) - Camera 组件
- [Captcha](components/Captcha.txt) - Captcha 组件
- [Card](components/Card.txt) - Card 组件
- [Carousel](components/Carousel.txt) - Carousel 组件
- [Circle](components/Circle.txt)
- [CircleBase](components/CircleBase.txt) - Circle 组件基类
- [Collapse](components/Collapse.txt) - Collapse 组件
- [CountUp](components/CountUp.txt) - CountUp 组件
- [Display](components/Display.txt) - Display 组件
- [DisplayBase](components/DisplayBase.txt) - 显示组件基类
- [DropdownWidget](components/DropdownWidget.txt) - DropdownWidget 组件
- [Empty](components/Empty.txt) - Empty 组件
- [FileIcon](components/FileIcon.txt) - Icon 图标组件
- [GroupBox](components/GroupBox.txt) - GroupBox 组件
- [Handwritten](components/Handwritten.txt) - Handwritten 手写签名
- [IFrame](components/IFrame.txt) - Frame component encapsulates the Html iframe element
- [ImagePreviewer](components/ImagePreviewer.txt) - 图片预览组件
- [ImageViewer](components/ImageViewer.txt) - Image 组件
- [Link](components/Link.txt) - Link 组件
- [ListView](components/ListView.txt) - ListView 组件基类
- [LoadMore](components/LoadMore.txt) - 加载更多组件
- [LogoutLink](components/LogoutLink.txt)
- [PrintButton](components/PrintButton.txt) - PrintButton 打印按钮
- [QueryBuilder](components/QueryBuilder.txt) - QueryBuilder 组件
- [QueryGroup](components/QueryGroup.txt) - QueryGroup 组件
- [Repeater](components/Repeater.txt) - Repeat 组件
- [Search](components/Search.txt) - 搜索组件
- [Segmented](components/Segmented.txt) - Segmented 组件
- [ShieldBadge](components/ShieldBadge.txt) - ShieldBadge 徽章组件
- [SpeechWave](components/SpeechWave.txt) - 语音识别波形图组件
- [SvgIcon](components/SvgIcon.txt) - SvgIcon 组件
- [SwitchButton](components/SwitchButton.txt) - Switch Button
- [Tag](components/Tag.txt) - Tag 组件
- [Timeline](components/Timeline.txt) - 时间线组件基类
- [Transition](components/Transition.txt) - Transition 动画组件
- [Tree](components/Tree.txt) - Tree 组件
- [TreeView](components/TreeView.txt) - Tree 组件
- [TreeViewRow](components/TreeViewRow.txt) - TreeViewRow 组件
- [TreeViewToolbarEditButton](components/TreeViewToolbarEditButton.txt) - TreeViewToolbarEditButton 组件
- [Typed](components/Typed.txt) - Typed 组件类
- [Waterfall](components/Waterfall.txt) - Waterfall 组件
- [Watermark](components/Watermark.txt) - Watermark 组件

### 通知组件

- [Alert](components/Alert.txt) - Alert 组件
- [AlertBase](components/AlertBase.txt) - Alert 警告框组件
- [Console](components/Console.txt) - 控制台消息组件
- [ConsoleLogger](components/ConsoleLogger.txt) - Logger 组件
- [ContextMenu](components/ContextMenu.txt) - ContextMenu 组件
- [ContextMenuZone](components/ContextMenuZone.txt) - ContextMenuZone 组件
- [DialButton](components/DialButton.txt) - 拨号按钮组件
- [Dialog](components/Dialog.txt) - Dialog 组件
- [DialogBase](components/DialogBase.txt) - Dialog 组件基类
- [Drawer](components/Drawer.txt) - Drawer 抽屉组件
- [Dropzone](components/Dropzone.txt) - 拖拽容器
- [EditDialog](components/EditDialog.txt) - 编辑弹窗组件
- [FlipClock](components/FlipClock.txt) - FlipClock 组件
- [FullScreenButton](components/FullScreenButton.txt) - FullScreenButton 组件
- [IconDialog](components/IconDialog.txt) - IconDialog Component
- [IntersectionObserver](components/IntersectionObserver.txt) - 可见检测组件
- [IntersectionObserverItem](components/IntersectionObserverItem.txt) - 检测交叉组件子组件
- [Light](components/Light.txt) - 指示灯组件
- [Marquee](components/Marquee.txt) - Marquee 字幕滚动组件
- [Mask](components/Mask.txt) - Mask 组件
- [Message](components/Message.txt) - Message 组件
- [Modal](components/Modal.txt) - Modal 组件
- [ModalDialog](components/ModalDialog.txt) - ModalDialog 组件
- [NetworkMonitorIndicator](components/NetworkMonitorIndicator.txt) - NetworkMonitorIndicator 组件用于显示网络监控指示器，支持自定义弹出窗口设置
- [PopConfirmButton](components/PopConfirmButton.txt) - PopConfirmButton 组件
- [PopConfirmButtonBase](components/PopConfirmButtonBase.txt) - 确认弹窗按钮组件
- [PopConfirmButtonContent](components/PopConfirmButtonContent.txt) - Popover Confirm 组件
- [Popover](components/Popover.txt) - Popover 弹出窗组件
- [Progress](components/Progress.txt) - Progress 组件
- [ResultDialogFooter](components/ResultDialogFooter.txt) - ResultDialog 对话框类
- [SearchDialog](components/SearchDialog.txt) - 查询弹窗组件
- [SlideButton](components/SlideButton.txt) - SlideButton 组件
- [Spinner](components/Spinner.txt) - Spinner 组件基类
- [SweetAlert](components/SweetAlert.txt) - SweetAlert component
- [SweetAlertBody](components/SweetAlertBody.txt) - SweetAlertBody 组件
- [Timer](components/Timer.txt) - Timer 组件
- [Toast](components/Toast.txt) - Toast 组件
- [ToastContainer](components/ToastContainer.txt) - Toast 弹出窗容器组件
- [Tooltip](components/Tooltip.txt) - Tooltip 组件

### 过滤器组件

- [BoolFilter](components/BoolFilter.txt) - BoolFilter 组件用于表格列的布尔值过滤
- [DateTimeFilter](components/DateTimeFilter.txt) - DateTime 过滤组件
- [EnumFilter](components/EnumFilter.txt) - 枚举过滤组件
- [FilterBase](components/FilterBase.txt) - 过滤器基类
- [FilterButton](components/FilterButton.txt) - FilterButton 组件
- [FilterLogicItem](components/FilterLogicItem.txt) - FilterLogicItem 组件用于选择过滤条件的逻辑运算符
- [FilterProvider](components/FilterProvider.txt) - FilterProvider 组件
- [LookupFilter](components/LookupFilter.txt) - Lookup 过滤器
- [MultiFilter](components/MultiFilter.txt) - 多选过滤器组件
- [MultipleFilterBase](components/MultipleFilterBase.txt) - 多重过滤器基类
- [MultiSelectFilter](components/MultiSelectFilter.txt) - 多项选择下拉框过滤组件
- [NotSupportFilter](components/NotSupportFilter.txt) - NotSupportFilter 组件
- [NumberFilter](components/NumberFilter.txt) - NumberFilter 组件
- [RegexFilter](components/RegexFilter.txt) - RegexFilter 组件用于表格列的正则表达式过滤
- [StringFilter](components/StringFilter.txt) - StringFilter 组件
- [TableColumnFilter](components/TableColumnFilter.txt) - TableColumnFilter 组件

### 骨架屏组件

- [SkeletonAvatar](components/SkeletonAvatar.txt) - 骨架屏头像组件
- [SkeletonBase](components/SkeletonBase.txt) - 骨架屏组件基类
- [SkeletonTable](components/SkeletonTable.txt) - 表格骨架屏组件
- [SkeletonTree](components/SkeletonTree.txt) - 树状组件骨架屏组件

## 内置服务

通过依赖注入使用的服务，每个服务在 `components/` 目录下都有独立的文档文件。

- [AjaxService](components/AjaxService.txt) - Ajax 服务类
- [ClipboardService](components/ClipboardService.txt) - 粘贴板服务
- [DialogService](components/DialogService.txt) - Dialog 组件服务
- [DownloadService](components/DownloadService.txt) - 文件下载服务类
- [DrawerService](components/DrawerService.txt) - Toast 弹出窗服务类
- [EyeDropperService](components/EyeDropperService.txt) - EyeDropper 服务用于屏幕吸色
- [FullScreenService](components/FullScreenService.txt) - FullScreen 服务
- [IAudioDevice](components/IAudioDevice.txt) - Audio Media Device Interface
- [IBluetooth](components/IBluetooth.txt) - 蓝牙服务接口
- [IBrowserFingerService](components/IBrowserFingerService.txt) - 浏览器指纹接口
- [ICalendarFestivals](components/ICalendarFestivals.txt) - 节日接口
- [ICalendarHolidays](components/ICalendarHolidays.txt) - 休假接口
- [IComponentHtmlRenderer](components/IComponentHtmlRenderer.txt) - IComponentHtmlRenderer 接口
- [IConnectionService](components/IConnectionService.txt) - 当前链接服务
- [IGeoLocationService](components/IGeoLocationService.txt) - 设备地理位置服务
- [IHtml2Image](components/IHtml2Image.txt) - IHtml2Image 接口
- [IHtml2Pdf](components/IHtml2Pdf.txt) - Html export PDF service
- [IIpLocatorProvider](components/IIpLocatorProvider.txt) - IP 地址定位服务接口
- [ILookupService](components/ILookupService.txt) - ILookupService 接口
- [INetworkMonitorService](components/INetworkMonitorService.txt) - Defines a service for monitoring network state and retrie...
- [IPinyinService](components/IPinyinService.txt) - 拼音服务接口
- [ISerialService](components/ISerialService.txt) - ISerialService 串口通讯服务
- [ITableExport](components/ITableExport.txt) - Table 组件 Excel 导出接口
- [ITotpService](components/ITotpService.txt) - ITotpService interface
- [IVersionService](components/IVersionService.txt) - 组件版本号服务
- [IVideoDevice](components/IVideoDevice.txt) - Video Media Device Interface
- [IZipArchiveService](components/IZipArchiveService.txt) - Zip 归档服务
- [MaskService](components/MaskService.txt) - MaskService 遮罩服务
- [MessageService](components/MessageService.txt) - MessageService 消息弹窗服务
- [NotificationService](components/NotificationService.txt) - 浏览器通知服务
- [PrintService](components/PrintService.txt) - Print 服务
- [SwalService](components/SwalService.txt) - SweetAlert 弹窗服务
- [TitleService](components/TitleService.txt) - Title 服务
- [ToastService](components/ToastService.txt) - Toast 弹出窗服务类
- [WebClientService](components/WebClientService.txt) - WebClient 服务类
- [WebSpeechService](components/WebSpeechService.txt) - Web Speech 服务

## 源码参考

GitHub 仓库: https://github.com/dotnetcore/BootstrapBlazor

当文档不足时，请查阅源码：

### 文件结构

```
https://raw.githubusercontent.com/dotnetcore/BootstrapBlazor/refs/heads/main//src/BootstrapBlazor/Components/{ComponentName}/
├── {Component}.razor          # Razor 模板
├── {Component}.razor.cs       # 组件逻辑与参数
├── {Component}Base.cs         # 基类（如果存在）
├── {Component}Option.cs       # 配置选项
└── {Component}Service.cs      # 服务类（Dialog、Toast 等）
```

### 示例

```
https://raw.githubusercontent.com/dotnetcore/BootstrapBlazor/refs/heads/main/src/BootstrapBlazor.Server/Components/Samples/{ComponentName}s.razor
```

### 读取组件参数

查找带有 `[Parameter]` 特性的属性：

```csharp
/// <summary>
/// 获得/设置 是否显示工具栏
/// </summary>
[Parameter]
public bool ShowToolbar { get; set; }
```

---
生成时间: 2026-08-07
组件总数: 232
服务总数: 36
仓库地址: https://github.com/dotnetcore/BootstrapBlazor