HtmlForgeX

API Reference

Class

TablerRow

Namespace HtmlForgeX
Assembly HtmlForgeX
Base Element

Defines a row in a Tabler Page Layout. When using the TablerRow, you can specify the row type. By default, the row type is set to Default, however when dealing with Page Layouts you usually should have both Deck and Cards. But for other purposes of layout such as within Card you should use the Default row type

Inheritance

Constructors

public TablerRow(params TablerRowType[] rowTypes) #

Initializes or configures TablerRow.

Parameters

rowTypes HtmlForgeX.TablerRowType[] requiredposition: 0

Methods

public TablerRow AlignItemsCenter() #
Returns: TablerRow
EditorBrowsable(2)

Aligns items to center vertically.

public TablerRow AlignItemsStretch() #
Returns: TablerRow
EditorBrowsable(2)

Stretches column items to equal height within this row (Bootstrap align-items-stretch). Useful when combining multiple panels/alerts/cards in the same row and you want uniform heights.

AutoFit 3 overloads
public TablerRow AutoFit(TablerCardWidth width, TablerRowPackingMode packing, Nullable<Int32> maxColumns = null) #
Returns: TablerRow
EditorBrowsable(2)

Auto fits items using CSS Grid with a minimum card width. For policy HardLimit, we fall back to TargetColumns(maxColumns, hardLimit: true) for predictable counts.

Parameters

minCardWidth System.String requiredposition: 0
maxColumns System.Nullable{System.Int32} = null requiredposition: 1
policy HtmlForgeX.TablerAutoFitPolicy = null optionalposition: 2
AutoFit(HtmlForgeX.TablerCardWidth width, System.Nullable{System.Int32} maxColumns, HtmlForgeX.TablerAutoFitPolicy policy) #

Auto fits items with a typed width preset (no raw CSS units required).

Parameters

width HtmlForgeX.TablerCardWidth required
maxColumns System.Nullable{System.Int32} required
policy HtmlForgeX.TablerAutoFitPolicy required
AutoFit(HtmlForgeX.TablerCardWidth width, HtmlForgeX.TablerRowPackingMode packing, System.Nullable{System.Int32} maxColumns) #

Auto-fit items using a typed width preset and a typed packing mode. Packing controls how widths are distributed across wrapped rows.

Parameters

width HtmlForgeX.TablerCardWidth required
packing HtmlForgeX.TablerRowPackingMode required
maxColumns System.Nullable{System.Int32} required
public TablerRow AutoFitEngine(TablerAutoFitEngine engine) #
Returns: TablerRow
EditorBrowsable(2)

Select the AutoFit rendering engine. Grid (default) gives equal-width tracks. Flex ensures the wrapped row fills (e.g., 3 + 2 → 50/50).

Parameters

engine HtmlForgeX.TablerAutoFitEngine requiredposition: 0
public TablerRow Density(TablerDensity density) #
Returns: TablerRow
EditorBrowsable(2)

Applies a responsive density preset using Bootstrap row-cols utilities. Works best when using default col columns (no explicit fixed widths). Also adjusts the row gutter to a sensible default per preset.

Parameters

density HtmlForgeX.TablerDensity requiredposition: 0
public TablerRow EqualHeights(Boolean enabled = true) #
Returns: TablerRow
EditorBrowsable(2)

Ensures all cards in this row stretch to the same height per grid line. Cards automatically fill the available height without per-card calls.

Parameters

enabled System.Boolean = true optionalposition: 0
FitViewport 2 overloads
public TablerRow FitViewport(Int32 minHeightPixels, TablerBreakpoint from = ExtraExtraLarge) #
Returns: TablerRow
EditorBrowsable(2)

Reserves a viewport-aware minimum height for cards in this row from the chosen breakpoint upward. Combine with Boolean) or TablerRowSizingMode) when the row should both match heights and fill more of the visible screen.

Parameters

minHeightCss System.String = "clamp(24rem, calc(100vh - 18rem), 42rem)" requiredposition: 0
from HtmlForgeX.TablerBreakpoint = ExtraExtraLarge optionalposition: 1
FitViewport(System.Int32 minHeightPixels, HtmlForgeX.TablerBreakpoint from) #

