Jump to main content Jump to doc navigation

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

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

  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
  • STERC
  • Jens Wittmann – Gestaltung & Entwicklung
  • Fabian Christen
  • Digital Penguin
  • Dannevang Digital
  • Sepia River Studios
  • CrewMark
  • Chris Fickling
  • deJaya
  • Following Sea
  • Anton Tarasov
  • eydolan
  • Raffy
  • Lefthandmedia
  • Murray Wood
  • Snow Creative
  • Nick Clark
  • Helen
  • JT Skaggs
  • krisznet
  • YJ
  • Yanni
  • Richard

Budget

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

Learn more