123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907 |
- import * as i0 from '@angular/core';
- import { ElementRef, OnInit, AfterViewInit, AfterContentInit, DoCheck, OnDestroy, ChangeDetectorRef, NgZone, QueryList, EventEmitter, Injector, OnChanges, InjectionToken } from '@angular/core';
- import { Subject, Observable } from 'rxjs';
- import { FocusKeyManager } from '@angular/cdk/a11y';
- import { ControlValueAccessor, NgControl } from '@angular/forms';
- import { E as ErrorStateMatcher } from '../error-options.d-CGdTZUYk.js';
- import { M as MatFormFieldControl } from '../form-field-control.d-QxD-9xJ3.js';
- import { M as MatCommonModule } from '../common-module.d-C8xzHJDr.js';
- import { M as MatRippleModule } from '../index.d-DG9eDM2-.js';
- import '@angular/cdk/bidi';
- import '../ripple.d-BxTUZJt7.js';
- import '@angular/cdk/platform';
- /**
- * Section within a chip.
- * @docs-private
- */
- declare class MatChipAction {
- _elementRef: ElementRef<HTMLElement>;
- protected _parentChip: {
- _handlePrimaryActionInteraction(): void;
- remove(): void;
- disabled: boolean;
- _isEditing?: boolean;
- };
- /** Whether the action is interactive. */
- isInteractive: boolean;
- /** Whether this is the primary action in the chip. */
- _isPrimary: boolean;
- /** Whether the action is disabled. */
- get disabled(): boolean;
- set disabled(value: boolean);
- private _disabled;
- /** Tab index of the action. */
- tabIndex: number;
- /**
- * Private API to allow focusing this chip when it is disabled.
- */
- private _allowFocusWhenDisabled;
- /**
- * Determine the value of the disabled attribute for this chip action.
- */
- protected _getDisabledAttribute(): string | null;
- /**
- * Determine the value of the tabindex attribute for this chip action.
- */
- protected _getTabindex(): string | null;
- constructor(...args: unknown[]);
- focus(): void;
- _handleClick(event: MouseEvent): void;
- _handleKeydown(event: KeyboardEvent): void;
- static ɵfac: i0.ɵɵFactoryDeclaration<MatChipAction, never>;
- static ɵdir: i0.ɵɵDirectiveDeclaration<MatChipAction, "[matChipAction]", never, { "isInteractive": { "alias": "isInteractive"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "_allowFocusWhenDisabled": { "alias": "_allowFocusWhenDisabled"; "required": false; }; }, {}, never, never, true, never>;
- static ngAcceptInputType_disabled: unknown;
- static ngAcceptInputType_tabIndex: unknown;
- }
- /** Avatar image within a chip. */
- declare class MatChipAvatar {
- static ɵfac: i0.ɵɵFactoryDeclaration<MatChipAvatar, never>;
- static ɵdir: i0.ɵɵDirectiveDeclaration<MatChipAvatar, "mat-chip-avatar, [matChipAvatar]", never, {}, {}, never, never, true, never>;
- }
- /** Non-interactive trailing icon in a chip. */
- declare class MatChipTrailingIcon extends MatChipAction {
- /**
- * MDC considers all trailing actions as a remove icon,
- * but we support non-interactive trailing icons.
- */
- isInteractive: boolean;
- _isPrimary: boolean;
- static ɵfac: i0.ɵɵFactoryDeclaration<MatChipTrailingIcon, never>;
- static ɵdir: i0.ɵɵDirectiveDeclaration<MatChipTrailingIcon, "mat-chip-trailing-icon, [matChipTrailingIcon]", never, {}, {}, never, never, true, never>;
- }
- /**
- * Directive to remove the parent chip when the trailing icon is clicked or
- * when the ENTER key is pressed on it.
- *
- * Recommended for use with the Material Design "cancel" icon
- * available at https://material.io/icons/#ic_cancel.
- *
- * Example:
- *
- * ```
- * <mat-chip>
- * <mat-icon matChipRemove>cancel</mat-icon>
- * </mat-chip>
- * ```
- */
- declare class MatChipRemove extends MatChipAction {
- _isPrimary: boolean;
- _handleClick(event: MouseEvent): void;
- _handleKeydown(event: KeyboardEvent): void;
- static ɵfac: i0.ɵɵFactoryDeclaration<MatChipRemove, never>;
- static ɵdir: i0.ɵɵDirectiveDeclaration<MatChipRemove, "[matChipRemove]", never, {}, {}, never, never, true, never>;
- }
- /** Represents an event fired on an individual `mat-chip`. */
- interface MatChipEvent {
- /** The chip the event was fired on. */
- chip: MatChip;
- }
- /**
- * Material design styled Chip base component. Used inside the MatChipSet component.
- *
- * Extended by MatChipOption and MatChipRow for different interaction patterns.
- */
- declare class MatChip implements OnInit, AfterViewInit, AfterContentInit, DoCheck, OnDestroy {
- _changeDetectorRef: ChangeDetectorRef;
- _elementRef: ElementRef<HTMLElement>;
- protected _ngZone: NgZone;
- private _focusMonitor;
- private _globalRippleOptions;
- protected _document: Document;
- /** Emits when the chip is focused. */
- readonly _onFocus: Subject<MatChipEvent>;
- /** Emits when the chip is blurred. */
- readonly _onBlur: Subject<MatChipEvent>;
- /** Whether this chip is a basic (unstyled) chip. */
- _isBasicChip: boolean;
- /** Role for the root of the chip. */
- role: string | null;
- /** Whether the chip has focus. */
- private _hasFocusInternal;
- /** Whether moving focus into the chip is pending. */
- private _pendingFocus;
- /** Subscription to changes in the chip's actions. */
- private _actionChanges;
- /** Whether animations for the chip are enabled. */
- _animationsDisabled: boolean;
- /** All avatars present in the chip. */
- protected _allLeadingIcons: QueryList<MatChipAvatar>;
- /** All trailing icons present in the chip. */
- protected _allTrailingIcons: QueryList<MatChipTrailingIcon>;
- /** All remove icons present in the chip. */
- protected _allRemoveIcons: QueryList<MatChipRemove>;
- _hasFocus(): boolean;
- /** A unique id for the chip. If none is supplied, it will be auto-generated. */
- id: string;
- /** ARIA label for the content of the chip. */
- ariaLabel: string | null;
- /** ARIA description for the content of the chip. */
- ariaDescription: string | null;
- /** Id of a span that contains this chip's aria description. */
- _ariaDescriptionId: string;
- /** Whether the chip list is disabled. */
- _chipListDisabled: boolean;
- private _textElement;
- /**
- * The value of the chip. Defaults to the content inside
- * the `mat-mdc-chip-action-label` element.
- */
- get value(): any;
- set value(value: any);
- protected _value: any;
- /**
- * Theme color of the chip. This API is supported in M2 themes only, it has no
- * effect in M3 themes. For color customization in M3, see https://material.angular.dev/components/chips/styling.
- *
- * For information on applying color variants in M3, see
- * https://material.angular.dev/guide/material-2-theming#optional-add-backwards-compatibility-styles-for-color-variants
- */
- color?: string | null;
- /**
- * Determines whether or not the chip displays the remove styling and emits (removed) events.
- */
- removable: boolean;
- /**
- * Colors the chip for emphasis as if it were selected.
- */
- highlighted: boolean;
- /** Whether the ripple effect is disabled or not. */
- disableRipple: boolean;
- /** Whether the chip is disabled. */
- get disabled(): boolean;
- set disabled(value: boolean);
- private _disabled;
- /** Emitted when a chip is to be removed. */
- readonly removed: EventEmitter<MatChipEvent>;
- /** Emitted when the chip is destroyed. */
- readonly destroyed: EventEmitter<MatChipEvent>;
- /** The unstyled chip selector for this component. */
- protected basicChipAttrName: string;
- /** The chip's leading icon. */
- leadingIcon: MatChipAvatar;
- /** The chip's trailing icon. */
- trailingIcon: MatChipTrailingIcon;
- /** The chip's trailing remove icon. */
- removeIcon: MatChipRemove;
- /** Action receiving the primary set of user interactions. */
- primaryAction: MatChipAction;
- /**
- * Handles the lazy creation of the MatChip ripple.
- * Used to improve initial load time of large applications.
- */
- private _rippleLoader;
- protected _injector: Injector;
- constructor(...args: unknown[]);
- ngOnInit(): void;
- ngAfterViewInit(): void;
- ngAfterContentInit(): void;
- ngDoCheck(): void;
- ngOnDestroy(): void;
- /**
- * Allows for programmatic removal of the chip.
- *
- * Informs any listeners of the removal request. Does not remove the chip from the DOM.
- */
- remove(): void;
- /** Whether or not the ripple should be disabled. */
- _isRippleDisabled(): boolean;
- /** Returns whether the chip has a trailing icon. */
- _hasTrailingIcon(): boolean;
- /** Handles keyboard events on the chip. */
- _handleKeydown(event: KeyboardEvent): void;
- /** Allows for programmatic focusing of the chip. */
- focus(): void;
- /** Gets the action that contains a specific target node. */
- _getSourceAction(target: Node): MatChipAction | undefined;
- /** Gets all of the actions within the chip. */
- _getActions(): MatChipAction[];
- /** Handles interactions with the primary action of the chip. */
- _handlePrimaryActionInteraction(): void;
- /** Starts the focus monitoring process on the chip. */
- private _monitorFocus;
- static ɵfac: i0.ɵɵFactoryDeclaration<MatChip, never>;
- static ɵcmp: i0.ɵɵComponentDeclaration<MatChip, "mat-basic-chip, [mat-basic-chip], mat-chip, [mat-chip]", ["matChip"], { "role": { "alias": "role"; "required": false; }; "id": { "alias": "id"; "required": false; }; "ariaLabel": { "alias": "aria-label"; "required": false; }; "ariaDescription": { "alias": "aria-description"; "required": false; }; "value": { "alias": "value"; "required": false; }; "color": { "alias": "color"; "required": false; }; "removable": { "alias": "removable"; "required": false; }; "highlighted": { "alias": "highlighted"; "required": false; }; "disableRipple": { "alias": "disableRipple"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "removed": "removed"; "destroyed": "destroyed"; }, ["leadingIcon", "trailingIcon", "removeIcon", "_allLeadingIcons", "_allTrailingIcons", "_allRemoveIcons"], ["mat-chip-avatar, [matChipAvatar]", "*", "mat-chip-trailing-icon,[matChipRemove],[matChipTrailingIcon]"], true, never>;
- static ngAcceptInputType_removable: unknown;
- static ngAcceptInputType_highlighted: unknown;
- static ngAcceptInputType_disableRipple: unknown;
- static ngAcceptInputType_disabled: unknown;
- }
- /** Event object emitted by MatChipOption when selected or deselected. */
- declare class MatChipSelectionChange {
- /** Reference to the chip that emitted the event. */
- source: MatChipOption;
- /** Whether the chip that emitted the event is selected. */
- selected: boolean;
- /** Whether the selection change was a result of a user interaction. */
- isUserInput: boolean;
- constructor(
- /** Reference to the chip that emitted the event. */
- source: MatChipOption,
- /** Whether the chip that emitted the event is selected. */
- selected: boolean,
- /** Whether the selection change was a result of a user interaction. */
- isUserInput?: boolean);
- }
- /**
- * An extension of the MatChip component that supports chip selection. Used with MatChipListbox.
- *
- * Unlike other chips, the user can focus on disabled chip options inside a MatChipListbox. The
- * user cannot click disabled chips.
- */
- declare class MatChipOption extends MatChip implements OnInit {
- /** Default chip options. */
- private _defaultOptions;
- /** Whether the chip list is selectable. */
- chipListSelectable: boolean;
- /** Whether the chip list is in multi-selection mode. */
- _chipListMultiple: boolean;
- /** Whether the chip list hides single-selection indicator. */
- _chipListHideSingleSelectionIndicator: boolean;
- /**
- * Whether or not the chip is selectable.
- *
- * When a chip is not selectable, changes to its selected state are always
- * ignored. By default an option chip is selectable, and it becomes
- * non-selectable if its parent chip list is not selectable.
- */
- get selectable(): boolean;
- set selectable(value: boolean);
- protected _selectable: boolean;
- /** Whether the chip is selected. */
- get selected(): boolean;
- set selected(value: boolean);
- private _selected;
- /**
- * The ARIA selected applied to the chip. Conforms to WAI ARIA best practices for listbox
- * interaction patterns.
- *
- * From [WAI ARIA Listbox authoring practices guide](
- * https://www.w3.org/WAI/ARIA/apg/patterns/listbox/):
- * "If any options are selected, each selected option has either aria-selected or aria-checked
- * set to true. All options that are selectable but not selected have either aria-selected or
- * aria-checked set to false."
- *
- * Set `aria-selected="false"` on not-selected listbox options that are selectable to fix
- * VoiceOver reading every option as "selected" (#25736).
- */
- get ariaSelected(): string | null;
- /** The unstyled chip selector for this component. */
- protected basicChipAttrName: string;
- /** Emitted when the chip is selected or deselected. */
- readonly selectionChange: EventEmitter<MatChipSelectionChange>;
- ngOnInit(): void;
- /** Selects the chip. */
- select(): void;
- /** Deselects the chip. */
- deselect(): void;
- /** Selects this chip and emits userInputSelection event */
- selectViaInteraction(): void;
- /** Toggles the current selected state of this chip. */
- toggleSelected(isUserInput?: boolean): boolean;
- _handlePrimaryActionInteraction(): void;
- _hasLeadingGraphic(): boolean;
- _setSelectedState(isSelected: boolean, isUserInput: boolean, emitEvent: boolean): void;
- static ɵfac: i0.ɵɵFactoryDeclaration<MatChipOption, never>;
- static ɵcmp: i0.ɵɵComponentDeclaration<MatChipOption, "mat-basic-chip-option, [mat-basic-chip-option], mat-chip-option, [mat-chip-option]", never, { "selectable": { "alias": "selectable"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; }, { "selectionChange": "selectionChange"; }, never, ["mat-chip-avatar, [matChipAvatar]", "*", "mat-chip-trailing-icon,[matChipRemove],[matChipTrailingIcon]"], true, never>;
- static ngAcceptInputType_selectable: unknown;
- static ngAcceptInputType_selected: unknown;
- }
- /**
- * A directive that makes a span editable and exposes functions to modify and retrieve the
- * element's contents.
- */
- declare class MatChipEditInput {
- private readonly _elementRef;
- private readonly _document;
- constructor(...args: unknown[]);
- initialize(initialValue: string): void;
- getNativeElement(): HTMLElement;
- setValue(value: string): void;
- getValue(): string;
- private _moveCursorToEndOfInput;
- static ɵfac: i0.ɵɵFactoryDeclaration<MatChipEditInput, never>;
- static ɵdir: i0.ɵɵDirectiveDeclaration<MatChipEditInput, "span[matChipEditInput]", never, {}, {}, never, never, true, never>;
- }
- /** Represents an event fired on an individual `mat-chip` when it is edited. */
- interface MatChipEditedEvent extends MatChipEvent {
- /** The final edit value. */
- value: string;
- }
- /**
- * An extension of the MatChip component used with MatChipGrid and
- * the matChipInputFor directive.
- */
- declare class MatChipRow extends MatChip implements AfterViewInit {
- protected basicChipAttrName: string;
- /**
- * The editing action has to be triggered in a timeout. While we're waiting on it, a blur
- * event might occur which will interrupt the editing. This flag is used to avoid interruptions
- * while the editing action is being initialized.
- */
- private _editStartPending;
- editable: boolean;
- /** Emitted when the chip is edited. */
- readonly edited: EventEmitter<MatChipEditedEvent>;
- /** The default chip edit input that is used if none is projected into this chip row. */
- defaultEditInput?: MatChipEditInput;
- /** The projected chip edit input. */
- contentEditInput?: MatChipEditInput;
- _isEditing: boolean;
- constructor(...args: unknown[]);
- _hasTrailingIcon(): boolean;
- /** Sends focus to the first gridcell when the user clicks anywhere inside the chip. */
- _handleFocus(): void;
- _handleKeydown(event: KeyboardEvent): void;
- _handleDoubleclick(event: MouseEvent): void;
- private _startEditing;
- private _onEditFinish;
- _isRippleDisabled(): boolean;
- /**
- * Gets the projected chip edit input, or the default input if none is projected in. One of these
- * two values is guaranteed to be defined.
- */
- private _getEditInput;
- static ɵfac: i0.ɵɵFactoryDeclaration<MatChipRow, never>;
- static ɵcmp: i0.ɵɵComponentDeclaration<MatChipRow, "mat-chip-row, [mat-chip-row], mat-basic-chip-row, [mat-basic-chip-row]", never, { "editable": { "alias": "editable"; "required": false; }; }, { "edited": "edited"; }, ["contentEditInput"], ["mat-chip-avatar, [matChipAvatar]", "[matChipEditInput]", "*", "mat-chip-trailing-icon,[matChipRemove],[matChipTrailingIcon]"], true, never>;
- }
- /**
- * Basic container component for the MatChip component.
- *
- * Extended by MatChipListbox and MatChipGrid for different interaction patterns.
- */
- declare class MatChipSet implements AfterViewInit, OnDestroy {
- protected _elementRef: ElementRef<HTMLElement>;
- protected _changeDetectorRef: ChangeDetectorRef;
- private _dir;
- /** Index of the last destroyed chip that had focus. */
- private _lastDestroyedFocusedChipIndex;
- /** Used to manage focus within the chip list. */
- protected _keyManager: FocusKeyManager<MatChipAction>;
- /** Subject that emits when the component has been destroyed. */
- protected _destroyed: Subject<void>;
- /** Role to use if it hasn't been overwritten by the user. */
- protected _defaultRole: string;
- /** Combined stream of all of the child chips' focus events. */
- get chipFocusChanges(): Observable<MatChipEvent>;
- /** Combined stream of all of the child chips' destroy events. */
- get chipDestroyedChanges(): Observable<MatChipEvent>;
- /** Combined stream of all of the child chips' remove events. */
- get chipRemovedChanges(): Observable<MatChipEvent>;
- /** Whether the chip set is disabled. */
- get disabled(): boolean;
- set disabled(value: boolean);
- protected _disabled: boolean;
- /** Whether the chip list contains chips or not. */
- get empty(): boolean;
- /** The ARIA role applied to the chip set. */
- get role(): string | null;
- /** Tabindex of the chip set. */
- tabIndex: number;
- set role(value: string | null);
- private _explicitRole;
- /** Whether any of the chips inside of this chip-set has focus. */
- get focused(): boolean;
- /** The chips that are part of this chip set. */
- _chips: QueryList<MatChip>;
- /** Flat list of all the actions contained within the chips. */
- _chipActions: QueryList<MatChipAction>;
- constructor(...args: unknown[]);
- ngAfterViewInit(): void;
- ngOnDestroy(): void;
- /** Checks whether any of the chips is focused. */
- protected _hasFocusedChip(): boolean;
- /** Syncs the chip-set's state with the individual chips. */
- protected _syncChipsState(): void;
- /** Dummy method for subclasses to override. Base chip set cannot be focused. */
- focus(): void;
- /** Handles keyboard events on the chip set. */
- _handleKeydown(event: KeyboardEvent): void;
- /**
- * Utility to ensure all indexes are valid.
- *
- * @param index The index to be checked.
- * @returns True if the index is valid for our list of chips.
- */
- protected _isValidIndex(index: number): boolean;
- /**
- * Removes the `tabindex` from the chip set and resets it back afterwards, allowing the
- * user to tab out of it. This prevents the set from capturing focus and redirecting
- * it back to the first chip, creating a focus trap, if it user tries to tab away.
- */
- protected _allowFocusEscape(): void;
- /**
- * Gets a stream of events from all the chips within the set.
- * The stream will automatically incorporate any newly-added chips.
- */
- protected _getChipStream<T, C extends MatChip = MatChip>(mappingFunction: (chip: C) => Observable<T>): Observable<T>;
- /** Checks whether an event comes from inside a chip element. */
- protected _originatesFromChip(event: Event): boolean;
- /** Sets up the chip set's focus management logic. */
- private _setUpFocusManagement;
- /**
- * Determines if key manager should avoid putting a given chip action in the tab index. Skip
- * non-interactive and disabled actions since the user can't do anything with them.
- */
- protected _skipPredicate(action: MatChipAction): boolean;
- /** Listens to changes in the chip set and syncs up the state of the individual chips. */
- private _trackChipSetChanges;
- /** Starts tracking the destroyed chips in order to capture the focused one. */
- private _trackDestroyedFocusedChip;
- /**
- * Finds the next appropriate chip to move focus to,
- * if the currently-focused chip is destroyed.
- */
- private _redirectDestroyedChipFocus;
- static ɵfac: i0.ɵɵFactoryDeclaration<MatChipSet, never>;
- static ɵcmp: i0.ɵɵComponentDeclaration<MatChipSet, "mat-chip-set", never, { "disabled": { "alias": "disabled"; "required": false; }; "role": { "alias": "role"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; }, {}, ["_chips"], ["*"], true, never>;
- static ngAcceptInputType_disabled: unknown;
- static ngAcceptInputType_tabIndex: unknown;
- }
- /** Change event object that is emitted when the chip listbox value has changed. */
- declare class MatChipListboxChange {
- /** Chip listbox that emitted the event. */
- source: MatChipListbox;
- /** Value of the chip listbox when the event was emitted. */
- value: any;
- constructor(
- /** Chip listbox that emitted the event. */
- source: MatChipListbox,
- /** Value of the chip listbox when the event was emitted. */
- value: any);
- }
- /**
- * Provider Expression that allows mat-chip-listbox to register as a ControlValueAccessor.
- * This allows it to support [(ngModel)].
- * @docs-private
- */
- declare const MAT_CHIP_LISTBOX_CONTROL_VALUE_ACCESSOR: any;
- /**
- * An extension of the MatChipSet component that supports chip selection.
- * Used with MatChipOption chips.
- */
- declare class MatChipListbox extends MatChipSet implements AfterContentInit, OnDestroy, ControlValueAccessor {
- /**
- * Function when touched. Set as part of ControlValueAccessor implementation.
- * @docs-private
- */
- _onTouched: () => void;
- /**
- * Function when changed. Set as part of ControlValueAccessor implementation.
- * @docs-private
- */
- _onChange: (value: any) => void;
- protected _defaultRole: string;
- /** Default chip options. */
- private _defaultOptions;
- /** Whether the user should be allowed to select multiple chips. */
- get multiple(): boolean;
- set multiple(value: boolean);
- private _multiple;
- /** The array of selected chips inside the chip listbox. */
- get selected(): MatChipOption[] | MatChipOption;
- /** Orientation of the chip list. */
- ariaOrientation: 'horizontal' | 'vertical';
- /**
- * Whether or not this chip listbox is selectable.
- *
- * When a chip listbox is not selectable, the selected states for all
- * the chips inside the chip listbox are always ignored.
- */
- get selectable(): boolean;
- set selectable(value: boolean);
- protected _selectable: boolean;
- /**
- * A function to compare the option values with the selected values. The first argument
- * is a value from an option. The second is a value from the selection. A boolean
- * should be returned.
- */
- compareWith: (o1: any, o2: any) => boolean;
- /** Whether this chip listbox is required. */
- required: boolean;
- /** Whether checkmark indicator for single-selection options is hidden. */
- get hideSingleSelectionIndicator(): boolean;
- set hideSingleSelectionIndicator(value: boolean);
- private _hideSingleSelectionIndicator;
- /** Combined stream of all of the child chips' selection change events. */
- get chipSelectionChanges(): Observable<MatChipSelectionChange>;
- /** Combined stream of all of the child chips' blur events. */
- get chipBlurChanges(): Observable<MatChipEvent>;
- /** The value of the listbox, which is the combined value of the selected chips. */
- get value(): any;
- set value(value: any);
- protected _value: any;
- /** Event emitted when the selected chip listbox value has been changed by the user. */
- readonly change: EventEmitter<MatChipListboxChange>;
- _chips: QueryList<MatChipOption>;
- ngAfterContentInit(): void;
- /**
- * Focuses the first selected chip in this chip listbox, or the first non-disabled chip when there
- * are no selected chips.
- */
- focus(): void;
- /**
- * Implemented as part of ControlValueAccessor.
- * @docs-private
- */
- writeValue(value: any): void;
- /**
- * Implemented as part of ControlValueAccessor.
- * @docs-private
- */
- registerOnChange(fn: (value: any) => void): void;
- /**
- * Implemented as part of ControlValueAccessor.
- * @docs-private
- */
- registerOnTouched(fn: () => void): void;
- /**
- * Implemented as part of ControlValueAccessor.
- * @docs-private
- */
- setDisabledState(isDisabled: boolean): void;
- /** Selects all chips with value. */
- _setSelectionByValue(value: any, isUserInput?: boolean): void;
- /** When blurred, marks the field as touched when focus moved outside the chip listbox. */
- _blur(): void;
- _keydown(event: KeyboardEvent): void;
- /** Marks the field as touched */
- private _markAsTouched;
- /** Emits change event to set the model value. */
- private _propagateChanges;
- /**
- * Deselects every chip in the listbox.
- * @param skip Chip that should not be deselected.
- */
- private _clearSelection;
- /**
- * Finds and selects the chip based on its value.
- * @returns Chip that has the corresponding value.
- */
- private _selectValue;
- /** Syncs the chip-listbox selection state with the individual chips. */
- private _syncListboxProperties;
- /** Returns the first selected chip in this listbox, or undefined if no chips are selected. */
- private _getFirstSelectedChip;
- /**
- * Determines if key manager should avoid putting a given chip action in the tab index. Skip
- * non-interactive actions since the user can't do anything with them.
- */
- protected _skipPredicate(action: MatChipAction): boolean;
- static ɵfac: i0.ɵɵFactoryDeclaration<MatChipListbox, never>;
- static ɵcmp: i0.ɵɵComponentDeclaration<MatChipListbox, "mat-chip-listbox", never, { "multiple": { "alias": "multiple"; "required": false; }; "ariaOrientation": { "alias": "aria-orientation"; "required": false; }; "selectable": { "alias": "selectable"; "required": false; }; "compareWith": { "alias": "compareWith"; "required": false; }; "required": { "alias": "required"; "required": false; }; "hideSingleSelectionIndicator": { "alias": "hideSingleSelectionIndicator"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "change": "change"; }, ["_chips"], ["*"], true, never>;
- static ngAcceptInputType_multiple: unknown;
- static ngAcceptInputType_selectable: unknown;
- static ngAcceptInputType_required: unknown;
- static ngAcceptInputType_hideSingleSelectionIndicator: unknown;
- }
- /** Interface for a text control that is used to drive interaction with a mat-chip-list. */
- interface MatChipTextControl {
- /** Unique identifier for the text control. */
- id: string;
- /** The text control's placeholder text. */
- placeholder: string;
- /** Whether the text control has browser focus. */
- focused: boolean;
- /** Whether the text control is empty. */
- empty: boolean;
- /** Focuses the text control. */
- focus(): void;
- /** Sets the list of ids the input is described by. */
- setDescribedByIds(ids: string[]): void;
- }
- /** Change event object that is emitted when the chip grid value has changed. */
- declare class MatChipGridChange {
- /** Chip grid that emitted the event. */
- source: MatChipGrid;
- /** Value of the chip grid when the event was emitted. */
- value: any;
- constructor(
- /** Chip grid that emitted the event. */
- source: MatChipGrid,
- /** Value of the chip grid when the event was emitted. */
- value: any);
- }
- /**
- * An extension of the MatChipSet component used with MatChipRow chips and
- * the matChipInputFor directive.
- */
- declare class MatChipGrid extends MatChipSet implements AfterContentInit, AfterViewInit, ControlValueAccessor, DoCheck, MatFormFieldControl<any>, OnDestroy {
- ngControl: NgControl;
- /**
- * Implemented as part of MatFormFieldControl.
- * @docs-private
- */
- readonly controlType: string;
- /** The chip input to add more chips */
- protected _chipInput: MatChipTextControl;
- protected _defaultRole: string;
- private _errorStateTracker;
- /**
- * List of element ids to propagate to the chipInput's aria-describedby attribute.
- */
- private _ariaDescribedbyIds;
- /**
- * Function when touched. Set as part of ControlValueAccessor implementation.
- * @docs-private
- */
- _onTouched: () => void;
- /**
- * Function when changed. Set as part of ControlValueAccessor implementation.
- * @docs-private
- */
- _onChange: (value: any) => void;
- /**
- * Implemented as part of MatFormFieldControl.
- * @docs-private
- */
- get disabled(): boolean;
- set disabled(value: boolean);
- /**
- * Implemented as part of MatFormFieldControl.
- * @docs-private
- */
- get id(): string;
- /**
- * Implemented as part of MatFormFieldControl.
- * @docs-private
- */
- get empty(): boolean;
- /**
- * Implemented as part of MatFormFieldControl.
- * @docs-private
- */
- get placeholder(): string;
- set placeholder(value: string);
- protected _placeholder: string;
- /** Whether any chips or the matChipInput inside of this chip-grid has focus. */
- get focused(): boolean;
- /**
- * Implemented as part of MatFormFieldControl.
- * @docs-private
- */
- get required(): boolean;
- set required(value: boolean);
- protected _required: boolean | undefined;
- /**
- * Implemented as part of MatFormFieldControl.
- * @docs-private
- */
- get shouldLabelFloat(): boolean;
- /**
- * Implemented as part of MatFormFieldControl.
- * @docs-private
- */
- get value(): any;
- set value(value: any);
- protected _value: any[];
- /** An object used to control when error messages are shown. */
- get errorStateMatcher(): ErrorStateMatcher;
- set errorStateMatcher(value: ErrorStateMatcher);
- /** Combined stream of all of the child chips' blur events. */
- get chipBlurChanges(): Observable<MatChipEvent>;
- /** Emits when the chip grid value has been changed by the user. */
- readonly change: EventEmitter<MatChipGridChange>;
- /**
- * Emits whenever the raw value of the chip-grid changes. This is here primarily
- * to facilitate the two-way binding for the `value` input.
- * @docs-private
- */
- readonly valueChange: EventEmitter<any>;
- _chips: QueryList<MatChipRow>;
- /**
- * Emits whenever the component state changes and should cause the parent
- * form-field to update. Implemented as part of `MatFormFieldControl`.
- * @docs-private
- */
- readonly stateChanges: Subject<void>;
- /** Whether the chip grid is in an error state. */
- get errorState(): boolean;
- set errorState(value: boolean);
- constructor(...args: unknown[]);
- ngAfterContentInit(): void;
- ngAfterViewInit(): void;
- ngDoCheck(): void;
- ngOnDestroy(): void;
- /** Associates an HTML input element with this chip grid. */
- registerInput(inputElement: MatChipTextControl): void;
- /**
- * Implemented as part of MatFormFieldControl.
- * @docs-private
- */
- onContainerClick(event: MouseEvent): void;
- /**
- * Focuses the first chip in this chip grid, or the associated input when there
- * are no eligible chips.
- */
- focus(): void;
- /**
- * Implemented as part of MatFormFieldControl.
- * @docs-private
- */
- setDescribedByIds(ids: string[]): void;
- /**
- * Implemented as part of ControlValueAccessor.
- * @docs-private
- */
- writeValue(value: any): void;
- /**
- * Implemented as part of ControlValueAccessor.
- * @docs-private
- */
- registerOnChange(fn: (value: any) => void): void;
- /**
- * Implemented as part of ControlValueAccessor.
- * @docs-private
- */
- registerOnTouched(fn: () => void): void;
- /**
- * Implemented as part of ControlValueAccessor.
- * @docs-private
- */
- setDisabledState(isDisabled: boolean): void;
- /** Refreshes the error state of the chip grid. */
- updateErrorState(): void;
- /** When blurred, mark the field as touched when focus moved outside the chip grid. */
- _blur(): void;
- /**
- * Removes the `tabindex` from the chip grid and resets it back afterwards, allowing the
- * user to tab out of it. This prevents the grid from capturing focus and redirecting
- * it back to the first chip, creating a focus trap, if it user tries to tab away.
- */
- protected _allowFocusEscape(): void;
- /** Handles custom keyboard events. */
- _handleKeydown(event: KeyboardEvent): void;
- _focusLastChip(): void;
- /** Emits change event to set the model value. */
- private _propagateChanges;
- /** Mark the field as touched */
- private _markAsTouched;
- static ɵfac: i0.ɵɵFactoryDeclaration<MatChipGrid, never>;
- static ɵcmp: i0.ɵɵComponentDeclaration<MatChipGrid, "mat-chip-grid", never, { "disabled": { "alias": "disabled"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "required": { "alias": "required"; "required": false; }; "value": { "alias": "value"; "required": false; }; "errorStateMatcher": { "alias": "errorStateMatcher"; "required": false; }; }, { "change": "change"; "valueChange": "valueChange"; }, ["_chips"], ["*"], true, never>;
- static ngAcceptInputType_disabled: unknown;
- static ngAcceptInputType_required: unknown;
- }
- /** Represents an input event on a `matChipInput`. */
- interface MatChipInputEvent {
- /**
- * The native `<input>` element that the event is being fired for.
- * @deprecated Use `MatChipInputEvent#chipInput.inputElement` instead.
- * @breaking-change 13.0.0 This property will be removed.
- */
- input: HTMLInputElement;
- /** The value of the input. */
- value: string;
- /** Reference to the chip input that emitted the event. */
- chipInput: MatChipInput;
- }
- /**
- * Directive that adds chip-specific behaviors to an input element inside `<mat-form-field>`.
- * May be placed inside or outside of a `<mat-chip-grid>`.
- */
- declare class MatChipInput implements MatChipTextControl, OnChanges, OnDestroy {
- protected _elementRef: ElementRef<HTMLInputElement>;
- /** Whether the control is focused. */
- focused: boolean;
- /** Register input for chip list */
- get chipGrid(): MatChipGrid;
- set chipGrid(value: MatChipGrid);
- private _chipGrid;
- /**
- * Whether or not the chipEnd event will be emitted when the input is blurred.
- */
- addOnBlur: boolean;
- /**
- * The list of key codes that will trigger a chipEnd event.
- *
- * Defaults to `[ENTER]`.
- */
- separatorKeyCodes: readonly number[] | ReadonlySet<number>;
- /** Emitted when a chip is to be added. */
- readonly chipEnd: EventEmitter<MatChipInputEvent>;
- /** The input's placeholder text. */
- placeholder: string;
- /** Unique id for the input. */
- id: string;
- /** Whether the input is disabled. */
- get disabled(): boolean;
- set disabled(value: boolean);
- private _disabled;
- /** Whether the input is empty. */
- get empty(): boolean;
- /** The native input element to which this directive is attached. */
- readonly inputElement: HTMLInputElement;
- constructor(...args: unknown[]);
- ngOnChanges(): void;
- ngOnDestroy(): void;
- /** Utility method to make host definition/tests more clear. */
- _keydown(event: KeyboardEvent): void;
- /** Checks to see if the blur should emit the (chipEnd) event. */
- _blur(): void;
- _focus(): void;
- /** Checks to see if the (chipEnd) event needs to be emitted. */
- _emitChipEnd(event?: KeyboardEvent): void;
- _onInput(): void;
- /** Focuses the input. */
- focus(): void;
- /** Clears the input */
- clear(): void;
- setDescribedByIds(ids: string[]): void;
- /** Checks whether a keycode is one of the configured separators. */
- private _isSeparatorKey;
- static ɵfac: i0.ɵɵFactoryDeclaration<MatChipInput, never>;
- static ɵdir: i0.ɵɵDirectiveDeclaration<MatChipInput, "input[matChipInputFor]", ["matChipInput", "matChipInputFor"], { "chipGrid": { "alias": "matChipInputFor"; "required": false; }; "addOnBlur": { "alias": "matChipInputAddOnBlur"; "required": false; }; "separatorKeyCodes": { "alias": "matChipInputSeparatorKeyCodes"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "id": { "alias": "id"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "chipEnd": "matChipInputTokenEnd"; }, never, never, true, never>;
- static ngAcceptInputType_addOnBlur: unknown;
- static ngAcceptInputType_disabled: unknown;
- }
- declare class MatChipsModule {
- static ɵfac: i0.ɵɵFactoryDeclaration<MatChipsModule, never>;
- static ɵmod: i0.ɵɵNgModuleDeclaration<MatChipsModule, never, [typeof MatCommonModule, typeof MatRippleModule, typeof MatChipAction, typeof MatChip, typeof MatChipAvatar, typeof MatChipEditInput, typeof MatChipGrid, typeof MatChipInput, typeof MatChipListbox, typeof MatChipOption, typeof MatChipRemove, typeof MatChipRow, typeof MatChipSet, typeof MatChipTrailingIcon], [typeof MatCommonModule, typeof MatChip, typeof MatChipAvatar, typeof MatChipEditInput, typeof MatChipGrid, typeof MatChipInput, typeof MatChipListbox, typeof MatChipOption, typeof MatChipRemove, typeof MatChipRow, typeof MatChipSet, typeof MatChipTrailingIcon]>;
- static ɵinj: i0.ɵɵInjectorDeclaration<MatChipsModule>;
- }
- /** Default options, for the chips module, that can be overridden. */
- interface MatChipsDefaultOptions {
- /** The list of key codes that will trigger a chipEnd event. */
- separatorKeyCodes: readonly number[] | ReadonlySet<number>;
- /** Whether icon indicators should be hidden for single-selection. */
- hideSingleSelectionIndicator?: boolean;
- }
- /** Injection token to be used to override the default options for the chips module. */
- declare const MAT_CHIPS_DEFAULT_OPTIONS: InjectionToken<MatChipsDefaultOptions>;
- /**
- * Injection token that can be used to reference instances of `MatChipAvatar`. It serves as
- * alternative token to the actual `MatChipAvatar` class which could cause unnecessary
- * retention of the class and its directive metadata.
- */
- declare const MAT_CHIP_AVATAR: InjectionToken<unknown>;
- /**
- * Injection token that can be used to reference instances of `MatChipTrailingIcon`. It serves as
- * alternative token to the actual `MatChipTrailingIcon` class which could cause unnecessary
- * retention of the class and its directive metadata.
- */
- declare const MAT_CHIP_TRAILING_ICON: InjectionToken<unknown>;
- /**
- * Injection token that can be used to reference instances of `MatChipRemove`. It serves as
- * alternative token to the actual `MatChipRemove` class which could cause unnecessary
- * retention of the class and its directive metadata.
- */
- declare const MAT_CHIP_REMOVE: InjectionToken<unknown>;
- /**
- * Injection token used to avoid a circular dependency between the `MatChip` and `MatChipAction`.
- */
- declare const MAT_CHIP: InjectionToken<unknown>;
- export { MAT_CHIP, MAT_CHIPS_DEFAULT_OPTIONS, MAT_CHIP_AVATAR, MAT_CHIP_LISTBOX_CONTROL_VALUE_ACCESSOR, MAT_CHIP_REMOVE, MAT_CHIP_TRAILING_ICON, MatChip, MatChipAvatar, MatChipEditInput, MatChipGrid, MatChipGridChange, MatChipInput, MatChipListbox, MatChipListboxChange, MatChipOption, MatChipRemove, MatChipRow, MatChipSelectionChange, MatChipSet, MatChipTrailingIcon, MatChipsModule };
- export type { MatChipEditedEvent, MatChipEvent, MatChipInputEvent, MatChipTextControl, MatChipsDefaultOptions };
|