Контроллеры

тип ReactiveControllerИсточник

Reactive Controller — это объект, который позволяет организовать и повторно использовать код подкомпонентов, объединяя состояние, поведение и хуки жизненного цикла, связанные с отдельной функцией.

Импорт

import { ReactiveController } from 'lit';

Подробности

Контроллеры добавляются в компонент-хост или другой объект, реализующий интерфейс ReactiveControllerHost, с помощью метода addController(). Они могут подключаться к жизненному циклу компонентов-хостов, реализуя один или несколько обратных вызовов жизненного цикла, или инициировать обновление компонента-хоста, вызывая у хоста requestUpdate().

Методы и свойства

hostConnected(): voidИсточник

Вызывается, когда хост подключается к дереву компонентов. Для хостов пользовательских элементов это соответствует жизненному циклу connectedCallback(), который вызывается только при подключении компонента к документу.

hostDisconnected(): voidИсточник

Вызывается, когда хост отключается от дерева компонентов. Для хостов пользовательских элементов это соответствует жизненному циклу disconnectedCallback(), который вызывается, когда хост или компонент-предок отключается от документа.

hostUpdate(): voidИсточник

Вызывается во время клиентского обновления хоста непосредственно перед тем, как хост выполнит собственное обновление.

Подробности

Код в update() может зависеть от DOM, поскольку этот метод не вызывается при серверном рендеринге.

hostUpdated(): voidИсточник

Вызывается после обновления хоста, непосредственно перед вызовом хостом методов firstUpdated и updated. Не вызывается при серверном рендеринге.

тип ReactiveControllerHostИсточник

Объект, который может содержать Reactive Controllers и вызывать их обратные вызовы жизненного цикла.

Импорт

import { ReactiveControllerHost } from 'lit';

Методы и свойства

readonly updateComplete: Promise<boolean>Источник

Возвращает Promise, который разрешается после завершения обновления хоста. Значение Promise — логическое значение true, если элемент завершил обновление, не вызвав нового обновления. Результат Promise — false, если свойству было присвоено значение внутри updated(). Если Promise отклонён, во время обновления было выброшено исключение.

addController(controller): voidИсточник

Добавляет контроллер в хост, настраивая вызов методов жизненного цикла контроллера в соответствии с жизненным циклом хоста.

Параметры

controller: ReactiveController

removeController(controller): voidИсточник

Удаляет контроллер из хоста.

Параметры

controller: ReactiveController

requestUpdate(): voidИсточник

Запрашивает обновление хоста, которое выполняется асинхронно. Дождаться завершения обновления можно с помощью свойства updateComplete.