Поле ввода Input

В поле можно ввести значение с клавиатуры.

Когда использовать

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

Если нужно ввести больше 5 слов — используйте многострочное поле.

Если вводимое значение имеет определённый формат, используйте специальную версию поля:

В HTML поле ввода по умолчанию может быть разных типов — color, date, email, password, text, url и т.д. В сервисах Контура допустимо использовать только типы text и password, для остальных используйте контролы из нашей библиотеки. Потому что остальные типы из документации HTML либо не поддерживаются основными браузерами, либо предлагают внешний вид, поведение и валидации, которые будут сильно отличаться от нашего дизайна.

Описание работы

Плейсхолдер

Если из названия неочевидно, как заполнять поле, используйте плейсхолдер — подсказку, которая отображается внутри поля, пока оно не заполнено.

Плейсхолдер (от английского placeholder) — местозаполнитель. Часто используют синоним «ватермарк», но плейсхолдер — более правильное название, т. к. совпадает с соответствующим атрибутом тегов Input и Textarea.

Пустое поле с серым плейсхолдером «Подсказка»

По фокусу плейсхолдер становится светлее, а при вводе первого символа исчезает.

Сначала пустое поле с серым плейсхолдером «Подсказка», затем в фокусе: чёрная рамка, курсор и посветлевший плейсхолдер, затем после ввода буквы «К» плейсхолдер исчез

Не пишите в плейсхолдере конкретное значение, которое нужно ввести в поле. Лучше предзаполните его. Если ошибётесь, пользователь исправит.

Поле «Должность» с серым плейсхолдером «Бухгалтер»

Неправильно

Поле «Должность», предзаполненное значением «Бухгалтер»

Правильно

Не используйте плейсхолдер для указания формата и ограничений. Используйте поле с маской.

Поле «КПП» в фокусе с плейсхолдером «9 цифр»

Неправильно

Поле «КПП» в фокусе с маской из девяти серых прочерков

Правильно

Не используйте плейсхолдер для названия. В заполненном состоянии такая форма становится «слепой» — легко забыть, какое поле ты заполняешь.

Три поля без названий: у первого и третьего плейсхолдеры «ФИО» и «Компания», а в среднем поле в фокусе введено «Диадок» и плейсхолдера уже не видно

Неправильно

Три поля с названиями слева «ФИО», «Проект» и «Компания», в поле «Проект» в фокусе введено «Диадок»

Правильно

Исключение — когда нужно сэкономить место или указать на конкретное поле из группы полей.

Название «ФИО» над тремя одинаковыми пустыми полями

Неправильно

Название «ФИО» над тремя полями с плейсхолдерами «Фамилия», «Имя» и «Отчество»

Правильно

Если поле вычисляемое и вы рассчитали значение — используйте автополе.

Поле «Сумма доходов» с иконкой fx слева и рассчитанным значением «1 543 567,23»

Очистка поля

Если пользователю нужно часто очищать поле и вводить новое значение — используйте кнопку-крестик для очистки. По умолчанию, крестика в поле нет.

Поле со значением «ООО «Атомстройтех 2» и крестиком справа

Если справа есть иконка, то крестик заменит её.

Два поля с крестиком справа: пустое и с длинным цифровым кодом, обрезанным многоточием перед крестиком

Крестик показывается, когда введён хотя бы 1 символ, и пропадает, когда поле пустое.

Два поля в фокусе: в первом введён один символ и справа крестик, второе пустое, без крестика

Когда на странице много полей с крестиками, показывайте их и по ховеру, и по фокусу. Чтобы не создавалось визуального шума.

Четыре поля с названиями организаций, у всех справа крестики; третье поле в фокусе под курсором мыши, значение в последнем обрезано: «ИП Петров Иван Сергее…»

Неправильно

Те же четыре поля: крестик только у третьего поля в фокусе под курсором мыши, в последнем значение «ИП Петров Иван Сергеевич» видно целиком

Правильно

А когда поле одно, показывайте крестик всегда. Так пользователю будет удобнее целиться.

Поле поиска с иконкой лупы, запросом «Астраханские арбузы» и крестиком справа

При клике на крестик фокус переходит в поле, введённое значение стирается.

Сначала клик по крестику в поле со значением «ООО «Атомстройтех 2», затем поле пустое и в фокусе: чёрная рамка, курсор и серый плейсхолдер «Контрагент»

При наведении иконка становится темнее.

