ПолеВвода

Иерархия типа

graph TD;
ПолеВвода["ПолеВвода"]-->Компонент["Компонент"];
Компонент["Компонент"]-->Объект["Объект"];

Поле ввода, автоматически подстраивающееся под тип вводимых данных.

• DataType - Тип значения поля ввода

Режим множественного выбора

Для включения поля в режим множественного выбора, DataType должен быть вида Массив<Тип>, например:

Тип: ПолеВвода<Массив<Строка>>

Для включения выбора Перечисления или Справочника достаточно указать такой тип:

Тип: ПолеВвода<Массив<МойСправочник.Ссылка>>

или

Тип: ПолеВвода<Массив<МоеПеречисление>>

Для поддержки выбора значений из списка для других типов требуется заполнение свойства СписокВыбора:

Тип: ПолеВвода<Массив<Строка>>
Заголовок: Выбор строк
СписокВыбора:
    -
      Тип: ЭлементСпискаЗначений<Строка>
      Значение:
        Тип: Строка
        Значение: Строка 1
      Представление: Первая строка
    -
      Тип: ЭлементСпискаЗначений<Строка>
      Значение:
        Тип: Строка
        Значение: Строка 2
      Представление: Вторая строка

Важно! При привязке значений для свойства СписокВыбора через биндинг, следует указывать тип в DataType, как Массив<Тип?>, например:

Тип: ПолеВвода<Массив<Строка?>>
Заголовок: Выбор строк
СписокВыбора: =ПолучитьСтрокиВыбора()

Сравнение ссылочное

Конструкторы

ПолеВвода

ПолеВвода(
  Видимость: Булево,
  Доступность: Булево,
  ТолькоЧтение: Булево,
  ВыравниваниеВГруппеПоВертикали: ВыравниваниеПоВертикали,
  ВыравниваниеВГруппеПоГоризонтали: ВыравниваниеПоГоризонтали,
  ВесПриРастягивании: Число,
  Высота: Число,
  Ширина: Число,
  ШиринаВКолонках: ШиринаВКолонках,
  МаксимальнаяВысота: Число,
  МаксимальнаяШирина: Число,
  МинимальнаяВысота: Число,
  МинимальнаяШирина: Число,
  РастягиватьПоВертикали: РастягиваниеКомпонента,
  РастягиватьПоГоризонтали: РастягиваниеКомпонента,
  ПослеСоздания: ()->ничто,
  ПриПеретаскивании: (Компонент, СобытиеПриПеретаскивании)->ничто,
  Заголовок: Строка,
  ДопустимыеТипы: Множество<Тип>,
  Значение: DataType,
  НастройкиВводаДатыВремени: НастройкиВводаДатыВремени,
  НастройкиВводаДлительности: НастройкиВводаДлительности,
  НастройкиВводаСсылок: НастройкиВводаСсылок,
  НастройкиВводаСтроки: НастройкиВводаСтроки,
  НастройкиВводаЧисла: НастройкиВводаЧисла,
  ВыравниваниеСодержимогоПоГоризонтали: ВыравниваниеПоГоризонтали,
  РезервироватьМестоПодПодсказку: Булево,
  Картинка: Картинка,
  Изображение: ДвоичныйОбъект.Ссылка?,
  Коннотация: Коннотация,
  Описание: Строка,
  ПодсказкаВвода: Строка,
  ВидОтображенияКнопкиОчистки: ВидОтображения,
  ОтображатьКнопкиИзмененияЗначения: Булево,
  ПризнакОбязательности: Булево,
  РежимВыбораИзСписка: РежимВыбораИзСписка,
  РежимПароля: Булево,
  СообщениеИнформация: Строка,
  СообщениеПредупреждение: Строка,
  СообщениеОшибка: Строка,
  СообщениеУспех: Строка,
  СписокВыбора: Массив<ЭлементСпискаЗначений<DataType это Массив<неизвестно> ? DataType.ItemType : DataType>>,
  ВидСодержимогоАвтозаполнения: ВидСодержимогоАвтозаполнения,
  РежимОчистки: РежимОчисткиПоляВвода,
  ПриИзменении: (ПолеВвода<DataType>, СобытиеПриИзменении<DataType>)->ничто,
  ПриНажатииВвода: (ПолеВвода<DataType>, СобытиеКомпонента)->ничто,
  ПриАвтоПодборе: (ПолеВвода<DataType>, СобытиеПриАвтоПодборе)->ничто,
  ПриИзмененииТекстаРедактирования: (ПолеВвода<DataType>, СобытиеСДанными<Строка>)->ничто)

