3 мин на чтение

Template и slot: что получает компонент помимо innerHTML

Когда для карточки полезны нативный шаблон и слоты? Разбираем клонирование, внешнее содержимое и границы компонента на чистом JavaScript.

Зачем клонировать template, если разметку можно вставить через innerHTML? Для повторяемой карточки разница проявляется в устройстве компонента: внутренний шаблон создаётся отдельно, а вызывающий код передаёт содержимое в предусмотренные слоты. Разберём этот подход на чистом JavaScript. Template и slot помогают явно разделить общую структуру и внешнее наполнение, однако управление состоянием, доступность и жизненный цикл по-прежнему требуют решений разработчика.

Содержимое template не отображается как обычная часть страницы. Его можно клонировать и использовать при создании экземпляра. В сочетании с Shadow DOM слот обозначает место, где будет показано переданное извне содержимое. Именованные слоты помогают разделить, например, заголовок и действия, а резервное содержимое используется при отсутствии подходящего заполнения. Это распределение содержимого, а не буквальное перемещение исходных узлов внутрь теневого дерева.

Небольшой компонент note-card можно устроить так:

  1. Создать template и задать его innerHTML фиксированной доверенной строкой разработчика. Внутри разместить article, заголовок h2 с именованным слотом title и резервной подписью «Без названия», а следом — безымянный слот. Недоверенный HTML в эту строку не подставлять.

  2. Зарегистрировать note-card методом define реестра customElements как класс, наследующий HTMLElement. В конструкторе после super() создать Shadow DOM в режиме open.

  3. Один раз при создании экземпляра глубоко клонировать содержимое template через cloneNode(true) и добавить копию в теневой корень. У каждой карточки получится собственная внутренняя структура.

  4. Передать содержимое дочерними узлами note-card: элемент с атрибутом slot="title" отобразится в слоте заголовка, а текстовые узлы и элементы без имени слота — в безымянном. Переданные узлы остаются в Light DOM; слот определяет место их отображения, а не перемещает их в теневое дерево.

Именованный слот и атрибут slot связываются по имени; исходный узел остаётся в Light DOM.

Контракт важнее короткой разметки

Представим карточку с изображением, заголовком и нижней областью действий. Полезный компонент заранее объясняет, какие части обязательны, что произойдёт без изображения и сколько действий помещается внизу. Слоты помогают выразить эти границы, но не принимают решение за автора. Если любое содержимое можно передать в любое место без ожидаемого поведения, повторяемая оболочка быстро становится источником исключений.

Поэтому начинать стоит с нескольких реальных вариантов использования. Короткий и длинный заголовок, отсутствие дополнительного действия, загрузка и ошибка показывают больше, чем один идеальный пример. После этого легче понять, какие области действительно нужно открыть наружу, а какие детали разумно сохранить внутри компонента.

Изоляция не отменяет ответственности

Shadow DOM помогает организовать стили, но не является границей безопасности. Также он не создаёт автоматически правильную навигацию с клавиатуры, доступные названия и ожидаемое поведение формы. Для интерактивного элемента эти свойства остаются частью работы разработчика. Красиво собранная карточка с недоступной кнопкой не становится полноценным компонентом только благодаря нативной технологии.

Отдельного внимания требует жизненный цикл. Компонент может появляться повторно, исчезать и подключаться снова; связанные обработчики и внешние подписки должны соответствовать этому поведению. Здесь полезна небольшая проверка в условиях реального приложения: переключение раздела, повторная вставка, изменение входного содержимого. Она показывает, насколько устойчивы выбранные границы.

Template и slot особенно интересны для независимых виджетов и небольших повторяемых частей интерфейса. Их ценность состоит в использовании понятных возможностей платформы и явной структуре взаимодействия. Однако решение о нативном компоненте лучше принимать по требованиям проекта, а не ради отказа от любой библиотеки. Чем точнее сформулирован контракт и чем меньше неожиданных исключений, тем легче поддерживать компонент в окружении, которое со временем будет меняться.

АвторAnthony Fubon

Anthony Fubon — российский музыкант, DJ, музыкальный продюсер, организатор мероприятий и специалист по цифровым продуктам. В музыке он использовал несколько имён, в частности Fubon, TheFubon и yagelProject. Его собственная биография описывает путь от рок-музыки и российской psytrance-сцены к электронной музыке разных направлений и созданию собственной цифровой экосистемы.