StaticRadioTagHelper

Inherits: TagHelper HTML Target: <input>

StaticRadioTagHelper is the tag helper that powers static-radio-for on <input> elements. It always emits type="radio", uses an explicit value attribute as the option key, and adds checked when the bound model value matches that key.

This tag helper is used declaratively — apply the static-radio-for attribute on an <input> inside a Razor template for a component inheriting from StaticRadio.

Namespace

TechGems.StaticComponents.Headless.TagHelpers

HTML Target Element

<input static-radio-for="@Model.InputExpression" value="…" />

Usage

@model PinesRadio

<input static-radio-for="@Model.InputExpression"
       value="@Model.Value"
       disabled="@(Model.Disabled ? "disabled" : null)"
       class="…" />

Public Properties

`InputExpression`

[HtmlAttributeName("static-radio-for")]
public ModelExpression InputExpression { get; set; }

The outer ModelExpression — its .ModelExplorer.Model is expected to be another ModelExpression bound to the consumer’s actual property.

`Value`

[HtmlAttributeName("value")]
public string? Value { get; set; }

The option value this radio instance represents. Required — the tag helper throws ArgumentException if Value is null.

Supported Model Types

string, int, short, long, byte, bool, Enum and their nullable counterparts.

Behavior

When processed, the tag helper:

Validates the inner model type is supported (throws otherwise).
Validates Value is not null (throws otherwise).
Forces type="radio" on the output.
Sets name, id and the data-val-* attributes through StaticHeadlessUtils.
Emits the rendered value attribute by formatting Value through FormatModelValue (invariant-culture formatting).
Adds checked="checked" when no explicit checked is already on the output and Value equals the model value’s string representation.

Error Conditions

Condition	Exception
Inner property is not one of the supported model types	`ArgumentException`
`Value` is `null`	`ArgumentException`

Headless Components — Feature guide.
StaticRadio