Поле со значением «1» и серым крестиком, затем под курсором мыши крестик темнее

Область нажатия по высоте равна полю ввода.

Поле со значением «1»: область нажатия крестика выделена розовым на всю высоту поля, на ней курсор мыши

Счётчик количества введённых символов

Счётчик введённых символов в обычном поле работает так же, как и в многострочном поле. Располагается справа, на той же строке, что и вводимый текст:

Три поля в фокусе, счётчик справа на строке текста: «Некомм» и серое «16»; «Некоммерческое партнёрст» и красное «−2»; длинный текст прокручен влево до «…екоммерческое партнёрство «Ато», счётчик красный «−9»

Подробнее — в гайде «Многострочное поле».

Название

Название поля пишется с заглавной буквы.

Называйте поле ввода существительным, которое указывает, что нужно ввести. Избегайте в названии слов «ваш», «введите» и подобных — они не несут смысла.

Название «Ваш номер» слева от пустого поля

Неправильно

Название «Номер» слева от пустого поля

Правильно

Не ставьте двоеточие после названия — оно создаёт лишний визуальный шум. Без него будет понятно.

Название «Номер:» с двоеточием слева от пустого поля

Неправильно

Название «Номер» без двоеточия слева от пустого поля

Правильно

Дизайн

По умолчанию радиус скругления углов 2 px и рамка поля чёрного цвета с непрозрачностью 16 %. Такой дизайн хорошо смотрится в большинстве случаев, особенно в формах с большим количеством полей.

Есть ситуации, когда небольшая кастомизация улучшает внешний вид. Типичные примеры:

  • привлечь внимание к главному сценарию,
  • синхронизировать внешний вид с контролами рядом,
  • компенсировать остроугольность других элементов страницы.
Шапка «Контур Продукт» на сером фоне: по центру поле «Поиск» в серой рамке, справа «Настройки» и пользователь «Константин», ниже белая область контента

Неправильно

Стандартное поле с обводкой и острыми краями смотрится чужеродно в шапке рядом с навигацией

Та же шапка «Контур Продукт» с белым полем «Поиск» без рамки

Правильно

Поле без обводки со скруглёнными краями здесь смотрится аккуратнее и лучше гармонирует с белой контентной частью

Размер и расположение

Поле ввода, как и кнопка, может быть трёх размеров — S, M, L.

Три размера поля со значением «Константин» и кнопки «Сохранить» рядом: Small, Medium и Large, в каждой строке поле и кнопка одной высоты

Используйте размер M и L, когда это главные контролы на странице. Например, поле поиска в справочнике.

Название поля выравнивается по базовой линии текста в поле.

Название «Имя» слева от поля со значением «Константин»: тексты стоят на одной базовой линии, она показана горизонтальной чертой

Название поля в несколько строк выравнивается по базовой линии введённого текста в поле.

Двухстрочное название «Название организации» слева от поля со значением «Константин»: первая строка названия на одной базовой линии с текстом в поле

В многострочном поле название выравнивается по базовой линии первой строки введённого в поле текста.

Название «Адрес» слева от многострочного поля с адресом «Россия, г. Екатеринбург, ул. Малопрудная, 5» в две строки: название на базовой линии первой строки

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

Широкое поле «Код» с коротким значением «ABC-123»

Неправильно

Поле «Код» по ширине значения «ABC-123»

Правильно

Узкое поле «ФИО», значение в нём обрезано: видно только «Константинополь»

Неправильно

Широкое поле «ФИО», значение «Константинопольский Константин» видно целиком

Правильно

В рамках одной формы выберите не больше четырёх ширин для полей. Так форма выглядит проще и аккуратнее.

Валидация

Поле с ошибкой подсвечивается красной рамкой.

Поле «ИНН» со значением «3489658771» в красной рамке под курсором мыши, справа подсказка «Неверный ИНН»

Подробнее — в гайде «Валидация».

Доступность

Управление клавиатурой

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

Поле в фокусе: чёрная рамка, курсор после значения «ООО «Атомстройтех 2» и серый крестик справа

Чёрная рамка фокуса не появляется, если поле находится в состоянии ошибки или предупреждения, до тех пор, пока значение в поле не будет изменено.

Допустимо переносить фокус на следующее поле не только при нажатии на Tab, но и на Enter . С полями такое поведение удобно и интуитивно понятно для пользователя.

Если поле последнее в форме, переход фокуса по Enter не происходит.