FormItStateOptions
Последнее обновление not available | История страницы | Улучшить эту страницу | Сообщить о проблеме
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
$350 per month—let's make that $500!
Learn moreЧто такое FormItStateOptions?¶
FormItStateOptions это вспомогательный Сниппет для FormIt, с версии 1.7.0+, который возвращает список регионов. Это полезно для форм, которым нужен такой список.
В настоящий момент доступен переводные списки регионов для следующих стран - США, Франция, Нидерланды, Германия, Бельгия, Швеция и Канада.
Замечание: В ближайшее время появится список регионов РФ.
Какой список регионов выбрать - решается на основании значения системной переменной cultureKey, по умолчанию - регионы США (значение ключа us).
Использование¶
Просто добавьте Сниппет в вашу форму внутрь <select> элемента:
<select name="state">
[[!FormItStateOptions? &selected=`[[!+fi.state]]`]]
</select>
Обратите внимание, как мы передаем значение плейсхолдера "fi.state" (в котором хранится значение поля штата) в выбранный параметр. Это сообщает FormItStateOptions выбрать последний выбранный параметр в форме.
Свойства FormItStateOptions¶
FormItStateOptions имеет некоторые свойства по умолчанию, которые вы можете переопределить. Вот что там есть:
| Имя | Описание | По умолчанию |
|---|---|---|
| selected | Код штата/региона для отметки, что он выбран | |
| selectedAttribute | Необязательный. Атрибут HTML, добавляемый в выбранный штат. | selected="selected" |
| tpl | Необязательный. Код, используемый для каждого варианта раскрывающегося списка регионов. | |
| useAbbr | Если указано '1', для значения будет использоваться аббревиатура(код региона)). Если 0, будет использоваться полное имя | 1 |
| toPlaceholder | Необязательный. Используйте это, чтобы установить вывод в качестве плейсхолдера вместо вывода напрямую. |