Ibyar/Aurora
    Preparing search index...

    Interface BaseFormAssociatedComponent<T>

    Custom Elements

    One of the key features of web components is the ability to create custom elements: that is, HTML elements whose behavior is defined by the web developer, that extend the set of elements available in the browser. This article introduces custom elements, and walks through some examples.

    There are two types of custom element:

    • Autonomous custom elements inherit from the HTML element base class HTMLElement. You have to implement their behavior from scratch.

    • Customized built-in elements inherit from standard HTML elements such as HTMLImageElement or HTMLParagraphElement. Their implementation extends the behavior of select instances of the standard element.

    interface BaseFormAssociatedComponent<T extends Object> {
        _detector: ChangeDetectorRef;
        _model: ModelType<T>;
        _modelScope: ReactiveControlScope<T & Context>;
        _provider: InjectionProvider;
        _render: ComponentRender<any>;
        _signalScope: SignalScope;
        _viewScope: ReactiveScope<{ this: BaseComponent<T> }>;
        _zone: AuroraZone;
        form: HTMLFormElement | null;
        internals: ElementInternals;
        valueControl?: ValueControl<T>;
        adoptedCallback(): void;
        attributeChangedCallback(name: string, oldValue: any, newValue: any): void;
        connectedCallback(): void;
        connectedMoveCallback(): void;
        disconnectedCallback(): void;
        formAssociatedCallback(form: HTMLFormElement | null): void;
        formDisabledCallback(disabled: boolean): void;
        formResetCallback(): void;
        formStateRestoreCallback(
            value: any,
            mode: "autocomplete" | "restore",
        ): void;
        getComponentRef(): ComponentRef<T>;
        getInput(viewProp: string): PropertyRef | undefined;
        getInputValue(viewProp: string): any;
        onDestroy(callback: () => void): void;
        registerValueControl(valueControl: ValueControl): void;
        setInputValue(viewProp: string, value: any): void;
    }

    Type Parameters

    • T extends Object

    Hierarchy (View Summary)

    Index
    _model: ModelType<T>
    _render: ComponentRender<any>
    _signalScope: SignalScope
    _viewScope: ReactiveScope<{ this: BaseComponent<T> }>
    _zone: AuroraZone
    form: HTMLFormElement | null
    internals: ElementInternals
    valueControl?: ValueControl<T>
    • Called after the disabled state of the element changes, either because the disabled attribute of this element was added or removed; or because the disabled state changed on a

      that's an ancestor of this element. The disabled parameter represents the new disabled state of the element. The element may, for example, disable elements in its shadow DOM when it is disabled.

      Parameters

      • disabled: boolean

      Returns void

    • Called in one of two circumstances: When the browser restores the state of the element (for example, after a navigation, or when the browser restarts). The mode argument is "restore" in this case.

      When the browser's input-assist features such as form auto filling sets a value. The mode argument is "autocomplete" in this case.

      The type of the first argument depends on how the setFormValue() method was called. For more details, see Restoring form state.

      Parameters

      • value: any
      • mode: "autocomplete" | "restore"

      Returns void