Войти

Компонент позволяет выбрать город (CityInput)

Общая информация

Компонент позволяет выбрать регион, город или населенный пункт и сохранить в черновике. Представляет собой поле ввода с выпадающим списком подсказок, с возможностью выбора одного из вариантов

Поддерживаемые экраны

Компонент может быть задействован на экране типа:

  • Составной экран (CUSTOM)

Внешний вид компонента

В стандартной услуге

В услуге Робота Макса

в услуге.png

В конструкторе

Рисунок39.png

Структура компонента CityInput

ВКУ

JSON

В конструкторе

Атрибут

Тип

Описание

1

Идентификатор компонента

id

string

Уникальный идентификатор компонента

2

Удобочитаемое имя компонента

name

string

Допускается ввод любых данных для отображения в конструкторе, однако классическим видом является s1_с1, где номера — сгенерированные идентификаторы, s — экран, c — компонент

3

Заголовок компонента

label

string

Название поля. Описывает, что пользователю необходимо ввести в отображаемое ему поле

4

Компонент обязателен для заполнения

required

bool

Признак обязательности ввода или выбора данных в компоненте

Если выставлен — обязателен, не выставлен — не обязателен (по умолчанию)

5

Создавать заявление на экране с данным компонентом

createOrder

boolean

Если в услуге есть компонент с таким флагом, то будет создано новое заявление с новым orderId

6

Тип поиска

searchType

string

Тип поиска в зависимости от указанного значения: регион, город, населённый пункт. По умолчанию, если атрибут не указан, тип поиска город

7

Отсечение уровней адреса

cutLevels

integer

Уровни адреса, больше указанного значения, будут отсечены из адреса, выбранного в компоненте

8

Валидация

validation

array of objects

Если на экране есть несколько простых элементов и необходимо, чтобы пользователь указал хотя бы один

9

Фильтрация

cityFilter

array

Фильтр ограничивает значения, указанные в массиве, которые доступны для выбора

10

Предзаполнить регион пользователя

useBarLocation

boolean

Предзаполнение значения региона (при наличии информации в userRegion)

11

Установить зависимость с ранее введёнными данными

ref

array

Массив объектов, в элементах которых описываются зависимости и правила отображения полей

12

Идентификатор подсказки suggest

suggestionID

string

Идентификатор, используемый в механизме автозаполнения полей данными, введенными пользователем ранее

Пример JSON структуры компонента передаваемой в DTO

{

   "value":"{

  "code": "c2deb16a - 0330 - 4f05 - 821f - 1d09c93331e6",

  "address": {

    "fiasCode": "c2deb16a - 0330 - 4f05 - 821f - 1d09c93331e6",

    "fullAddress": "г Санкт - Петербург",

    "postIndex": "190000",

    "elements": [

      {

        "level": 1,

        "fiasCode": "c2deb16a - 0330 - 4f05 - 821f - 1d09c93331e6",

        "kladrCode": "7800000000000",

        "data": "Санкт - Петербург",

        "type": "город",

        "shortType": "г",

        "numericFiasCode": "78 - 0 - 000 - 000 - 000 - 000 - 0000 - 0000 - 000"

      }

    ]

  },

  "level": 1,

  "id": "c2deb16a - 0330 - 4f05 - 821f - 1d09c93331e6",

  "text": "г Санкт - Петербург",

  "error": {

    "code": 0,

    "message": "operation completed"

  },

  "dadataQc": "0",

  "dadataQcComplete": "3",

  "dadataQcHouse": "10",

  "fiasLevel": "1",

  "postalCode": "190000",

  "regionKladrId": "4400000000000",

  "okato": "40000000000",

  "tax_office": "7800",

  "oktmo": "40000000",

  "geo_lat": "59.9391313",

  "geo_lon": "30.3159004",

  "regionCode": "78"

}"

   "visited":true

}

Вариант использования

Данный компонент можно использовать в тех случаях, когда необходимы сведения только о городе, а не об адресе целиком. Например при вводе паспортных данных, когда необходимо указать место рождения

Авторизуйтесь, чтобы оставить комментарий к статье