diff --git a/ROADMAP.md b/ROADMAP.md index be67dd7..9788f53 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -1,4 +1,4 @@ -# Blazor UI Kit Roadmap � Bootstrap Italia Components +# Blazor UI Kit Roadmap — Bootstrap Italia Components This document outlines the development roadmap for a Blazor UI kit library implementing the official [Bootstrap Italia](https://italia.github.io/bootstrap-italia/docs) components. The project targets .NET 9. diff --git a/docs/README.md b/docs/README.md index 3a77d84..a935133 100644 --- a/docs/README.md +++ b/docs/README.md @@ -76,6 +76,13 @@ Pagination control for navigating large data sets across multiple pages. - Optional jump-to-page input and total-items summary - Customizable previous/next buttons and alignment +#### [Toolbar](components/toolbar.md) +Navigation toolbar for grouping icon-based action items. +- Horizontal and vertical orientations +- Three size variants (default, medium, small) +- Badge counts and labels on items +- `BitToolbarDivider` sub-component for visual separation + ### Form Components BitBlazor provides a comprehensive set of form components that integrate seamlessly with ASP.NET Core Blazor's form system and Bootstrap Italia styling. diff --git a/docs/components/toolbar.md b/docs/components/toolbar.md new file mode 100644 index 0000000..eeae6f5 --- /dev/null +++ b/docs/components/toolbar.md @@ -0,0 +1,190 @@ +# BitToolbar + +The `BitToolbar` component represents a [toolbar using Bootstrap Italia styles](https://italia.github.io/bootstrap-italia/docs/menu-di-navigazione/toolbar/). + +## Namespace + +```csharp +BitBlazor.Components +``` + +## Description + +The Toolbar component provides a navigation bar for grouping and displaying icon-based action items. It supports horizontal and vertical orientations, three size variants, optional badge counts, and a divider sub-component. Items support an active and a disabled state, and are compatible with both static (SSR) and interactive rendering modes. + +Each `BitToolbarItem` can be used as a navigation link (via `Href`), a click handler (via `OnClick`), or both at the same time. When both are provided, `OnClick` takes precedence in interactive rendering while `Href` remains available for browser-native behaviors such as right-click → Open in new tab. In static SSR rendering, `Href` is the only navigation mechanism. + +## Components + +| Component | Description | +|-----------|-------------| +| `BitToolbar` | Root container that renders a `