html-combobox-element 0.0.5 → 0.0.7

package/dist/cjs/combobox/HTML.combobox.element.d.ts

@@ -1,7 +1,9 @@
 import { HTMLComboboxOptionElement } from './HTML.combobox.option.element.js';
+import { HTMLComboboxOptionsCollection } from './HTML.combobox.options.collection.js';
 export declare class HTMLComboboxElement extends HTMLElement {
     #private;
     static OWN_IDL: Set<string>;
+    static observedAttributes: string[];
     static observerOptions: {
         childList: boolean;
     };
@@ -9,6 +11,11 @@ export declare class HTMLComboboxElement extends HTMLElement {
     static formAssociated: boolean;
     shadowRoot: ShadowRoot;
     constructor();
+    /** Texts used only by assistive technology, override them to localize. */
+    static get strings(): {
+        clearAll: string;
+        removeTag: string;
+    };
     connectedCallback(): void;
     insertBefore: <T extends Node>(node: T, referenceNode: Node | null) => T;
     appendChild: <T extends Node>(node: T) => T;
@@ -19,8 +26,9 @@ export declare class HTMLComboboxElement extends HTMLElement {
     replaceChild: <T extends Node>(newChild: Node, oldChild: T) => T;
     get changed(): boolean;
     disconnectedCallback(): void;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
     formResetCallback(): void;
-    formDisabledCallback(): void;
+    formDisabledCallback(disabled: boolean): void;
     get valueAsArray(): string[];
     get query(): string;
     set query(value: string);
@@ -37,22 +45,41 @@ export declare class HTMLComboboxElement extends HTMLElement {
     get form(): HTMLFormElement;
     get labels(): NodeList;
     get length(): number;
+    /** Like `select.length = n`: appends blank options, or removes the last ones */
+    set length(value: number);
     get multiple(): boolean;
     set multiple(value: boolean);
+    /** The options, as a live `HTMLOptionsCollection`-like list (like `select.options`) */
+    get options(): HTMLComboboxOptionsCollection;
     get required(): boolean;
     set required(value: boolean);
+    /** Index of the first selected option, or -1. Setting it selects only that option. */
+    get selectedIndex(): number;
+    set selectedIndex(value: number);
     get selectedOptions(): NodeListOf<HTMLComboboxOptionElement>;
     get type(): "select-multiple" | "select-one";
     get validationMessage(): string;
     get validity(): ValidityState;
     get willValidate(): boolean;
-    get value(): string;
-    set value(value: string);
-    checkValidity(): void;
+    get value(): string | null | undefined;
+    set value(value: string | null | undefined);
+    /** Like `select.add()`: inserts an option or optgroup before `before` (an element or an index), or at the end */
+    add(element: HTMLComboboxOptionElement | HTMLOptGroupElement, before?: HTMLElement | number | null): void;
+    checkValidity(): boolean;
     item(index: number): HTMLComboboxOptionElement;
-    reportValidity(): void;
+    /** The first option whose `id` or `name` attribute is `name` */
+    namedItem(name: string): HTMLComboboxOptionElement;
+    /**
+     * Overloaded like `select.remove()`: without an argument removes the combobox itself
+     * (`Element.remove()`), with an index removes that option.
+     */
+    remove(): void;
+    remove(index: number): void;
+    reportValidity(): boolean;
     setCustomValidity(message: string): void;
     showPicker(): void;
+    /** Closes the dropdown, if open */
+    hidePicker(): void;
     setAttribute(name: string, value: any): void;
     removeAttribute(name: string): void;
     static loadCssFromUrls(urls: string[]): void;