Типы полей

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

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

Learn more

Типы полей выполняют две задачи. Сначала они задают тип ввода (контент от пользователя) с полным контролем HTML-разметки. Затем у каждого типа есть «field rule type», который связан со свойством display. Rule type также определяет дополнительные ограничения для ввода. Например, для rule type number можно задать min и max, которые проверяются при отправке. Полный список см. в разделе rules types ниже.

Свойства¶

Ниже перечислены свойства типа поля.

Name	Description	Placeholder(s)
Name	Используется только для удобной идентификации типа. Выберите имя, понятное вам или редактору форм.
Rule Type	Rule types определяют, как процессор формы рендерит UI, и расширяют базовую валидацию. Если выбрать «Number», при добавлении поля с этим rule type появятся min и max для числа. При отправке значения проверяются. Для типа «text» можно задать min и max длины строки.
Options List	Список опций для типов selectlist, radiogroup, checkbox mulitple. Экономит время: не нужно каждый раз создавать опции в сетке. Используйте так же, как Input Options Values у TV.

Exmaple option format (label==value): Good==good||Fair==fair||Bad==bad | | | Content | HTML поля ввода в выводе. Содержит плейсхолдеры поля и даёт полный контроль над HTML-структурой. | | | Context | Ограничивает rule type конкретными контекстами. Например, можно создать набор типов полей для mobile, видимый только в mobile-контексте. По умолчанию пустое значение делает тип доступным во всех контекстах. | | | Active | Если отмечено, тип виден в выпадающем списке «rule type» при добавлении поля. | |

Placeholders¶

Список доступных плейсхолдеров для области content типа поля.

Rule Types¶

Rule types добавляют UI и логику валидации для поля. Ниже перечислены rule types с описанием.

Text		Обычно используется с input type text. Дополнительные свойства позволяют задать min и max длину строки. При указании min и/или max процессор проверяет длину.
Text Area		Стандартное textarea. Дополнительных свойств и обработки нет
Number		Поле для числового значения (только integer). Можно задать min и max. Процессор проверяет, что ввод числовой и в пределах ограничений.
Checkbox		Стандартный checkbox. Дополнительных свойств и обработки нет
Checkbox (mulitple)
Select List/Drop Down
Select Resource
Radio Group (single item)
State LIst (Two Digit)
State List (Full name)
Hidden
Button
Button - Submit
Button - Reset
Other		Обычно для описания или инструкций в форме.