---
title: ToolbarItem
summary: API reference for ToolbarItem.
status: draft
owner: SAIF Documentation
last_reviewed: 2026-09-17
library: SAIF.Framework.Web.Mvc
reference_type: package
---

# ToolbarItem

Concrete `NavigationItem<ToolbarItem>` representing a single toolbar button or link; declares no additional members beyond those inherited from `NavigationItem<T>`.

## Purpose
- Concrete `NavigationItem<ToolbarItem>` representing a single toolbar button or link; declares no additional members beyond those inherited from `NavigationItem<T>`.

## Context
- Namespace: `SAIF.Web.Mvc.UI`
- Assembly/package: `SAIF.Framework.Web.Mvc (source-shipping NuGet package)`
- Kind: class

## Public members
_No public members are declared on this type._

## Inherited public members
| Member | Signature | Purpose |
| --- | --- | --- |
| ActionName | `public string ActionName { get; set; }` | Holds the MVC action name this toolbar item navigates to when it is rendered as an action link rather than a raw URL. |
| ControllerName | `public string ControllerName { get; set; }` | Holds the MVC controller name paired with `ActionName` for action-based navigation targets. |
| Enabled | `public bool Enabled { get; set; }` | Controls whether the item is rendered as clickable/enabled; defaults to `true` in the base constructor. |
| HtmlAttributes | `public IDictionary<string, object> HtmlAttributes { get; }` | Holds arbitrary HTML attributes merged onto the item's rendered element. |
| Id | `public string Id { get; set; }` | The DOM identifier assigned to the rendered item, used for client-side targeting and styling. |
| ImageHtmlAttributes | `public IDictionary<string, object> ImageHtmlAttributes { get; }` | Holds arbitrary HTML attributes merged onto the item's rendered image element, when one is used. |
| ImageUrl | `public string ImageUrl { get; set; }` | The URL of an icon/image to display alongside the item's label. |
| LinkHtmlAttributes | `public IDictionary<string, object> LinkHtmlAttributes { get; }` | Holds arbitrary HTML attributes merged onto the item's rendered link (`<a>`) element. |
| RouteName | `public string RouteName { get; set; }` | Holds the named-route target used for route-based navigation instead of `ActionName`/`ControllerName`. |
| RouteValues | `public RouteValueDictionary RouteValues { get; set; }` | Holds the route value dictionary supplied alongside `RouteName` when generating the navigation URL. |
| Text | `public string Text { get; set; }` | The display label rendered for the toolbar item. |
| Tooltip | `public string Tooltip { get; set; }` | The hover text (`title` attribute) rendered for the toolbar item. |
| Url | `public string Url { get; set; }` | A literal navigation URL used instead of action/route-based navigation. |
| Visible | `public bool Visible { get; set; }` | Controls whether the item is rendered at all; defaults to `true` in the base constructor. |

All members above are declared on `NavigationItem<T>` (constructed here as `NavigationItem<ToolbarItem>`) and are inherited unchanged by `ToolbarItem`.

## Behavioral notes
- All configurable state (id, text, tooltip, URL, visibility, enablement, html attributes) is inherited from `NavigationItem<ToolbarItem>`; the table above documents the full inherited surface directly on this page.

## Sources
- `src/Web.Mvc/UI/Toolbar/ToolbarItem.cs`