The Поле коммутатора помещает знакомый Elementor переключатель да/нет в пользовательский виджет.Один щелчок в панели и появляется значок, макет затягивается или выключается целый блок разметки.Внутри главных аддонов Виджет Строитель, Switcher - это стандартный способ сделать любую часть виджета необязательной.
Коммутатор является наиболее распространенным исходным полем для Условия: оно хранит yes когда включено, поэтому другие элементы управления могут показывать или скрывать на основе него. На переднем конце, the Механизм шаблонов Twig-синтаксиса позволяет завернуть разметку {% if my_toggle %} таким образом, тумблер управляет выходом тоже. оба руководства охватывают настройку и ограничения.
Его значение намеренно простое: строка типа yes когда переключатель включен, пустая строка, когда он выключен. Это отображается прямо на условные значения шаблона. На практике почти каждый переключатель оказывается завернутым в {% if %} блокируйте или управляйте Условиями других органов управления.
Что делает поле Switcher #
- Переключатель включения/выключения Renders Elementor на панели виджетов с собственными метками включения/выключения.
- Возвращает настраиваемую строку (по умолчанию
yes) когда включен, и пустая строка когда выключен. - Приводы
{% if %}блоки в шаблоне, поэтому разметка отображается только тогда, когда переключатель включен. - Переключает CSS-классы, например, в режиме онлайн
class="card {% if compact_mode %}is-compact{% endif %}". - Действует как обычный водитель Условия на других полях показывая или скрывая целые группы контроля.
Создание своего первого виджета? Начните с Обзор виджета-строителя, тогда возвращайся сюда.
Прежде чем начать #
- WordPress с Элементор установлен и активен.
- Мастер-аддоны для Elementor установлен и активен. Новое в плагине? Видеть руководство установки.
- Пользовательский виджет, открытый в редакторе Widget Builder Наш пример - виджет ценовой карты с именем Switcher
show_badgeэто показывает ленту “Popular” на карте.
Как добавить поле коммутатора #
Перетащите Коммутатор поле с панели полей в раздел под Содержание или Стиль вкладка. Его параметры открываются слева, как только он приземляется.
Объяснены параметры поля коммутатора #
- Этикетка: текст, показанный рядом с переключателем в Elementor, например “Show Badge”.
- Имя: уникальный идентификатор, на который ссылаются ваши шаблоны Буквы, цифры и подчеркивания только, например
show_badge. - Метка включена/Метка отключена: короткие тексты на самом тумбле, “Yes” и “No” по умолчанию.
- Возвратное значение: строка, которую поле держит во время включения,
yesпо умолчанию. Измените его, когда ваш шаблон или сценарий ожидает определенную строку. - По умолчанию: установите его на возвращаемое значение, чтобы начать включение переключателя; оставьте его пустым для начала.
Обратите внимание, что значение по умолчанию и значение возврата должны точно совпадать, чтобы переключатель начинался. Если вы измените значение возврата на enabled но оставьте по умолчанию yes, виджет падает с выключенным переключателем, и никакая ошибка не говорит вам почему.
Подключите коммутатор с помощью блока {% if %} #
Коммутатор является полем токена, но вы редко печатаете его токен самостоятельно Выкл означает пустую строку, а пустая строка является ложной в логике шаблона, поэтому естественный шаблон является условным в панели HTML:
{% if show_badge %}
<span class="pc-badge">Popular</span>
{% endif %}Переключиться, значок рендеринг.Toggle off, разметка исчезает полностью, не оставляя пустой обертки позади. тот же шаблон переключает классы без дополнительной разметки:
<article class="pc-card {% if compact_mode %}is-compact{% endif %}">Другая работа Коммутатора - вождение Условия. Любое поле в виджете может быть установлено, чтобы появиться только когда переключатель включен, поэтому переключение “Show Badge” также может выявить поле Текст значка и контроль цвета значка в панели. Это сохраняет панель короткой до тех пор, пока опция фактически не будет использована.
Осторожно: если вы явно сравниваете значение, сравните его со строкой "Возвратное значение", а не с меткой. {% if show_badge == 'yes' %} соответствует значению возврата по умолчанию; {% if show_badge == 'Yes' %} никогда не совпадает, т.к. “Yes” - это только отображаемый текст тумблера. голая правдивость, {% if show_badge %}, обходит проблему.
Используйте элемент управления переключателем в Elementor #
Добавьте свой пользовательский виджет на страницу в Elementor (перезагрузите редактор, если страница уже была открыта).Switcher отображается как стандартный переключатель Elementor под вашей меткой. нажмите его и предварительный просмотр обновляется немедленно; любые поля, обусловленные на нем, появляются или исчезают на панели одновременно.
Обычные случаи использования #
- Дополнительные значки и ленты на картах, завернутых в
{% if %}блок. - Варианты раскладки как компактный режим, применяемый как класс модификатора.
- Показать/скрыть разделы например, примечание в нижнем колонтитуле, значок или дополнительная кнопка.
- Переключатели функций для сценариев, где панель JS считывает значение для включения автовоспроизведения или анимации.
- Панельный шлюз, раскрытие группы связанных элементов управления только тогда, когда их функция включена.
Советы по работе с полем Switcher #
- Проверьте правдивость, а не ярлыки.
{% if show_badge %}это все, что нужно большинству шаблонов; состояние включения - это непустая строка, а состояние выключения - пустое. - Заверните весь дополнительный блок. Поставьте
{% if %}вокруг полной разметки включена обертка, поэтому выключенный переключатель не оставляет пустых элементов, чтобы нарушить расстояние. - Умышленно по умолчанию. Начните включение (по умолчанию = возвращаемое значение) для функций, которые требуется большинству сайтов, и выключите для дополнительных функций.
- Соедините его с условиями. Коммутатор плюс два или три условных поля читаются на панели гораздо лучше, чем пять всегда видимых элементов управления.
- Назовите это как вопрос, на который переключиться.
show_badgeиcompact_modeчитайте естественно внутри{% if %}блоки.
Часто задаваемые вопросы #
Что такое поле Switcher в Master Addons Widget Builder?
Поле "Переключатель" добавляет переключатель включения/выключения Elementor к пользовательскому виджету. Когда включено, оно удерживает строку "Возвратное значение" ("При включении")yes по умолчанию); когда выключено, он содержит пустую строку. Шаблоны обычно включают дополнительную разметку {% if field_name %} ... {% endif %} чтобы отреагировать на это.
Какое значение на самом деле хранит коммутатор?
Строка. On означает значение возврата, которое вы настроили, выключено означает пустую строку. не существует истинного/ложного логического значения, поэтому явные сравнения должны точно соответствовать значению возврата.
Как отображать разметку только при включенном переключателе?
Заверните его условным обозначением на панели HTML: {% if show_badge %}<span class="badge">Popular</span>{% endif %}. Блок вообще ничего не отображает, пока переключатель выключен.
Может ли коммутатор отображать или скрывать другие поля на панели?
Да, и это самый распространенный драйвер для того. Установите Условия на любом другом поле требовать значение Коммутатора, и эти элементы управления появляются в Элементоре только во время включения переключателя.
Почему мой чек {%, если show_badge == 'Да' %} никогда не проходит?
Потому что “Yes” - это метка переключателя в тексте, а не его значение. сохраненное значение - это возвращаемое значение, yes строчными буквами по умолчанию. Сравните с этим или просто используйте {% if show_badge %}.
Могу ли я изменить то, что поле возвращает при включении?
Да, через опцию Возвратное значение. это полезно, когда панель JS ожидает определенную строку флага, или когда вы печатаете значение непосредственно в атрибут данных.
Завершая #
Поле "Переключатель конструктора виджетов" - это наименьший элемент управления с самым широким охватом: один переключатель может одновременно добавлять разметку, менять классы и изменять форму панели с помощью условий. Объедините его с a Числовое поле для настраиваемых функций или а Поле ретранслятора чьи дополнительные опции он раскрывает Исследуйте остальные Виджеты и расширения Master Addgetsи посмотрите страница ценообразования за то, что включает каждый план.