Когда для карточки полезны нативный шаблон и слоты? Разбираем клонирование, внешнее содержимое и границы компонента на чистом JavaScript.
Зачем клонировать template, если разметку можно вставить через innerHTML? Для повторяемой карточки разница проявляется в устройстве компонента: внутренний шаблон создаётся отдельно, а вызывающий код передаёт содержимое в предусмотренные слоты. Разберём этот подход на чистом JavaScript. Template и slot помогают явно разделить общую структуру и внешнее наполнение, однако управление состоянием, доступность и жизненный цикл по-прежнему требуют решений разработчика.
Содержимое template не отображается как обычная часть страницы. Его можно клонировать и использовать при создании экземпляра. В сочетании с Shadow DOM слот обозначает место, где будет показано переданное извне содержимое. Именованные слоты помогают разделить, например, заголовок и действия, а резервное содержимое используется при отсутствии подходящего заполнения. Это распределение содержимого, а не буквальное перемещение исходных узлов внутрь теневого дерева.
Небольшой компонент note-card можно устроить так:
Создать template и задать его innerHTML фиксированной доверенной строкой разработчика. Внутри разместить article, заголовок h2 с именованным слотом title и резервной подписью «Без названия», а следом — безымянный слот. Недоверенный HTML в эту строку не подставлять.
Зарегистрировать note-card методом define реестра customElements как класс, наследующий HTMLElement. В конструкторе после super() создать Shadow DOM в режиме open.
Один раз при создании экземпляра глубоко клонировать содержимое template через cloneNode(true) и добавить копию в теневой корень. У каждой карточки получится собственная внутренняя структура.
Передать содержимое дочерними узлами note-card: элемент с атрибутом slot="title" отобразится в слоте заголовка, а текстовые узлы и элементы без имени слота — в безымянном. Переданные узлы остаются в Light DOM; слот определяет место их отображения, а не перемещает их в теневое дерево.
Именованный слот и атрибут slot связываются по имени; исходный узел остаётся в Light DOM.
Контракт важнее короткой разметки
Представим карточку с изображением, заголовком и нижней областью действий. Полезный компонент заранее объясняет, какие части обязательны, что произойдёт без изображения и сколько действий помещается внизу. Слоты помогают выразить эти границы, но не принимают решение за автора. Если любое содержимое можно передать в любое место без ожидаемого поведения, повторяемая оболочка быстро становится источником исключений.
Поэтому начинать стоит с нескольких реальных вариантов использования. Короткий и длинный заголовок, отсутствие дополнительного действия, загрузка и ошибка показывают больше, чем один идеальный пример. После этого легче понять, какие области действительно нужно открыть наружу, а какие детали разумно сохранить внутри компонента.
Изоляция не отменяет ответственности
Shadow DOM помогает организовать стили, но не является границей безопасности. Также он не создаёт автоматически правильную навигацию с клавиатуры, доступные названия и ожидаемое поведение формы. Для интерактивного элемента эти свойства остаются частью работы разработчика. Красиво собранная карточка с недоступной кнопкой не становится полноценным компонентом только благодаря нативной технологии.
Отдельного внимания требует жизненный цикл. Компонент может появляться повторно, исчезать и подключаться снова; связанные обработчики и внешние подписки должны соответствовать этому поведению. Здесь полезна небольшая проверка в условиях реального приложения: переключение раздела, повторная вставка, изменение входного содержимого. Она показывает, насколько устойчивы выбранные границы.
Template и slot особенно интересны для независимых виджетов и небольших повторяемых частей интерфейса. Их ценность состоит в использовании понятных возможностей платформы и явной структуре взаимодействия. Однако решение о нативном компоненте лучше принимать по требованиям проекта, а не ради отказа от любой библиотеки. Чем точнее сформулирован контракт и чем меньше неожиданных исключений, тем легче поддерживать компонент в окружении, которое со временем будет меняться.