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 Текст или Выбрать поле вместо того, чтобы просить пользователей редактировать внутренние части виджетов.
- Никаких секретов. Значение попадает в выходные данные общедоступной страницы, поэтому считайте его видимым для всех, кто читает источник.
Часто задаваемые вопросы #
Что такое скрытое поле в Master Addons Widget Builder?
Поле "Скрытый" хранит фиксированное значение внутри пользовательского виджета Elementor, не отображая никакого управления на панели. Вы устанавливаете значение один раз в конструкторе, и шаблоны печатают его с {{ field_name }} в панели HTML, CSS или JS. Редакторы не могут увидеть или изменить его.
Зачем мне использовать скрытое поле вместо жесткого кодирования значения в моем HTML?
Централизация. когда одна и та же константа появляется в нескольких местах на панелях HTML, CSS и JS, одно скрытое поле сохраняет их синхронизацию, а обновление виджета позже означает изменение одного по умолчанию вместо поиска по трем панелям.
Могут ли пользователи изменить значение скрытого поля в Elementor?
Нет. поле не отображает входные данные на панели, поэтому его значение фиксируется на любом значении по умолчанию, которое вы установили в конструкторе. Для его изменения требуется редактирование виджета в самом конструкторе виджетов.
Могу ли я использовать значение Скрытого поля в условных числах шаблонов?
Да. Он ведет себя как любое текстовое значение, так что {% if widget_mode == 'compact' %} работает. Это позволяет одному определению виджета иметь внутренний переключатель, с которым пользователи никогда не взаимодействуют.
Ценность Скрытого поля частная?
Нет. он скрыт от панели редактирования, но он отображается на странице, как и любой другой токен, где любой может прочитать его в источнике страницы. не храните в нем секреты API или учетные данные.
Доступно ли поле "Скрытый" в бесплатной версии?
Поле "Скрытый" принадлежит свободному набору управления, наряду с такими основами, как Text и Textarea. Полный опыт создания виджетов с полной библиотекой полей является частью Master Addons Pro; см страница ценообразования для подробностей.
Завершая #
Поле Widget Builder Hidden решает тихую, но реальную проблему: значения виджета зависят от того, к чему не должен прикасаться ни один редактор. Определите его один раз, распечатайте его токен там, где это необходимо, и постоянные корабли с виджетом везде, где он используется. Когда значение должно быть редактируемым в конце концов, достичь видимого поля, как Номер или Текст вместо. Исследуйте остальное Виджеты и расширения Master Addgetsи посмотрите страница ценообразования за то, что включает каждый план.
