Tabs

Panels that switch with no script, or links to pages.

IzzyBlazor.Tabs in the IzzyBlazor.Core package, generated from the 0.1.0-alpha.17 assembly and its doc comments.

Properties (10)

@bind-Selectedstring? (computed) @bind: Interactive only

The selected tab's Value. Defaults to the first tab that isn't disabled.

Labelstring?

The tab list's (or the TabLinks' nav's) name for screen readers, such as "Account settings".

QueryKeystring?

Keeps the selected tab in the URL under this query-string key, such as tab: a link to ?tab=billing opens that tab, and with JavaScript switching tabs updates the URL.

VariantTabsVariant = TabsVariant.Line

How the tabs look. Defaults to TabsVariant.Line.

SizeControlSize = ControlSize.Md

Tab height and text size, shared with buttons and fields. Defaults to ControlSize.Md.

FullWidthbool = false

Stretches the tabs to share the full width (or, vertical, the list's width).

ContentPaddingResponsive<int>Responsive

Padding on every side of each panel, in spacing steps, in place of the default space above and below (the default has none at the sides). 0 lets content such as a table run edge to edge. A Tab can set its own.

OrientationOrientation = Orientation.Horizontal

A row above the panels (the default), or a column beside them from 640px up. Vertical tabs stay a scrolling row on phones, where a column would crowd the content.

Idstring?

The element id; tab and panel ids build on it. Generated when not set.

ChildContentRenderFragment?

The Tabs.

Item props (from LayoutItemBase)

MarginResponsive<int>Responsive

Margin on all sides, in spacing steps (-16 to 16; one step = 4px).

MarginXResponsive<int>Responsive

Horizontal margin. When set, replaces Margin on this axis.

MarginYResponsive<int>Responsive

Vertical margin. When set, replaces Margin on this axis.

MarginTopResponsive<int>Responsive

Top margin. When set, replaces MarginY and Margin on this side.

MarginBottomResponsive<int>Responsive

Bottom margin. When set, replaces MarginY and Margin on this side.

MarginStartResponsive<int>Responsive

Margin at the start (left in left-to-right text, right in right-to-left). Replaces MarginX and Margin on this side.

MarginEndResponsive<int>Responsive

Margin at the end (right in left-to-right text, left in right-to-left). Replaces MarginX and Margin on this side.

WidthResponsive<Length>Responsive

Width.

MinWidthResponsive<Length>Responsive

Minimum width.

MaxWidthResponsive<Length>Responsive

Maximum width.

Growbool = false

Whether to grow into free space inside a Stack, Row or Column: <Box Grow>.

Shrinkbool = true

Whether to shrink when space is short inside a Stack, Row or Column. Defaults to true; Shrink="false" keeps the size.

BasisResponsive<Length>Responsive

Starting size inside a Stack, before growing or shrinking.

AlignSelfResponsive<Align>Responsive

Alignment across the parent's direction, overriding the parent's Align for this component only, such as a button lined up with the bottom of labeled fields in a Row.

ColSpanResponsive<int>Responsive

How many columns it spans in a Form or Fieldset with Columns, or a Grid; GridSpan.Full for the whole row. Never more than the columns shown, so a form that narrows to one column needs no breakpoints.

NewRowbool = false

Starts a new row in a Form or Fieldset with Columns, or a Grid, leaving the rest of the row before it empty.

Common props (from IzzyComponentBase)

Classstring?

Extra CSS classes, merged after the component's own classes.

Stylestring?

Inline style, appended after the component's generated custom properties.

HiddenFromBreakpoint?

Hides the component from this breakpoint up, such as a menu button only phones need.

VisibleFromBreakpoint?

Shows the component only from this breakpoint up, such as header links for wide screens.

Events (0)

No events.

Parts (2)

Components written inside Tabs, documented here with it.

`Tab`

One tab of a Tabs: its label goes in the tab list and its content in a panel. All panels are rendered; CSS shows the selected one.

Labelstring required

The label in the tab list.

Valuestring? (computed)

The value that identifies this tab in @bind-Selected and in the URL. Defaults to the title in lower case with dashes, such as billing-history. Tabs that end up with the same value get -2, -3... added.

IconIconData?

An icon before the label.

Badgestring?

A small count or label after the title, such as "3".

Disabledbool = false

Shows the tab but stops it being selected.

ContentPaddingResponsive<int>Responsive

Padding inside this tab's panel, in spacing steps, in place of the tabs' ContentPadding.

ChildContentRenderFragment?

The panel content.

Plus 4 common props.

`TabLink`

A tab that's a link to its own page, for sections split across routes (/settings/profile, /settings/billing). A Tabs holding TabLinks renders a nav of real links: no script, no panels, and the tab for the current page is marked from the URL on the server. Don't mix TabLinks with Tabs that have panels.

Hrefstring required

The page the tab links to.

Labelstring required

The tab's text.

IconIconData?

An icon before the label.

Badgestring?

A small count or label after the text, such as "3".

Disabledbool = false

Shows the tab but not as a link.

MatchNavLinkMatch = NavLinkMatch.Prefix

How the current URL must match Href for the tab to be selected. Prefix (the default) also selects it on pages below it. A link with a query string (?tab=billing) is selected only when the current query string is the same, and then a tab whose link has no query isn't, so tabs for one page told apart by the query select one at a time.

Currentbool?Added in 0.1.0-alpha.16

Marks the tab current (true) or not (false) whatever the URL, for a choice the page knows from elsewhere, such as a cookie. Unset (the default): from the URL, by Match, unless another tab is set current. A current tab set this way has aria-current="true" (a choice, not necessarily this page); a disabled tab is never current.

Types (3)

`ControlSize`

enum

The height of interactive controls. Shared by buttons and form fields, so a button and an input of the same size line up in a row.

ControlSize values
Value	Description
`Sm`	32px tall, small text.
`Md`	36px tall (the default).
`Lg`	44px tall, large text. For touch-first and marketing pages.

`Orientation`

enum

Whether items run across or down.

Orientation values
Value	Description
`Vertical`	Top to bottom.
`Horizontal`	Side by side, wrapping when space runs out.

`TabsVariant`

enum

How Tabs draw their tab list.

TabsVariant values
Value	Description
`Line`	A line under the list, with the selected tab underlined (the default).
`Soft`	The selected tab gets a soft accent background.
`Segmented`	A segmented control: the tabs sit in a tray and the selected one is raised.