Тип: ПодсказкаАвтозаполненияПоляВвода. Подсказка автозаполнения поля ввода. Поддерживается в мобильном и веб-клиенте. В тонком клиенте свойство игнорируется.
Полное описание, параметры и ограничения
Расширение поля формы для поля ввода.ПодсказкаАвтозаполнения (Form field extension for a text box.AutoFillHint)
Расширение поля формы для поля ввода (Form field extension for a text box)
ПодсказкаАвтозаполнения (AutoFillHint)
Доступен, начиная с версии 8.3.23.
Использование:
Чтение и запись.
Описание:
Тип: ПодсказкаАвтозаполненияПоляВвода.
Подсказка автозаполнения поля ввода.
Поддерживается в мобильном и веб-клиенте.
В тонком клиенте свойство игнорируется.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.3.23.
Методическая информация
Практические примеры
Мобильный ввод: код заказа без исправлений, email и многострочная заметка
Задаём три разные политики экранной клавиатуры для своих локальных строк. Мобильные настройки не выдаём за работающие в тонком Windows-клиенте.
Где и как запускать
Полный модуль своей управляемой общей формы УчебныеЭлементы85 → Общие формы → Уч85МобильныйВвод. Мобильный клиент собственного тестового стенда; не выполнялся.
Подготовка
Общая основа УчебныеЭлементы85: собственная новая учебная конфигурация на 8.5.1.1343, русский язык, совместимость Не использовать, управляемое приложение. Для визуального опыта нужен МОБИЛЬНЫЙ КЛИЕНТ, подключённый только к этому собственному тестовому стенду. Существующие рабочие публикации/базы не использовать. Настройка подключения пользователем — отдельная будущая подготовка, здесь ничего не разворачивалось.
Общие → Общие формы → управляемая форма Уч85МобильныйВвод. Реквизиты формы: КодЗаказа Строка(30), EmailПолучателя Строка(100), Комментарий Строка(500), ПросмотрКода Строка(1000). Нет справочников, документов, файлов или серверной отправки. АвтоматическоеСохранениеДанныхВНастройках=НеИспользовать.
Поля КодЗаказа, EmailПолучателя, Комментарий: Вид=ПолеВвода, ПутьКДанным к соответствующим реквизитам, отдельные элементы вне таблицы. Последним readonly полем Просмотр вывести ПросмотрКода. Порядок — код, email, заметка, просмотр.
ПриСозданииНаСервере формы → одноимённая процедура. Событие Открытие поля КодЗаказа → КодЗаказаОткрытие: стандартная обработка выключается, показывается только локальная строка. Команда формы Проверить и кнопка с ней → Проверить.
Основной блок — полный модуль общей формы. Дополнительный блок — модуль собственной общей команды ОткрытьУч85МобильныйВвод без параметра. Включите её в свой учебный интерфейс и роль. F7 и обновление только нового стенда.
Сначала осмотрите модуль/серверные присваивания. Реальную экранную клавиатуру и доступность кнопок проверяйте потом только в поддерживаемом мобильном клиенте. Открытие в тонком Windows-клиенте не доказывает работу мобильных свойств; ПодсказкаАвтозаполнения в нём игнорируется.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
ПроверитьСвойСтенд();
КодЗаказа = "AB12";
EmailПолучателя = "learner@example.invalid";
Комментарий = "Связаться перед доставкой";
ПросмотрКода = "";
Код = Элементы.КодЗаказа;
Код.КнопкаОткрытия = Истина;
Код.КнопкаОчистки = Истина;
Код.АвтоОтображениеКнопкиОткрытия = РежимАвтоОтображенияКнопкиОткрытия.Всегда;
Код.АвтоОтображениеКнопкиОчистки = РежимАвтоОтображенияКнопкиОчистки.ТолькоДляЗаполненного;
Код.АвтоИзменениеРегистраПриВводеТекста = АвтоИзменениеРегистраПриВводеТекста.ВсеСимволы;
Код.АвтоИсправлениеПриВводеТекста = АвтоИсправлениеПриВводеТекста.НеИспользовать;
Код.ПроверкаПравописанияПриВводеТекста = ПроверкаПравописанияПриВводеТекста.НеИспользовать;
Код.СпециальныйРежимВводаТекста = СпециальныйРежимВводаТекста.Нет;
Код.ТекстКнопкиВводаЭкраннойКлавиатуры = ТекстКнопкиВводаЭкраннойКлавиатуры.Далее;
Код.ПодсказкаАвтозаполнения = ПодсказкаАвтозаполненияПоляВвода.НеИспользовать;
Адрес = Элементы.EmailПолучателя;
Адрес.АвтоИзменениеРегистраПриВводеТекста = АвтоИзменениеРегистраПриВводеТекста.Нет;
Адрес.АвтоИсправлениеПриВводеТекста = АвтоИсправлениеПриВводеТекста.НеИспользовать;
Адрес.ПроверкаПравописанияПриВводеТекста = ПроверкаПравописанияПриВводеТекста.НеИспользовать;
Адрес.СпециальныйРежимВводаТекста = СпециальныйРежимВводаТекста.Email;
Адрес.ПодсказкаАвтозаполнения = ПодсказкаАвтозаполненияПоляВвода.Email;
Адрес.ТекстКнопкиВводаЭкраннойКлавиатуры = ТекстКнопкиВводаЭкраннойКлавиатуры.Далее;
Заметка = Элементы.Комментарий;
Заметка.МногострочныйРежим = Истина;
Заметка.ВариантУправленияВысотой = ВариантУправленияВысотойЭлемента.ПоСодержимому;
Заметка.АвтоИзменениеРегистраПриВводеТекста = АвтоИзменениеРегистраПриВводеТекста.Предложения;
Заметка.АвтоИсправлениеПриВводеТекста = АвтоИсправлениеПриВводеТекста.Использовать;
Заметка.ПроверкаПравописанияПриВводеТекста = ПроверкаПравописанияПриВводеТекста.Использовать;
Заметка.СпециальныйРежимВводаТекста = СпециальныйРежимВводаТекста.Нет;
Заметка.ТекстКнопкиВводаЭкраннойКлавиатуры = ТекстКнопкиВводаЭкраннойКлавиатуры.Готово;
Если Код.АвтоОтображениеКнопкиОткрытия <> РежимАвтоОтображенияКнопкиОткрытия.Всегда
Или Код.АвтоОтображениеКнопкиОчистки <> РежимАвтоОтображенияКнопкиОчистки.ТолькоДляЗаполненного
Или Адрес.СпециальныйРежимВводаТекста <> СпециальныйРежимВводаТекста.Email
Или Заметка.ВариантУправленияВысотой <> ВариантУправленияВысотойЭлемента.ПоСодержимому Тогда
ВызватьИсключение "Не подтвердились собственные профили полей формы";
КонецЕсли;
КонецПроцедуры
&НаСервере
Процедура ПроверитьСвойСтенд()
Если Метаданные.РежимСовместимости <> Метаданные.СвойстваОбъектов.РежимСовместимости.НеИспользовать Тогда
ВызватьИсключение "Нужен собственный учебный стенд указанной версии";
КонецЕсли;
КонецПроцедуры
&НаКлиенте
Процедура КодЗаказаОткрытие(Элемент, СтандартнаяОбработка)
СтандартнаяОбработка = Ложь;
ПросмотрКода = "Собственный локальный код: " + КодЗаказа;
КонецПроцедуры
&НаКлиенте
Процедура Проверить(Команда)
Если ТипЗнч(КодЗаказа) <> Тип("Строка") Или ТипЗнч(EmailПолучателя) <> Тип("Строка")
Или ТипЗнч(Комментарий) <> Тип("Строка") Тогда
ВызватьИсключение "Свяжите три поля со своими строковыми реквизитами";
КонецЕсли;
ПросмотрКода = СтрШаблон("Код=%1; email=%2; комментарий=%3", КодЗаказа, EmailПолучателя, Комментарий);
КонецПроцедурыОткрытьУч85МобильныйВвод
УчебныеЭлементы85 → Общие команды → ОткрытьУч85МобильныйВвод → Модуль
Полный модуль собственной общей команды; не выполнялся.
&НаКлиенте
Процедура ОбработкаКоманды(ПараметрКоманды, ПараметрыВыполненияКоманды)
ОткрытьФорму("ОбщаяФорма.Уч85МобильныйВвод");
КонецПроцедурыРазбор по шагам
Код заказа — строка, не число: AB12 и ведущие нули должны оставаться данными. ВсеСимволы запрашивает автоматический регистр при вводе, исправление и проверка правописания отключены, чтобы клавиатура не заменяла артикул словом.
Для email отключены смена регистра, исправления и орфография; специальный режим Email запрашивает подходящий ввод. Это не проверка существования адреса, не валидация формата и не отправка письма.
ПодсказкаАвтозаполнения=Email обозначает назначение поля для механизма автозаполнения. Подсказка появится только если такое автозаполнение возможно. Для кода заказа назначение НеИспользовать — пароль/OTP/адрес ему не приписываем.
Заметка многострочная. ПоСодержимому задаёт управление высотой её содержимым, Предложения и Использовать — отдельные запросы капитализации, исправления и проверки правописания. Эти три политики не подменяют друг друга.
Далее/Готово — предопределённые варианты надписи кнопки экранной клавиатуры, а не сохранение записи или вызов команды Проверить. Действительное поведение зависит от мобильного клиента, ОС и выбранной клавиатуры.
КнопкаОткрытия/КнопкаОчистки явно включены. АвтоОтображениеКнопкиОткрытия=Всегда, очистки=ТолькоДляЗаполненного: проверьте заполненный и очищенный КодЗаказа. Открытие обработано своим действием без стандартного перехода или обращения к чужим объектам.
Свойства, недоступные обычному Windows-клиенту, назначаются на сервере при создании управляемой формы. Серверная проверка присваиваний не считается проверкой мобильного изображения и событий.
Как проверить результат
Будущий ручной опыт: F7, открыть собственную форму в мобильном клиенте. Проверить начальные AB12, learner@example.invalid, Связаться перед доставкой.
Ввести свой код вручную, затем вставить текст из буфера и нажать Проверить. Сравнить значение: политика клавиатуры не является гарантированной нормализацией вставленного текста или бизнес-валидацией.
Сравнить ввод кода/email/заметки на реально выбранной клавиатуре. Для заметки добавить несколько коротких строк с пробелами и осмотреть высоту. Не обещать одинаковый вид на разных ОС.
В заполненном коде проверить очистку; после очистки осмотреть её отображение. Нажать открытие: в Просмотр должна попасть только собственная локальная строка, стандартное открытие выключено.
Не объявлять отсутствие подсказки автозаполнения ошибкой, если ОС не располагает подходящими данными. Использовать только свои вымышленные учебные значения, не реальные секреты.
Закрыть и открыть форму заново: исходные локальные строки заново инициализируются. Никакой заказ/письмо/настройка пользователя не сохраняется; runtimeVerifiedScenarios=0.
Ожидаемый результат
Будущая собственная мобильная форма разделяет политики ввода кода, email и заметки, меняет только локальные строки и показывает своё действие открытия. Мобильный запуск не проверялся.
На что обратить внимание
Пример мобильного клиента, не desktop-обещание. Настройки клавиатуры зависят от платформы/ОС; значения enum и серверные флаги не доказывают фактический внешний вид.
АвтоОтображениеКнопкиОткрытия применяется только на мобильной платформе. ПодсказкаАвтозаполнения поддерживается в мобильном/web-клиенте и игнорируется тонким клиентом; здесь визуальный опыт именно мобильный.
Надпись Готово/Далее сама по себе не сохраняет данные. Email не проверяет адрес. Автоматический регистр при вводе не является обработкой/нормализацией всех вставленных строк.
Нажатие открытия не отправляет запрос: стандартная обработка явно Ложь, код только формирует собственную строку просмотра. Ничего не подключалось, не устанавливалось и не запускалось здесь.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.