Создаёт компонент со значениями свойств, соответствующими параметрам конструктора.

Свойства

ВидОтображенияКнопкиОчистки

Определяет вид отображения кнопки очистки содержимого

• Если [.Всегда] – отображает кнопку очистки содержимого. Если поле не заполнено, кнопка очистки будет неактивна
• Если [.НеПоказывать] – скрывает кнопку очистки содержимого
• Если [.ПриНаведении] = [.Всегда]
• Если [.Авто]:
  • Если это мобильное устройство = [.Всегда]
  • Если это не мобильное устройство = [.НеПоказывать]

ВидСодержимогоАвтозаполнения

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

ВыравниваниеСодержимогоПоГоризонтали

Задаёт выравнивание текста в поле ввода.

ДиапазонВыделения

Содержит текущие границы выделения текста. Не образует параметр конструктора.

ДопустимыеТипы

Дополнительно ограничивает тип значения поля ввода, заданный типом параметра, на этапе исполнения кода. По-умолчанию оно принимает значение пустого множества, что означает, что допустимые типы поля ввода строго равны типу параметра поля ввода. Данное свойство может быть использовано в случаях, когда допустимые типы нужно вычислять динамически, в таком случае рекомендуется параметризовать ПолеВвода типом Объект?. Если элемент множества не может быть присвоен в тип параметра поля ввода, то он игнорируется при вычислении допустимых типов данного поля ввода. Рекомендуется использовать в исключительных случаях, когда допустимые типы не могут быть описаны при помощи типа параметра поля ввода (например, вычисляются динамически при помощи вычисляемого выражения).

Заголовок

Текст заголовка. В мобильной версии заголовок переходит в поле ПодсказкаВвода.

Значение

Текущее значение данных поля ввода.

Изображение

Адрес дополнительного изображения, отображаемого в поле ввода.

Картинка

Ссылка на внутренний компонент [Картинка], отображаемый в поле ввода. Может использоваться для дополнительного оформления картинки.

Коннотация

Коннотация поля ввода

НастройкиВводаДатыВремени

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

• Дата
• ДатаВремя
• Время
• Момент
• [ЗакрытыйДиапазон<Дата>]
• [ЗакрытыйДиапазон<Время>]
• [ЗакрытыйДиапазон<ДатаВремя>]
• [ЗакрытыйДиапазон<Момент>]

НастройкиВводаДлительности

Задаёт настройки ввода длительности. Применяются, если поле ввода редактирует тип Длительность.

НастройкиВводаСсылок

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

НастройкиВводаСтроки

Описывает настройки ввода строк.

НастройкиВводаЧисла

Задаёт настройки ввода числа. Применяются, если поле ввода редактирует тип Число.

Описание

Если указано, то напротив заголовка отображается иконка с вопросом. Нажатие на иконку показывает всплывающую подсказку с указанной строкой. Используется только в веб версии.

ОтображатьКнопкиИзмененияЗначения

Включает отображение кнопок регулирования значений в полях, которые поддерживают данный способ регулирования для типов:

• Число
• Дата
• ДатаВремя
• Время
• Справочник
• Перечисление

Кнопки отображаются по краям поля или справа от поля в зависимости от выбранного значения свойства ВыравниваниеСодержимогоПоГоризонтали:

• Если по центру – кнопки будут отображены по левому и правому краям поля
• Иначе – справа от поля рядом друг с другом

