Перейти к основному содержимому

ПолеВвода

Стд::Интерфейс::ОбщиеКомпоненты::ПолеВвода<ТипДанных> Доступность: Клиент

ТипДанных: Тип значения поля ввода. Параметр типа должен иметь значение по умолчанию или Неопределено в составе типов.

Поле ввода значений разных типов. Автоматически подстраивается под тип вводимых данных.

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

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

Базовые типы: Объект, Стд::Интерфейс::Компонент

Примеры​

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

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

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

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

или

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

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

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

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

ПолеВвода​

Доступность: Клиент

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

Свойства​

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

Доступность: Клиент

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

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

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

Доступность: Клиент

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

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

Работа автозаполнения

Автозаполнение применяется, в первую очередь, для облегчения ввода пользователем своих ранее сохраненных данных. Выбрав уже известную информацию в одном поле, остальные поля, связанные по смыслу, заполнятся автоматически.

Существует три типа автозаполнения:

  • Данные для аутентификации (логин и пароль)
  • Контактная информация
  • Платежная информация

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

Например, в форме, содержащей информацию об адресе доставки, стоит обратить внимание на поля ввода, которые будут содержать значения, касающиеся контактных данных пользователя, и если такие данные существуют в списке ВидСодержимогоАвтозаполнения – уточнить этим полям их вид содержимого.

Общие рекомендации и ограничения использования форм с механизмом автозаполнения

  • Если создается форма создания нового пользователя, в которой будет задаваться в т.ч. и пароль, или форма смены пароля, указывайте полю ввода нового пароля НовыйПароль. Таким образом браузер не будет подставлять уже известных пользователей в поля логина и пароля автоматически.
  • Если создается форма для ввода контактной информации, в которой присутствует более одного адреса – описывайте поля последовательно для каждого адреса, т.е. сначала для одного, затем для другого. Это позволит браузеру разделять адреса при автозаполнении полей, когда пользователь начнет заполнять тот или иной блок адреса.
  • Для полей с выбором или в которых используются ссылочные типы, рекомендуется не устанавливать ВидСодержимогоАвтозаполнения в какое-либо значение, кроме Авто или Выключено.
  • Рекомендуется использовать БезКатегории только для тех полей, которых нет в списке возможных вариантов перечисления, но при этом подразумевается их автозаполнение. Стоит отметить, что такие значения хранятся самими браузерами в отдельном хранилище и не обладают какими-то эвристиками и возможностями, приводящие к заполнению других соседних полей в форме.
  • Выключено не гарантирует для полей форм аутентификации отключение механизма автозаполнения.
  • Механизм автозаполнения может работать неочевидно для пользователя в браузере Firefox ввиду политики использования контактной и платежной информации только на территории США.
  • Механизм автозаполнения не будет работать, если пользователь принудительно отключил его в своем браузере.
  • Поддержка тех или иных значений для автозаполнения по значению, определенному ВидСодержимогоАвтозаполнения, определяется конечным браузером.

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

Доступность: Клиент

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

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

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

Доступность: Клиент ТолькоЧтение

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

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

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

Доступность: Клиент

ДопустимыеТипы: Множество<Тип>

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

Заголовок​

Доступность: Клиент

Заголовок: Авто|Строка

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

ЗамещающийТекст​

Доступность: Клиент

ЗамещающийТекст: Авто|Строка

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

Значение​

Доступность: Клиент

Значение: ТипДанных

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

Изображение​

Доступность: Клиент

Изображение: ДвоичныйОбъект.Ссылка?

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

Картинка​

Доступность: Клиент

Картинка: Картинка

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

Команды​

Доступность: Клиент

Команды: Авто|Команда|ФрагментКомандногоИнтерфейса

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

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

Доступность: Клиент

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

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

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

Доступность: Клиент

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

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

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

Доступность: Клиент

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

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

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

Доступность: Клиент

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

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

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

Доступность: Клиент

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

Задает настройки ввода числа. Используются, если поле ввода редактирует тип Число.

Обязательное​

Доступность: Клиент

Обязательное: Авто|Булево

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

ОткрытьЗначение​

Доступность: Клиент ТолькоЧтение

ОткрытьЗначение: Команда

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

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

Доступность: Клиент

ОтображатьКнопкиИзмененияЗначения: Авто|Булево

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

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

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

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

Доступность: Клиент

ПриАвтоПодборе: (
ПолеВвода<ТипДанных>,
СобытиеПриАвтоПодборе)->ничто

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

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

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

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

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

Доступность: Клиент

ПриИзменении: (
ПолеВвода<ТипДанных>,
СобытиеПриИзменении<ТипДанных>)->ничто

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

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

Доступность: Клиент

ПриИзмененииТекстаРедактирования: (
ПолеВвода<ТипДанных>,
СобытиеСДанными<Строка>)->ничто

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

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

Доступность: Клиент

ПриНажатииВвода: (
ПолеВвода<ТипДанных>,
СобытиеКомпонента)->ничто

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

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

Доступность: Клиент

РежимВыбораИзСписка: Авто|РежимВыбораИзСписка

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

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

Доступность: Клиент

РежимОчистки: Авто|РежимОчисткиПоляВвода

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

Если Авто, то поведение определяется автоматически. На текущий момент всегда равно ПриНесоответствииНастройкам.

РежимПароля​

Доступность: Клиент

РежимПароля: Авто|Булево

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

РезервироватьМестоПодСообщение​

Доступность: Клиент

РезервироватьМестоПодСообщение: Авто|Булево

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

РезультатПроверкиДанных​

Доступность: Клиент

РезультатПроверкиДанных: Авто|РезультатПроверкиДанных

Результат проверки данных поля ввода.

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

Доступность: Клиент

СообщениеИнформация: Авто|Строка

Текст описания назначения поля ввода. Отображается когда свойство РезультатПроверкиДанных принимает значение Отсутствует.

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

Доступность: Клиент

СообщениеОшибка: Авто|Строка

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

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

Доступность: Клиент

СообщениеПредупреждение: Авто|Строка

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

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

Доступность: Клиент

СообщениеУспех: Авто|Строка

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

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

Доступность: Клиент

СписокВыбора: Массив<ЭлементСпискаЗначений<ТипДанных это Массив<неизвестно> ? ТипДанных.ItemType : ТипДанных>>

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

СправочнаяПодсказка​

Доступность: Клиент

СправочнаяПодсказка: Авто|Строка

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

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

Доступность: Клиент ТолькоЧтение

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

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

Методы​

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

Доступность: Клиент

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

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

Доступность: Клиент

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

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

Объект​

ВСтроку, ПолучитьТип, Представление

Последнее обновление