Skip to main content

Blazor Bootstrap v4.0.0

· 4 min read
Vikram Reddy

We are thrilled to release Blazor Bootstrap v4.0.0 — a major milestone that introduces powerful new components, significant enhancements, and important breaking changes. This release targets .NET 8, .NET 9, and .NET 10.

⚠️ Breaking Changes​

.NET 6.0 support dropped​

.NET 6 has reached end-of-life. Blazor Bootstrap 4.0.0 supports .NET 8, .NET 9, and .NET 10 only. Please upgrade your application before updating to this version.

Charts moved to BlazorExpress.ChartJS​

All chart components (BarChart, LineChart, DoughnutChart, PieChart, PolarAreaChart, RadarChart, ScatterChart) have been extracted from BlazorBootstrap and are now provided by the dedicated BlazorExpress.ChartJS package.

Migration steps:

  1. Install the BlazorExpress.ChartJS NuGet package.
  2. Replace @using BlazorBootstrap chart references with the BlazorExpress.ChartJS namespace.
  3. Load the BlazorExpress.ChartJS browser scripts.
  4. Migrate any chart API calls to the BlazorExpress.ChartJS API.

See the migration guide and the BlazorExpress.ChartJS GitHub repo for full details.

✨ New Components​

RichTextEditor​

A full-featured rich text editor component built on Quill.js, supporting text formatting, bullet/numbered lists, links, and image uploads.

FileInput & DragAndDropFileInput​

Two new file selection components for modern file upload experiences:

  • FileInput — standard file picker with multi-select support.

  • DragAndDropFileInput — drop-zone style file picker with drag-and-drop support.

  • PR #1293

  • Docs: File Input | Drag & Drop File Input

SplitView​

A resizable split-panel layout component that lets users drag a divider to resize two side-by-side or top-and-bottom panes.

OTP Input​

A one-time password (OTP) input component providing individual digit boxes and auto-advance behavior — ideal for verification code flows.

🚀 Enhancements​

Charts — Data Point Click Event​

Chart components (via BlazorExpress.ChartJS) now support a data point click event, enabling interactive drill-down scenarios.

PdfViewer​

  • Download support: Users can now download the currently viewed PDF directly from the viewer (PR #1288, #1277).
  • Manual Zoom: Manual zoom control added (PR #956).
  • Password prompt improvements: Improved handling of cancellation in the password prompt (PR #1255).

ToastService​

  • Async overloads added for ShowAsync to simplify fire-and-forget toast usage (PR #1231).
  • New constructor ToastMessage(ToastType) for quick toast creation (PR #993).

ConfirmDialog​

  • Auto-focus on the Yes button now handled natively in Blazor for improved accessibility (PR #1259, #1260, #1261).
  • Dropdown now closes when clicking outside the component (PR #1251).

EnumInput​

  • Enum values can now display localized or custom display names using resource-backed attributes, reducing boilerplate in forms.

Layout — Sticky Header​

  • Added a CSS custom property (--bb-sticky-header-z-index) to allow applications to control the sticky header z-index without overriding internal styles (PR #1311).

Google Map​

  • Enhanced demo, script loading, and marker customization options (PR #1292).

CurrencyInput​

  • Copy/Paste KeyDown handling improved (PR #1205).

Grid​

  • Fixed rendering issues, page size reset bug (PR #1203).

Sidebar / Sidebar2​

  • Improved behavior on mobile devices (PR #1203).

SortableList​

  • Refined grab cursor for sortable list items and handles (PR #1253).

Tooltip​

  • Fixed typo in TooltipColor.Secondary CSS class name (PR #1257).

🐛 Bug Fixes​

  • Grid: Rendering issues and page size reset bug fixed (#1203).
  • SortableList: Grab cursor now correctly shown on items and handles (#1253).
  • Dropdown: Closes when clicking outside (#1251).
  • PdfViewer: Password prompt cancellation handled gracefully (#1255).
  • Tooltip: TooltipColor.Secondary CSS class name typo fixed (#1257).

📚 Documentation & API Metadata​

Extensive API documentation metadata attributes ([Parameter], [EditorRequired], summary XML docs) have been added to all major components in this release, improving IntelliSense support and auto-generated API reference pages:

  • Accordion, Alert, Badge, Breadcrumb, Button, Callout, Card
  • Carousel, Collapse, ConfirmDialog
  • Dropdown
  • GoogleMap, Markdown, Modal
  • Offcanvas, Pagination, PdfViewer
  • Ribbon, Sidebar, Sidebar2
  • SortableList, Spinner, Tabs, TextInput, ToastService, Toasts, Tooltips

🔧 Upgrade Notes​

See the Upgrade to v4.0.0 guide for detailed migration instructions.