К содержимому
BuildNexus
К списку группы
Новости

Шаблоны BuildNexus: показывайте блоки, когда переменная заполнена

В условиях шаблонов поддерживаются ключи с точкой в имени. На примере ссылки на соцсеть показываем, как проверить переменную, скрыть пустой элемент и управлять им из Studio.
Шаблоны BuildNexus: показывайте блоки, когда переменная заполнена

В подвале сайта уже предусмотрена ссылка на соцсеть, но её адрес ещё не заполнен. Без условия посетитель увидит пустую ссылку. В шаблонах BuildNexus можно проверить переменную проекта и вывести элемент только тогда, когда значение задано — в том числе если в имени переменной есть точка.

Что изменилось в условиях шаблонов

Переменная проекта хранит общее значение для сайта: телефон, адрес, название компании или ссылку. Имена удобно группировать по смыслу: например, social.vk и contact.phone.

В выражении шаблона точка означает переход к вложенному полю. Поэтому запись var.social.vk и переменная с полным именем social.vk означают разные обращения к данным.

Для имени целиком используется доступ по ключу в квадратных скобках: var['social.vk']. Его можно поставить в условие v-if, которое определяет, попадёт ли элемент в итоговую страницу.

Пример: показать ссылку на VK после заполнения адреса

Добавьте в шаблон такой фрагмент:

<a v-if="var['social.vk']"
   href="{{ var:social.vk }}">
  VK
</a>
  • Значение пустое или переменная отсутствует: ссылка не выводится в HTML страницы.
  • Значение заполнено: ссылка появляется, а её адрес берётся из той же переменной.
  • Адрес изменили: при следующем рендере шаблон использует сохранённое новое значение.

Внутри двойных кавычек атрибута v-if имя ключа заключено в одинарные. Само имя переменной остаётся social.vk; скобки нужны в выражении шаблона.

Условие проверяет наличие значения. Корректность адреса нужно проверить отдельно: откройте предпросмотр и убедитесь, что ссылка ведёт в нужное сообщество.

Как настроить и проверить поведение

  1. Откройте раздел переменных проекта в Studio. Создайте переменную social.vk, задайте понятное название и заполните адрес сообщества.
  2. Разработчик добавляет условие в шаблон сайта или модуля. Подготовленная вёрстка дальше использует значение из редактора переменных.
  3. Сохраните изменения и проверьте заполненное значение в предпросмотре.
  4. Временно очистите значение и проверьте, что ссылка скрылась. Затем верните нужный адрес.
  5. После проверки опубликуйте подготовленные изменения сайта.

Условие обрабатывается серверным шаблоном: при пустом значении элемент исключается из HTML. После настройки владелец сайта может управлять появлением ссылки, меняя значение переменной в Studio.

Устройство общих значений и коллекций объясняется в руководстве по данным проекта.

Где ещё пригодится такой приём

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

Работа с каркасами и модулями описана в руководстве по шаблонам сайта. Другие выражения, условия и правила обращения к данным собраны в справочнике Vue-HTML.

Для правки поддерживаемых текстов и изображений непосредственно в предпросмотре также есть режим «Контент» в Studio. Условия показа элементов задаются в шаблоне.