Pixel overload for viewport-aware row sizing.

Parameters

minHeightPixels System.Int32 required
from HtmlForgeX.TablerBreakpoint required
public TablerRow Gap(Int32 value) #
Returns: TablerRow
EditorBrowsable(2)

Sets the gap between columns (Bootstrap g-* class).

Parameters

value System.Int32 requiredposition: 0
public TablerRow Packing(TablerRowPackingMode packing) #
Returns: TablerRow
EditorBrowsable(2)

Applies a typed packing preset to the current AutoFit row. This only affects rows that already use AutoFit.

Parameters

packing HtmlForgeX.TablerRowPackingMode requiredposition: 0
RegisterLibraries() #

Registers lightweight helpers when density/equalize features are used.

public TablerRow Settings(Action<TablerRowSettings> configure) #
Returns: TablerRow

Settings(...) sub‑builder to keep the root surface tidy.

Parameters

configure System.Action{HtmlForgeX.TablerRowSettings} requiredposition: 0
public TablerRow Sizing(TablerRowSizingMode mode) #
Returns: TablerRow
EditorBrowsable(2)

Applies a typed sizing strategy to this row.

Parameters

mode HtmlForgeX.TablerRowSizingMode requiredposition: 0
public TablerRow StretchToOneLineOnWide(Boolean enable = true) #
Returns: TablerRow
EditorBrowsable(2)

Prefer a single row on very wide screens (xxl) if items fit. Caps at 6 to match Bootstrap's utilities. Works with either Density() or TargetColumns().

Parameters

enable System.Boolean = true optionalposition: 0
public TablerRow TargetColumns(Int32 columns, Boolean hardLimit = false) #
Returns: TablerRow
EditorBrowsable(2)

Sets a target number of columns. When hardLimit is true, the row will not exceed the target on any breakpoint. Otherwise it will scale up to the target progressively.

Parameters

columns System.Int32 requiredposition: 0
hardLimit System.Boolean = false optionalposition: 1
public override String ToString() #
Returns: String

Initializes or configures ToString.

public TablerRow WithBottomSpacing(TablerSpacing spacing = Medium) #
Returns: TablerRow
EditorBrowsable(2)

Convenient method to add bottom margin (common use case for separating rows)

Parameters

spacing HtmlForgeX.TablerSpacing = Medium optionalposition: 0
public TablerRow WithClass(String cssClass) #
Returns: TablerRow
EditorBrowsable(2)

Adds custom CSS class

Parameters

cssClass System.String requiredposition: 0
public TablerRow WithGutter(TablerSpacing spacing) #
Returns: TablerRow
EditorBrowsable(2)

Sets gutter spacing between columns

Parameters

spacing HtmlForgeX.TablerSpacing requiredposition: 0
WithMargin 2 overloads
public TablerRow WithMargin(TablerSpacing spacing) #
Returns: TablerRow
EditorBrowsable(2)

Sets margin for all directions

Parameters

spacing HtmlForgeX.TablerSpacing requiredposition: 0
public TablerRow WithMargin(TablerSpacing spacing, TablerSpacingDirection direction) #
Returns: TablerRow
EditorBrowsable(2)

Sets margin for specific direction

Parameters

spacing HtmlForgeX.TablerSpacing requiredposition: 0
direction HtmlForgeX.TablerSpacingDirection requiredposition: 1
WithPadding 2 overloads
public TablerRow WithPadding(TablerSpacing spacing) #
Returns: TablerRow
EditorBrowsable(2)

Sets padding for all directions

Parameters

spacing HtmlForgeX.TablerSpacing requiredposition: 0
public TablerRow WithPadding(TablerSpacing spacing, TablerSpacingDirection direction) #
Returns: TablerRow
EditorBrowsable(2)

Sets padding for specific direction

Parameters

spacing HtmlForgeX.TablerSpacing requiredposition: 0
direction HtmlForgeX.TablerSpacingDirection requiredposition: 1
public TablerRow WithVerticalSpacing(TablerSpacing spacing = Medium) #
Returns: TablerRow
EditorBrowsable(2)

Convenient method to add vertical spacing (common use case)

Parameters

spacing HtmlForgeX.TablerSpacing = Medium optionalposition: 0