Скрытый

The Скрытое поле это единственный элемент управления в главных аддонах Виджет Строитель этот редакторы никогда не видят. Он содержит фиксированное значение, которое вы установили один раз в конструкторе, скажем, строку версии или клавишу макета. значение перемещается с виджетом и печатается через токен шаблона, но нигде на панели Элементор не отображается ввод для него.

Даже поле "Скрытое" поддерживает Условияи его сохраненная стоимость печатается через Механизм шаблонов Twig-синтаксиса как и любой другой токен, поэтому вы можете ссылаться на него {% if %} проверки по вашему шаблону. Оба руководства охватывают детали.

Это делает его подходящим домом для констант, необходимых вашему шаблону, но пользователи не должны редактировать. Все, что любопытный клиент может изменить случайно, остается недоступным. Ваши панели HTML, CSS и JS все равно могут читать его, как и любое другое значение.

Что делает Скрытое поле #

• Хранит фиксированное значение строки, определенное в конструкторе, без видимого управления в Elementor.
• Печатает, которые имеют значение в любом месте панели HTML, CSS или JS виджета {{ your_field_name }}.
• Не допускает использования констант конфигурации в пользовательском интерфейсе редактирования, поэтому их нельзя изменить на странице.
• Ведет себя как текстовое значение в логике шаблона, поэтому такие условные значения, как {% if mode == 'embed' %} работа.

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

Прежде чем начать #

• WordPress с Элементор установлен и активен.
• Мастер-аддоны для Elementor установлен и активен. Новое в плагине? Видеть руководство установки.
• Пользовательский виджет, открытый в редакторе Widget Builder Наш пример - виджет встраивания карты, где названо Скрытое поле map_style_key несет идентификатор фиксированного стиля карты, ожидаемый сценарием встраивания.

Как добавить Скрытое поле #

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

Объяснены параметры скрытого поля #

Список опций краток по замыслу:

• Этикетка: имя для вашей собственной ссылки внутри строителя. оно никогда не отображается в Elementor.
• Имя: уникальный идентификатор, на который ссылаются ваши шаблоны Буквы, цифры и подчеркивания только, например map_style_key.
• По умолчанию: значение, которое поле держит. так как нет пользовательского интерфейса, чтобы изменить его позже, это фактически значение, точка.

Подключите Скрытое поле своим токеном #

Поле "Скрытое" - это поле токена. напечатайте его точно так же, как текстовое значение, на любой из трех панелей:

<!-- HTML panel -->
<div class="ma-map" data-style="{{ map_style_key }}"></div>

// JS panel
var styleKey = "{{ map_style_key }}";
initMap(styleKey);

Логика шаблона также может ветвиться на нем. если вы отправляете два внутренних режима одного и того же виджета, скрытое поле может выбрать ветку, не раскрывая выбор:

{% if widget_mode == 'compact' %}
<div class="ma-map ma-map--compact"></div>
{% else %}
<div class="ma-map ma-map--full"></div>
{% endif %}

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

Осторожно: скрытое поле невидимо, а не секретно. Его значение по-прежнему отображается в разметке страницы или сценарии, которые посетители могут просмотреть-источник. Храните в нем закрытые ключи API и учетные данные; это для констант конфигурации, а не для секретов.

Используйте Скрытое поле в Elementor #

Добавьте свой пользовательский виджет на страницу в Elementor. панель показывает все остальные элементы управления, которые вы определили, и ничего для Скрытого поля.Это отсутствие является функцией. значение уже применяется, и визуализированный виджет отражает его с первой капли.

Обычные случаи использования #

• Клавиши раскладки этот внутренний CSS или JS разветвляется, фиксируется для каждого виджета.
• Строки версий впечатано в атрибут данных для отладки отправленных виджетов.
• Флаги режима API например, встраивать тип, который читает сценарий виджета.
• Исправлены фрагменты названий классов напечатано в разметке, чтобы семейство виджетов имело общие стилистические крючки.
• Переключатели ветвей шаблонов при экспорте одного виджета в двух внутренних вариантах.

Советы по работе со Скрытым полем #

• Назовите это так, как константа. map_style_key сообщает следующему сопровождающему, что означает токен; hidden_1 не делает.
• Установите значение по умолчанию перед сохранением. Второго шанса со стороны Элементора нет; пустой по умолчанию отображает пустую строку везде, где появляется токен.
• Цитируйте это в JS. Значение - строка, поэтому пишите var key = "{{ map_style_key }}"; с цитатами.
• Предпочитайте видимое поле, если пользователям нужен контроль. В тот момент, когда значение должно отличаться на странице, поменяйте местами скрытое поле на a Текст или Выбрать поле вместо того, чтобы просить пользователей редактировать внутренние части виджетов.
• Никаких секретов. Значение попадает в выходные данные общедоступной страницы, поэтому считайте его видимым для всех, кто читает источник.

Часто задаваемые вопросы #

Завершая #

Поле Widget Builder Hidden решает тихую, но реальную проблему: значения виджета зависят от того, к чему не должен прикасаться ни один редактор. Определите его один раз, распечатайте его токен там, где это необходимо, и постоянные корабли с виджетом везде, где он используется. Когда значение должно быть редактируемым в конце концов, достичь видимого поля, как Номер или Текст вместо. Исследуйте остальное Виджеты и расширения Master Addgetsи посмотрите страница ценообразования за то, что включает каждый план.