Поле imask

Версия: Pro (advanced-fields).

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

Телефон, ИНН или номер карты вводят по маске: лишние символы отсекаются сразу, а не только при проверке перед публикацией. Маску задают ключом mask, настройки IMask — maskOptions объектом или JSON-строкой. mask_options — тот же ключ.

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

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

Советы

Чистое число без маски: number.

Похожие типы

• 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>

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

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

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

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

Дальше

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