FormItCountryOptions

Последнее обновление Apr 7th, 2021 | История страницы | Улучшить эту страницу | Сообщить о проблеме

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

Budget

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

Learn more

Что такое 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.

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