---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.3
alternate:
  - https://divkit.tech/docs/en/concepts/divs/2/div-fixed-length-input-mask.md
  - https://divkit.tech/docs/ru/concepts/divs/2/div-fixed-length-input-mask.md
---
> **Documentation Index:** Fetch the complete configuration index at https://divkit.tech/docs/ru/llms.txt

# div-fixed-length-input-mask
Маска для ввода текста с фиксированным количеством символов.

## Параметры
| Параметры | Описание |
| --- | --- |
| `pattern` | <p>**string**</p><p>Обязательный параметр.</p><p>Строка, которая задает шаблон для ввода текста. Например, для телефонного номера можно использовать шаблон `+7 (###) ###-##-## `.</p><p>Доступные платформы: Android, iOS, веб.</p> |
| `pattern_elements` | <p>**array**</p><p>Обязательный параметр.</p><p>Расшифровка шаблона — описание символов, вместо которых должен быть подставлен пользовательский ввод.</p><p>Массив должен быть непустым.</p><p>Доступные платформы: Android, iOS, веб.</p> |
| `raw_text_variable` | <p>**string**</p><p>Обязательный параметр.</p><p>Имя переменной для хранения необработанного значения.</p><p>Доступные платформы: Android, iOS, веб.</p> |
| `type` | <p>**string**</p><p>Обязательный параметр.</p><p>Значение всегда должно равняться `fixed_length`.</p><p>Доступные платформы: Android, iOS, веб.</p> |
| `always_visible` | <p>**bool_int**</p><p>Если опция включена, маска отображается в текстовом поле до его заполнения.</p><p>Значение по умолчанию: `false`.</p><p>Доступные платформы: Android, iOS, веб.</p> |

### pattern_element
| Параметры | Описание |
| --- | --- |
| `key` | <p>**string**</p><p>Обязательный параметр.</p><p>Символ в шаблоне, вместо которого должен быть подставлен символ, введенный пользователем.</p><p>Строка должна быть непустой.</p> |
| `placeholder` | <p>**string**</p><p>Символ, который отображается в поле ввода на месте, в котором ожидается  ввод пользовательского текста. Используется, если включено отображение маски.</p><p>Строка должна быть непустой.</p><p>Значение по умолчанию: `_`.</p> |
| `regex` | <p>**string**</p><p>Регулярное выражение для валидации вводимого символа. Например, если маска предполагает только ввод цифр.</p> |

<details>
<summary>JSON</summary>

```json
{
  type*: "fixed_length",
  always_visible: "bool_int",
  pattern*: "string",
  pattern_elements*: [
    {
      key*: "string",
      placeholder: "string",
      regex: "string"
    },
    ...
  ],
  raw_text_variable*: "string"
}
```
</details>