Поле imask

Версия: Pro.

Зачем этот тип

Телефон, ИНН или номер карты вводятся по маске: лишние символы отсекаются сразу, а не только при проверке перед публикацией. Маска задаётся в схеме поля (mask или готовый набор). Тип есть в PageBuilder Pro.

Когда использовать

• Телефон в форме обратной связи
• Артикул или серийный номер фиксированной длины
• Промокод по шаблону

Советы

Чистое число без маски: number. Значение строка с символами маски по preset.

Похожие типы

• text без ограничения формата
• url для ссылок, не телефонной маски

Настройка

{
  "name": "phone",
  "type": "imask",
  "label": "Телефон",
  "mask": "+7 (000) 000-00-00",
  "maskOptions": {
    "lazy": false
  },
  "tab": "Контент",
  "width": 100,
  "active": true
}

Значение

Строка по маске.

Данные секции

Ключ phone в данных секции: строка по маске:

{
  "phone": "+7 (495) 123-45-67"
}

Пример в chunk

modx

<a href="tel:[[+phone]]">[[+phone]]</a>

fenom

<a href="tel:{$phone|escape:'url'}">{$phone|escape}</a>

Примечание

Короткая маска: mask. Полный конфиг IMask: maskOptions (object или JSON-строка).

Общие свойства

Для полей с name, которые сохраняются в данных секции:

Ключ	Тип	Роль	Панель
tab	string	Подзаголовок группы в инспекторе	да
width	25–100	Ширина поля в % строки (flex)	да
description	string	Подсказка под подписью	да
default	any	Начальное значение новой секции	да
active	bool	false: скрыть поле в инспекторе	да
required	bool	Обязательно при publish (черновик сохраняется)	да

• Дополнительно: mask или maskOptions (JSON IMask).

Подробнее: обзор полей.

Дальше

• Справочник типов
• Обзор полей
• Pro в менеджере