FormItStateOptions

Последнее обновление 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

Что такое 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	Необязательный. Используйте это, чтобы установить вывод в качестве плейсхолдера вместо вывода напрямую.

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