Skip to content
angulux
@anguless/angulux/selectbutton

selectbutton

1 declarations2 demos
import
import { SelectButtonModule } from '@anguless/angulux/selectbutton';

Basic

SelectButton is a single choice laid out as a row of buttons.

OffOn
<agl-selectButton [(ngModel)]="value" [options]="options" optionLabel="label" optionValue="value" />

Multiple

With multiple, the value becomes an array and several options can be on at once.

BoldItalicUnderline
<agl-selectButton [(ngModel)]="value" [options]="options" [multiple]="true" optionLabel="label" optionValue="value" />

API

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

SelectButton

componentagl-selectButton, agl-selectbutton, agl-select-button

SelectButton is used to choose single or multiple items from a list using buttons.

InputTypeDefaultDescription
optionsany[] | undefinednot documentedAn array of selectitems to display as the available options.
optionLabelstring | undefinednot documentedName of the label field of an option.
optionValuestring | undefinednot documentedName of the value field of an option.
optionDisabledstring | undefinednot documentedName of the disabled field of an option.
unselectablenot documented
tabindexnumbernot documentedIndex of the element in tabbing order.
multipleboolean | undefinednot documentedWhen specified, allows selecting multiple values.
allowEmptybooleannot documentedWhether selection can not be cleared.
styleClassstring | undefinednot documentedStyle class of the component.
ariaLabelledBystring | undefinednot documentedEstablishes relationships between the component and label(s) where its value should be one or more element IDs.
dataKeystring | undefinednot documentedA property to uniquely identify a value in options.
autofocusboolean | undefinednot documentedWhen present, it specifies that the component should automatically get focus on load.
size'large' | 'small' | undefined undefined Specifies the size of the component.
fluid undefined Spans 100% width of the container when enabled.
OutputTypeDescription
onOptionClickEventEmitter<SelectButtonOptionClickEvent>Callback to invoke on input click.
onChangeEventEmitter<SelectButtonChangeEvent>Callback to invoke on selection change.
Template slotDescription
<ng-template #item>Custom item template.

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.