Skip to content
angulux
@anguless/angulux/radiobutton

radiobutton

1 declarations2 demos
import
import { RadioButtonModule } from '@anguless/angulux/radiobutton';

Basic

Radio buttons sharing a name and bound to the same value form one group.

@for (city of cities; track city) {    <agl-radioButton [(ngModel)]="selected" [value]="city" [inputId]="city" name="city" />    <label [for]="city">{{ city }}</label>}

Sizes

RadioButton provides small and large sizes as alternatives to the standard.

<agl-radioButton [(ngModel)]="selected" value="small" size="small" name="size" /><agl-radioButton [(ngModel)]="selected" value="normal" name="size" /><agl-radioButton [(ngModel)]="selected" value="large" size="large" name="size" />

API

Generated from the committed corpus, which check:corpus holds to the built library.

RadioButton

componentagl-radioButton, agl-radiobutton, agl-radio-button

RadioButton is an extension to standard radio button element with theming.

InputTypeDefaultDescription
valueanynot documentedValue of the radiobutton.
tabindexnumber | undefinednot documentedIndex of the element in tabbing order.
inputIdstring | undefinednot documentedIdentifier of the focus input to match a label defined for the component.
ariaLabelledBystring | undefinednot documentedEstablishes relationships between the component and label(s) where its value should be one or more element IDs.
ariaLabelstring | undefinednot documentedUsed to define a string that labels the input element.
styleClass
deprecated — since v20.0.0, use `class` instead.
string | undefinednot documentedStyle class of the component.
autofocusboolean | undefinednot documentedWhen present, it specifies that the component should automatically get focus on load.
binaryboolean | undefinednot documentedAllows to select a boolean value.
variant'filled' | 'outlined' | undefined undefined Specifies the input variant of the component.
size'large' | 'small' | undefined undefined Specifies the size of the component.
OutputTypeDescription
onClickEventEmitter<RadioButtonClickEvent>Callback to invoke on radio button click.
onFocusEventEmitter<Event>Callback to invoke when the receives focus.
onBlurEventEmitter<Event>Callback to invoke when the loses focus.

Inherited from BaseEditableHolder

inherited
InputTypeDefaultDescription
required false There must be a value (if set). Left unbound, a control bound through `formControlName`, `[formControl]` or `ngModel` is required when that control carries `Validators.required` or `Validators.requiredTrue`.
invalid false When present, it specifies that the component should have invalid state style. Left unbound, a control bound through `formControlName`, `[formControl]` or `ngModel` shows the state of that control once it is touched or dirty.
touchedboolean | undefined undefined Whether the user has visited the control. Once this or `dirty` is set, the invalid state style waits for interaction: it appears when the control is touched or dirty. Signal Forms' `[formField]` sets both, so an untouched required field is not shown as invalid. Leave both unset and `invalid` alone decides.
dirtyboolean | undefined undefined Whether the user has changed the value. See `touched`.
disabled false When present, it specifies that the component should have disabled state style.
namestring | undefined undefined When present, it specifies that the name of the input.

Inherited from BaseComponent

inherited
InputTypeDefaultDescription
dtObject | undefined undefined Defines scoped design tokens of the component.
unstyledboolean | undefined undefined Indicates whether the component should be rendered without styles.
ptPT | undefined undefined Used to pass attributes to DOM elements inside the component. TRUSTED INPUT ONLY. Whatever you put here is applied to the DOM as given: keys become attributes, and a key that names a DOM property is assigned to that property directly, with no sanitizer in between. That is what makes the API useful, and it means a value reaching it from a user, a database or a CMS can execute script. Treat it like markup you wrote yourself, not like data you received.
ptOptionsPassThroughOptions | undefined undefined Used to configure passthrough(pt) options of the component.