Jump to main content Jump to doc navigation

Что такое FormItCountryOptions?

FormItCountryOptions это вспомогательный Сниппет для FormIt, начиная с версии 1.7.0, для вывода список стран мира. Это полезно для форм, которым нужен, например, раскрывающийся список стран.

В настоящий момент доступны переводные списки стран для следующих языков - английский, французский, голландский, немецкий, бельгийский и шведский.

Замечание: В ближайшее время появится список стран по-русски.

Какой язык для списка стран выбрать - решается на основании значения системной переменной cultureKey, по умолчанию - английский (значение ключа us).

Использование

Просто добавьте Сниппет в вашу форму внутрь <select> элемента:

<select name="country">
    [[!FormItCountryOptions? &selected=`[[!+fi.country]]`]]
</select>

Обратите внимание, как мы передаем значение плейсхолдера "fi.country" (в котором хранится значение поля страны) в выбранный параметр. Это сообщает FormItCountryOptions выбрать последний выбранный параметр в форме.

Свойства FormItCountryOptions

FormItCountryOptions имеет некоторые свойства по умолчанию, которые вы можете переопределить. Вот что там есть:

Имя Описание По умолчанию
selected Код страны для отметки, что она выбрана
selectedAttribute Необязательный. Атрибут HTML, добавляемый в выбранную страну. selected="selected"
tpl Необязательный. Код, используемый для каждого варианта раскрывающегося списка стран
useIsoCode If 1, для значения будет использоваться аббревиатура (код страны)). Если 0, будет использоваться полное имя 1
prioritized Необязательный. Разделенный запятыми список кодов ISO для стран, которые можно поместить в приоритетную optiongroup вверху раскрывающегося списка. Это можно использовать для часто выбираемых стран.
prioritizedGroupText Необязательный. Если установлено и используется &prioritized, будет добавлена текстовая метка для группы опций с приоритетом.
allGroupText Необязательный. Если установлено и используется &prioritized, будет добавлена текстовая метка для группы опций для всех остальных стран.
optGroupTpl Необязательный. Если установлено и используется &prioritized, будет использован этот фрагмент для разметки группы параметров. optgroup
toPlaceholder Необязательный. Используйте это, чтобы установить вывод в качестве плейсхолдера вместо вывода напрямую.

Приоритетные страны

Иногда вы хотите, чтобы определенные страны отображались вверху списка в блоке optiongroup. FormItCountryOptions поддерживает это с помощью параметра &prioritized. Например:

[[!FormItCountryOptions?
    &selected=`[[+fi.country]]`
    &prioritized=`US,GB,DE,RU,JP,FR,NL,CA,AU,UA`
]]

Будет выведен список, который выглядит так:

You simply pass the ISO codes of the countries you wish to prioritize in the &prioritized parameter. You can also adjust the text of the option groups with the &prioritizedGroupText and &allGroupText properties.

Вы просто передаете коды ISO стран, которым вы хотите присвоить приоритет, в параметре &prioritized. Вы также можете настроить текст optiogroup с помощью свойств &prioritizedGroupText и &allGroupText.

Смотрите также

  1. Хуки
    1. FormIt.Hooks.email
    2. FormIt.Hooks.FormItAutoResponder
    3. FormIt.Hooks.math
    4. FormIt.Hooks.recaptcha
    5. FormIt.Hooks.redirect
    6. FormIt.Hooks.spam
    7. FormIt.Hooks.FormItSaveForm
  2. Валидаторы
  3. FormItRetriever
  4. Руководства и примеры
    1. Пользовательский произвольный хук
    2. Пример простой формы
    3. Обработка выпадающих списков, чекбоксов и радио кнопок
    4. Использование пустого поля для защиты от спама
  5. FormItCountryOptions
  6. FormItStateOptions

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.

Backers

  • modmore
  • modmore
  • Jens Wittmann – Gestaltung & Entwicklung
  • Raffy
  • eydolan
  • Digital Penguin
  • Fabian Christen
  • Dannevang Digital
  • deJaya
  • Sepia River Studios
  • Following Sea
  • Anton Tarasov
  • Lefthandmedia
  • Nick Clark
  • Chris Fickling
  • Murray Wood
  • YJ
  • CrewMark
  • Richard

Budget

$305 per month—let's make that $500!

Learn more