material-web-evo 10002.10001.10000

package/select/internal/outlined-select.js

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2023 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import '../../field/outlined-field.js';
+import { literal } from 'lit/static-html.js';
+import { Select } from './select.js';
+// tslint:disable-next-line:enforce-comments-on-exported-symbols
+export class OutlinedSelect extends Select {
+    constructor() {
+        super(...arguments);
+        this.fieldTag = literal `md-outlined-field`;
+    }
+}
+//# sourceMappingURL=outlined-select.js.map

package/select/internal/outlined-select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outlined-select.js","sourceRoot":"","sources":["outlined-select.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,+BAA+B,CAAC;AAEvC,OAAO,EAAC,OAAO,EAAC,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAC,MAAM,EAAC,MAAM,aAAa,CAAC;AAEnC,gEAAgE;AAChE,MAAM,OAAgB,cAAe,SAAQ,MAAM;IAAnD;;QACqB,aAAQ,GAAG,OAAO,CAAA,mBAAmB,CAAC;IAC3D,CAAC;CAAA","sourcesContent":["/**\n * @license\n * Copyright 2023 Google LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport '../../field/outlined-field.js';\n\nimport {literal} from 'lit/static-html.js';\n\nimport {Select} from './select.js';\n\n// tslint:disable-next-line:enforce-comments-on-exported-symbols\nexport abstract class OutlinedSelect extends Select {\n  protected readonly fieldTag = literal`md-outlined-field`;\n}\n"]}

package/select/internal/select.d.ts

@@ -0,0 +1,269 @@
+/**
+ * @license
+ * Copyright 2023 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import '../../menu/menu.js';
+import { LitElement, PropertyValues } from 'lit';
+import { StaticValue } from 'lit/static-html.js';
+import { Field } from '../../field/internal/field.js';
+import { createValidator, getValidityAnchor } from '../../labs/behaviors/constraint-validation.js';
+import { getFormValue } from '../../labs/behaviors/form-associated.js';
+import { onReportValidity } from '../../labs/behaviors/on-report-validity.js';
+import { SelectValidator } from '../../labs/behaviors/validators/select-validator.js';
+import { SelectOption } from './selectoption/select-option.js';
+declare const VALUE: unique symbol;
+declare const selectBaseClass: import("../../labs/behaviors/mixin.js").MixinReturn<import("../../labs/behaviors/mixin.js").MixinReturn<import("../../labs/behaviors/mixin.js").MixinReturn<import("../../labs/behaviors/mixin.js").MixinReturn<(abstract new (...args: any[]) => import("../../labs/behaviors/element-internals.js").WithElementInternals) & typeof LitElement & import("../../labs/behaviors/form-associated.js").FormAssociatedConstructor, import("../../labs/behaviors/form-associated.js").FormAssociated>, import("../../labs/behaviors/constraint-validation.js").ConstraintValidation>, import("../../labs/behaviors/on-report-validity.js").OnReportValidity>>;
+/**
+ * @fires change {Event} The native `change` event on
+ * [`<input>`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event)
+ * --bubbles
+ * @fires input {InputEvent} The native `input` event on
+ * [`<input>`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/input_event)
+ * --bubbles --composed
+ * @fires opening {Event} Fired when the select's menu is about to open.
+ * @fires opened {Event} Fired when the select's menu has finished animations
+ * and opened.
+ * @fires closing {Event} Fired when the select's menu is about to close.
+ * @fires closed {Event} Fired when the select's menu has finished animations
+ * and closed.
+ */
+export declare abstract class Select extends selectBaseClass {
+    /** @nocollapse */
+    static shadowRootOptions: {
+        delegatesFocus: boolean;
+        mode: ShadowRootMode;
+        slotAssignment?: SlotAssignmentMode;
+    };
+    /**
+     * Opens the menu synchronously with no animation.
+     */
+    quick: boolean;
+    /**
+     * Whether or not the select is required.
+     */
+    required: boolean;
+    /**
+     * The error message that replaces supporting text when `error` is true. If
+     * `errorText` is an empty string, then the supporting text will continue to
+     * show.
+     *
+     * This error message overrides the error message displayed by
+     * `reportValidity()`.
+     */
+    errorText: string;
+    /**
+     * The floating label for the field.
+     */
+    label: string;
+    /**
+     * Disables the asterisk on the floating label, when the select is
+     * required.
+     */
+    noAsterisk: boolean;
+    /**
+     * Conveys additional information below the select, such as how it should
+     * be used.
+     */
+    supportingText: string;
+    /**
+     * Gets or sets whether or not the select is in a visually invalid state.
+     *
+     * This error state overrides the error state controlled by
+     * `reportValidity()`.
+     */
+    error: boolean;
+    /**
+     * Whether or not the underlying md-menu should be position: fixed to display
+     * in a top-level manner, or position: absolute.
+     *
+     * position:fixed is useful for cases where select is inside of another
+     * element with stacking context and hidden overflows such as `md-dialog`.
+     */
+    menuPositioning: 'absolute' | 'fixed' | 'popover';
+    /**
+     * Clamps the menu-width to the width of the select.
+     */
+    clampMenuWidth: boolean;
+    /**
+     * The max time between the keystrokes of the typeahead select / menu behavior
+     * before it clears the typeahead buffer.
+     */
+    typeaheadDelay: number;
+    /**
+     * Whether or not the text field has a leading icon. Used for SSR.
+     */
+    hasLeadingIcon: boolean;
+    /**
+     * Whether or not the label is always floating and never resting
+     */
+    alwaysFloatingLabel: boolean;
+    /**
+     * Text to display in the field. Only set for SSR.
+     */
+    displayText: string;
+    /**
+     * Whether the menu should be aligned to the start or the end of the select's
+     * textbox.
+     */
+    menuAlign: 'start' | 'end';
+    /**
+     * The value of the currently selected option.
+     *
+     * Note: For SSR, set `[selected]` on the requested option and `displayText`
+     * rather than setting `value` setting `value` will incur a DOM query.
+     */
+    get value(): string;
+    set value(value: string);
+    [VALUE]: string;
+    get options(): SelectOption[];
+    /**
+     * The index of the currently selected option.
+     *
+     * Note: For SSR, set `[selected]` on the requested option and `displayText`
+     * rather than setting `selectedIndex` setting `selectedIndex` will incur a
+     * DOM query.
+     */
+    get selectedIndex(): number;
+    set selectedIndex(index: number);
+    /**
+     * Returns an array of selected options.
+     *
+     * NOTE: md-select only supports single selection.
+     */
+    get selectedOptions(): SelectOption[];
+    protected abstract readonly fieldTag: StaticValue;
+    /**
+     * Used for initializing select when the user sets the `value` directly.
+     */
+    private lastUserSetValue;
+    /**
+     * Used for initializing select when the user sets the `selectedIndex`
+     * directly.
+     */
+    private lastUserSetSelectedIndex;
+    /**
+     * Used for `input` and `change` event change detection.
+     */
+    private lastSelectedOption;
+    private lastSelectedOptionRecords;
+    /**
+     * Whether or not a native error has been reported via `reportValidity()`.
+     */
+    private nativeError;
+    /**
+     * The validation message displayed from a native error via
+     * `reportValidity()`.
+     */
+    private nativeErrorText;
+    private get hasError();
+    private focused;
+    private open;
+    private defaultFocus;
+    private readonly field;
+    private readonly menu;
+    private readonly labelEl;
+    private readonly leadingIcons;
+    private prevOpen;
+    private selectWidth;
+    constructor();
+    /**
+     * Selects an option given the value of the option, and updates MdSelect's
+     * value.
+     */
+    select(value: string): void;
+    /**
+     * Selects an option given the index of the option, and updates MdSelect's
+     * value.
+     */
+    selectIndex(index: number): void;
+    /**
+     * Reset the select to its default value.
+     */
+    reset(): void;
+    [onReportValidity](invalidEvent: Event | null): void;
+    protected update(changed: PropertyValues<Select>): void;
+    protected render(): import("lit-html").TemplateResult<1>;
+    protected firstUpdated(changed: PropertyValues<Select>): Promise<void>;
+    private getRenderClasses;
+    private renderField;
+    private renderFieldContent;
+    private renderLeadingIcon;
+    private renderTrailingIcon;
+    private renderLabel;
+    private renderMenu;
+    private renderMenuContent;
+    /**
+     * Handles opening the select on keydown and typahead selection when the menu
+     * is closed.
+     */
+    private handleKeydown;
+    private handleClick;
+    private handleFocus;
+    private handleBlur;
+    /**
+     * Handles closing the menu when the focus leaves the select's subtree.
+     */
+    private handleFocusout;
+    /**
+     * Gets a list of all selected select options as a list item record array.
+     *
+     * @return An array of selected list option records.
+     */
+    private getSelectedOptions;
+    getUpdateComplete(): Promise<boolean>;
+    /**
+     * Gets the selected options from the DOM, and updates the value and display
+     * text to the first selected option's value and headline respectively.
+     *
+     * @return Whether or not the selected option has changed since last update.
+     */
+    private updateValueAndDisplayText;
+    /**
+     * Focuses and activates the last selected item upon opening, and resets other
+     * active items.
+     */
+    private handleOpening;
+    private redispatchEvent;
+    private handleClosed;
+    /**
+     * Determines the reason for closing, and updates the UI accordingly.
+     */
+    private handleCloseMenu;
+    /**
+     * Selects a given option, deselects other options, and updates the UI.
+     *
+     * @return Whether the last selected option has changed.
+     */
+    private selectItem;
+    /**
+     * Handles updating selection when an option element requests selection via
+     * property / attribute change.
+     */
+    private handleRequestSelection;
+    /**
+     * Handles updating selection when an option element requests deselection via
+     * property / attribute change.
+     */
+    private handleRequestDeselection;
+    /**
+     * Attempts to initialize the selected option from user-settable values like
+     * SSR, setting `value`, or `selectedIndex` at startup.
+     */
+    private initUserSelection;
+    private handleIconChange;
+    /**
+     * Dispatches the `input` and `change` events.
+     */
+    private dispatchInteractionEvents;
+    private getErrorText;
+    disabled: boolean;
+    name: string;
+    [getFormValue](): string;
+    formResetCallback(): void;
+    formStateRestoreCallback(state: string): void;
+    click(): void;
+    [createValidator](): SelectValidator;
+    [getValidityAnchor](): Field;
+}
+export {};