FormComponent<T> Class

FormComponent<T>linkLink to this section

Base class for all Radzen form input components providing data binding, validation, and change event capabilities. FormComponent integrates with Blazor's EditContext for form validation and provides common functionality for all input controls. This is the base class for components like RadzenTextBox, RadzenCheckBox, RadzenDropDown, RadzenDatePicker, etc. Provides @bind-Value support for two-way binding, integration with Blazor EditContext and validators, Change and ValueChanged callbacks, Disable property to prevent user interaction, Placeholder text for empty inputs, Name property for validation and label association, and TabIndex for keyboard navigation control. Components inheriting from FormComponent automatically work with RadzenTemplateForm and validators.

Declaration

public FormComponent<T>()

_valuelinkLink to this section

The value

Declaration

protected T _value

ChangelinkLink to this section

Gets or sets the change.

Declaration

public EventCallback<T> Change { get; set; }

Property Value

CurrentPlaceholderlinkLink to this section

Gets the current placeholder. Returns empty string if this component is inside a RadzenFormField.

Declaration

protected string CurrentPlaceholder { get; }

Property Value

DisabledlinkLink to this section

Gets or sets a value indicating whether this FormComponent<T> is disabled.

Declaration

public bool Disabled { get; set; }

Property Value

EditContextlinkLink to this section

Gets or sets the edit context.

Declaration

public Forms.EditContext EditContext { get; set; }

Property Value

FieldIdentifierlinkLink to this section

Gets the field identifier.

Declaration

public Forms.FieldIdentifier FieldIdentifier { get; set; }

Property Value

FormlinkLink to this section

Gets or sets the form.

Declaration

public IRadzenForm Form { get; set; }

Property Value

FormFieldContextlinkLink to this section

Provides support for RadzenFormField integration.

Declaration

public IFormFieldContext FormFieldContext { get; set; }

Property Value

HasValuelinkLink to this section

Gets a value indicating whether this instance has value.

Declaration

public bool HasValue { get; }

Property Value

IsBoundlinkLink to this section

Gets a value indicating whether this instance is bound.

Declaration

public bool IsBound { get; }

Property Value

NamelinkLink to this section

Gets or sets the unique name identifier for this form component. Used for validation association (linking with validators and labels) and for identifying the field in form submission. This name should be unique within the form and match the Component property of associated validators/labels.

Declaration

public string Name { get; set; }

Property Value

PlaceholderlinkLink to this section

Gets or sets the placeholder.

Declaration

public string Placeholder { get; set; }

Property Value

TabIndexlinkLink to this section

Gets or sets the tab order index for keyboard navigation. Controls the order in which fields receive focus when the user presses the Tab key. Lower values receive focus first. Use -1 to exclude from tab navigation.

Declaration

public int TabIndex { get; set; }

Property Value

ValuelinkLink to this section

Gets or sets the value.

Declaration

public T Value { get; set; }

Property Value

ValueChangedlinkLink to this section

Gets or sets the value changed.

Declaration

public EventCallback<T> ValueChanged { get; set; }

Property Value

ValueExpressionlinkLink to this section

Gets or sets the value expression.

Declaration

public Expressions.Expression<Func<T>> ValueExpression { get; set; }

Property Value

DisposelinkLink to this section

Disposes this instance.

Declaration

public override void Dispose()

FocusAsynclinkLink to this section

Declaration

public virtual ValueTask FocusAsync()

Returns

GetClassListlinkLink to this section

Gets the class list.

Declaration

protected Rendering.ClassList GetClassList(string className)

Parameters

Returns

GetValuelinkLink to this section

Gets the value.

Declaration

public object GetValue()

Returns

NotifyFieldChangedlinkLink to this section

Notifies the EditContext that the field has changed while validators observe the specified value. The stored value is restored afterwards so that two-way binding parameter re-flow keeps working as expected.

Declaration

protected void NotifyFieldChanged(T value)

Parameters

OnContextMenulinkLink to this section

Handles the ContextMenu event.

Declaration

public override Task OnContextMenu(MouseEventArgs args)

Parameters

Returns

SetParametersAsynclinkLink to this section

Sets the parameters asynchronous.

Declaration

public override Task SetParametersAsync(ParameterView parameters)

Parameters

Returns