ПодсказкаВвода

Подсказка для поля ввода. Отображается внутри поля ввода, если значение не введено.

ПриАвтоПодборе

Событие возникает:

• во время ввода текста, с некоторым интервалом. При этом значение свойства Текст может быть пустым, если пользователь удалил текст в поле ввода.
• при нажатии клавиши “Стрелка вниз” или кнопки открытия списка выбора в поле. При этом значение свойства Текст может быть пустым, если вызывается, когда пользователь не начал редактировать текст в поле. Если пользователь находится в процессе редактирования текста, в событии находится этот редактируемый текст.
• при активизации поля ввода мышью. При этом значение свойства Текст может быть пустым, если вызывается, когда пользователь не начал редактировать текст в поле. Если пользователь находится в процессе редактирования текста, в событие передаётся этот редактируемый текст.

Если обработчик не установил СтандартнаяОбработка = Ложь, выполняется системная обработка - поле ввода ссылки выполняет поиск с заданными параметрами, отображается список выбора, заданный в поле, и т.д.

Если обработчик установил СтандартнаяОбработка = Ложь, стандартная системная обработка не выполняется. В списке выбора отображается коллекция элементов списка значений, заданная в свойстве ЗначенияАвтоПодбора. Если коллекция пустая, отображается текст “Ничего не найдено”, как при стандартном поиске.

Событие не вызывается при значении свойства РежимВыбораИзСписка = НеИспользовать.

ПриИзменении

Вызывается после установки нового значения в свойство Значение.

ПриИзмененииТекстаРедактирования

Возникает при изменении текущего текста редактирования в поле ввода.

ПриНажатииВвода

Вызывается при нажатии пользователем клавиши Ввод (Enter). Перед вызовом события введенные данные записываются в свойство Значение. Если запись данных невозможна по причине их некорректности (например, несоответствия маске или доступному значению из списка), то запись не происходит и событие не вызывается.

ПризнакОбязательности

Указывает - показывать ли индикатор обязательности поля - красную звёздочку перед заголовком. Никак не влияет на валидацию поля и его поведение.

РежимВыбораИзСписка

Управляет поведением списка выбора. При значении НеИспользовать не происходит вызова события ПриАвтоПодборе при наборе текста.

РежимОчистки

Управляет очисткой значения при изменении отборов, заданных в настройках ввода ссылок См. перечисление РежимОчисткиПоляВвода

РежимПароля

Включает режим пароля для поля. В таком режиме вводимые символы маскируются символами “*”.

РезервироватьМестоПодПодсказку

Указывает - резервировать ли место для сообщений, заданных в свойствах СообщениеОшибка, СообщениеИнформация, СообщениеУспех или СообщениеПредупреждение.

СообщениеИнформация

Текст описания назначения поля ввода. Отображается когда свойство Коннотация принимает значение Отсутствует.

СообщениеОшибка

Текст сообщения об ошибке заполнения данного поля ввода. Отображается только если свойство Коннотация принимает значение Отрицательная.

СообщениеПредупреждение

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

СообщениеУспех

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

СписокВыбора

Задаёт список значений для выбора. По-умолчанию пустой список. Примечание: свойство КартинкаАктивного у ЭлементСпискаЗначений используется как картинка в поле ввода, если значение поля соответствует этому элементу списка выбора, а у поля своя картинка не установлена.

ТекстРедактирования

Текущий текст редактирования в поле ввода. Обновляется через 200мс после окончания ввода текста пользователем. Не образует параметр конструктора.

Методы

УстановитьДиапазонВыделения

УстановитьДиапазонВыделения(Диапазон: ЗакрытыйДиапазон<ПозицияВТексте>)

Выделяет текст согласно указанному диапазону.

УстановитьПозициюКаретки

УстановитьПозициюКаретки(Позиция: ПозицияВТексте)

Устанавливает каретку в указанную позицию. Позиция - позиция в тексте, перед которой должна установиться каретка.

Список унаследованных методов

Объект