Что такое FormItCountryOptions?
FormItCountryOptions – это вспомогательный сниппет для FormIt 1.7.0 +, который выводит список опций стран мира. Это полезно для форм, где есть необходимость в выпадающем списке стран.
Использование
Просто добавьте фрагмент в форму, в запрос <select>:
<select name="country">
[[!FormItCountryOptions? &selected=`[[!+fi.country]]`]]
</select>
Обратите внимание на то, как мы передаем значение плейсхолдера «fi.country» (который сохраняет значение поля страны) в выбранный параметр. Так FormItCountryOptions получает команду выбрать последний выбранный вариант в форме.
Свойства FormItCountryOptions
FormItCountryOptions поставляется с некоторыми свойствами по умолчанию, которые можно перезаписать. К ним относятся:
Имя |
Описание |
По умолчанию |
selected |
Значение страны для выбора. |
|
selectedAttribute |
Опционно. Атрибут HTML для добавления к выбранной стране. |
selected="selected" |
tpl |
Опционно. Чанк, который используется в опции выпадающего списка для каждой страны. |
|
useIsoCode |
Если 1, будет использоваться ISO код страны как значение. Если 0, будет использоваться название страны. |
1 |
prioritized |
Опционно. Разделенный запятыми список кодов ISO стран, который будет перемещать их в приоритетную группу «Frequent Visitors» («Частые посетители») в верхней части выпадающего меню. Это может быть применено для Ваших часто выбираемых стран. |
|
prioritizedGroupText |
Опционно. Если установлено и &prioritized в использовании, будет текстовой меткой для приоритетной опционной группы. |
|
allGroupText |
Опционно. Если установлено и &prioritized в использовании, будет текстовой меткой для опционной группы всех остальных стран. |
|
optGroupTpl |
Опционно. Если установлено и &prioritized в использовании, TPL чанк будет использоваться для разметки опционной группы. |
optgroup |
toPlaceholder |
Опционно. Используйте это, чтобы установить вывод в плейсхолдер вместо вывода напрямую. |
|
Возможно, Вам понадобится, чтобы некоторые страны появлялись в верхней части списка, в опционной группе. FormItCountryOptions поддерживает это с помощью опции &prioritized. Например:
[[!FormItCountryOptions? &selected=`[[+fi.country]]` &prioritized=`US,GB,DE,RU,JP,FR,NL,CA,AU,UA`]]
Так выводится список, который выглядит следующим образом:
Вы просто передаете ISO коды стран, которые хотите сделать приоритетными в параметре &prioritized. Вы также можете настроить текст опционной группы с помощью свойств & prioritizedGroupText и allGroupText.