поле ввода номера телефона
Поле ввода номера телефона
Представляет элемент управления, который можно использовать для отображения и редактирования чисел. Он поддерживает верификацию, пошаговое добавление и последовательные вычисления основных уравнений, таких как умножение, деление, сложение и вычитание.
Получение библиотеки пользовательского интерфейса Windows
Элемент управления NumberBox требует использовать библиотеку пользовательского интерфейса Windows — пакет NuGet, который содержит новые элементы управления и компоненты пользовательского интерфейса для приложений для Windows. Дополнительные сведения, включая инструкции по установке, см. в обзорной статье о библиотеке пользовательского интерфейса Windows.
API-интерфейсы библиотеки пользовательского интерфейса Windows: Класс NumberBox
Выбор правильного элемента управления
Элемент управления NumberBox можно использовать, чтобы получать и отображать математические входные данные. Если вам нужно редактируемое текстовое поле, которое принимает больше цифр, используйте элемент управления TextBox. Если вам нужно редактируемое текстовое поле, которое принимает пароли или другие важные данные, см. PasswordBox. Если вам нужно текстовое поле для ввода поисковых запросов, см. AutoSuggestBox. Если вам нужно ввести или отредактировать отформатированный текст, см. RichEditBox.
Примеры
Если у вас есть установленное приложение XAML Controls Gallery, щелкните здесь, чтобы открыть приложение и увидеть NumberBox в действии.
Создание простого NumberBox
Вот XAML для базового NumberBox, который демонстрирует внешний вид по умолчанию. Используйте x:Bind, чтобы обеспечить синхронизацию отображаемых пользователю данных с данными, хранящимися в вашем приложении.
Добавление меток NumberBox
PlaceholderText отображается в поле NumberBox и появляется, только когда Value установлен на «не число» или когда входные данные очищены пользователем.
Включение поддержки расчетов
Установка свойства AcceptsExpression на значение true позволяет NumberBox оценивать основные линейные выражения, такие как умножение, деление, сложение и вычитание, используя стандартный порядок операций. Вычисление срабатывает при потере фокуса или при нажатии клавиши «Ввод». После вычисления выражения его первоначальная форма не сохраняется.
Шаги увеличения и уменьшения
Включение проверки входных данных
Настройка ValidationMode на InvalidInputOverwritten позволит NumberBox перезаписать недействительный ввод, который не является ни числовой, ни формальной формулой с последним действительным значением, когда при потере фокуса или нажатии клавиши «Ввод» активируется функция вычисления.
В отношении десятичных точек и запятых используемое пользователем форматирование будет заменено форматированием, настроенным для NumberBox. Ошибка проверки ввода не будет активирована.
Форматирование входных данных
Ниже приведен пример использования DecimalFormatter для форматирования значения NumberBox с одним целым числом, двумя числами дробной части и округлением до ближайшего 0,25:
В отношении десятичных точек и запятых используемое пользователем форматирование будет заменено форматированием, настроенным для NumberBox. Ошибка проверки ввода не будет активирована.
Замечания
Область ввода
Number будет использоваться для области ввода. Эта область ввода предназначена для работы с числами 0–9. Это можно изменить, однако альтернативные типы InputScope при этом не будут поддерживаться.
Не число
Вычисление выражения
Для вычисления выражений NumberBox использует инфиксную запись. В порядке приоритета допустимыми операторами являются:
Обратите внимание, что для переопределения правил приоритета можно использовать круглые скобки.
Поле ввода номера телефона
Despite the fact that inputs of type tel are functionally identical to standard text inputs, they do serve useful purposes; the most quickly apparent of these is that mobile browsers — especially on mobile phones — may opt to present a custom keypad optimized for entering phone numbers. Using a specific input type for telephone numbers also makes adding custom validation and handling of phone numbers more convenient.
Note: Browsers that don’t support type tel fall back to being a standard text (en-US) input.
Value
The element’s value attribute contains a DOMString that either represents a telephone number or is an empty string ( «» ).
Additional attributes
In addition to the attributes that operate on all elements regardless of their type, telephone number inputs support the following attributes:
| Attribute | Description |
|---|---|
| maxlength | The maximum length, in UTF-16 characters, to accept as a valid input |
| minlength | The minimum length that is considered valid for the field’s contents |
| pattern | A regular expression the entered value must match to pass constraint validation |
| placeholder | An example value to display inside the field when it has no value |
| readonly | A Boolean attribute which, if present, indicates that the field’s contents should not be user-editable |
| size | The number of characters wide the input field should be onscreen |
maxlength
The input will fail constraint validation if the length of the text entered into the field is greater than maxlength UTF-16 code units long.
minlength
The telephone number field will fail constraint validation if the length of the text entered into the field is fewer than minlength UTF-16 code units long.
pattern
See Pattern validation below for details and an example.
placeholder
The placeholder attribute is a string that provides a brief hint to the user as to what kind of information is expected in the field. It should be a word or short phrase that demonstrates the expected type of data, rather than an explanatory message. The text must not include carriage returns or line feeds.
If the control’s content has one directionality (LTR or RTL) but needs to present the placeholder in the opposite directionality, you can use Unicode bidirectional algorithm formatting characters to override directionality within the placeholder; see Overriding BiDi using Unicode control characters in The Unicode Bidirectional Text Algorithm for those characters.
Note: Avoid using the placeholder attribute if you can. It is not as semantically useful as other ways to explain your form, and can cause unexpected technical issues with your content. See Labels and placeholders in : The Input (Form Input) element for more information.
readonly
A Boolean attribute which, if present, means this field cannot be edited by the user. Its value can, however, still be changed by JavaScript code directly setting the HTMLInputElement value property.
Note: Because a read-only field cannot have a value, required does not have any effect on inputs with the readonly attribute also specified.
The size attribute is a numeric value indicating how many characters wide the input field should be. The value must be a number greater than zero, and the default value is 20. Since character widths vary, this may or may not be exact and should not be relied upon to be so; the resulting input may be narrower or wider than the specified number of characters, depending on the characters and the font ( font settings in use).
This does not set a limit on how many characters the user can enter into the field. It only specifies approximately how many can be seen at a time. To set an upper limit on the length of the input data, use the maxlength attribute.
Non-standard attributes
The following non-standard attributes are available to telephone number input fields. As a general rule, you should avoid using them unless it can’t be helped.
| Attribute | Description |
|---|---|
| autocorrect | Whether or not to allow autocorrect while editing this input field. Safari only. |
| mozactionhint | A string indicating the type of action that will be taken when the user presses the Enter or Return key while editing the field; this is used to determine an appropriate label for that key on a virtual keyboard. Firefox for Android only. |
Using tel inputs
Telephone numbers are a very commonly collected type of data on the web. When creating any kind of registration or e-commerce site, for example, you will likely need to ask the user for a telephone number, whether for business purposes or for emergency contact purposes. Given how commonly-entered phone numbers are, it’s unfortunate that a «one size fits all» solution for validating phone numbers is not practical.
Fortunately, you can consider the requirements of your own site and implement an appropriate level of validation yourself. See Validation, below, for details.
Custom keyboards
One of the main advantages of is that it causes mobile browsers to display a special keyboard for entering phone numbers. For example, here’s what the keypads look like on a couple of devices.
| Firefox for Android | WebKit iOS (Safari/Chrome/Firefox) |
|---|---|
 |  |
A simple tel input
In its most basic form, a tel input can be implemented like this:
Placeholders
Controlling the input size
You can control not only the physical length of the input box, but also the minimum and maximum lengths allowed for the input text itself.
Physical input element size
The physical size of the input box can be controlled using the size attribute. With it, you can specify the number of characters the input box can display at a time. In this example, for instance, the tel edit box is 20 characters wide:
Element value length
The size is separate from the length limitation on the entered telephone number. You can specify a minimum length, in characters, for the entered telephone number using the minlength attribute; similarly, use maxlength to set the maximum length of the entered telephone number.
The example below creates a 20-character wide telephone number entry box, requiring that the contents be no shorter than 9 characters and no longer than 14 characters.
Note: The above attributes do affect Validation — the above example’s inputs will count as invalid if the length of the value is less than 9 characters, or more than 14. Most browser won’t even let you enter a value over the max length.
Providing default options
As always, you can provide a default value for an tel input box by setting its value attribute:
Offering suggested values
With the element and its s in place, the browser will offer the specified values as potential values for the email address; this is typically presented as a popup or drop-down menu containing the suggestions. While the specific user experience may vary from one browser to another, typically clicking in the edit box presents a drop-down of the suggested email addresses. Then, as the user types, the list is adjusted to show only filtered matching values. Each typed character narrows down the list until the user makes a selection or types a custom value.
Here’s a screenshot of what that might look like:
Validation
As we’ve touched on before, it’s quite difficult to provide a one-size-fits-all client-side validation solution for phone numbers. So what can we do? Let’s consider some options.
Important: HTML form validation is not a substitute for server-side scripts that ensure the entered data is in the proper format before it is allowed into the database. It’s far too easy for someone to make adjustments to the HTML that allow them to bypass the validation, or to remove it entirely. It’s also possible for someone to simply bypass your HTML entirely and submit the data directly to your server. If your server-side code fails to validate the data it receives, disaster could strike when improperly-formatted data (or data which is too large, is of the wrong type, and so forth) is entered into your database.
Making telephone numbers required
You can make it so that an empty input is invalid and won’t be submitted to the server using the required attribute. For example, let’s use this HTML:
And let’s include the following CSS to highlight valid entries with a checkmark and invalid entries with a cross:
The output looks like this:
Pattern validation
If you want to further restrict entered numbers so they also have to conform to a specific pattern, you can use the pattern attribute, which takes as its value a regular expression that entered values have to match.
In this example we’ll use the same CSS as before, but our HTML is changed to look like this:
Notice how the entered value is reported as invalid unless the pattern xxx-xxx-xxxx is matched; for instance, 41-323-421 won’t be accepted. Neither will 800-MDN-ROCKS. However, 865-555-6502 will be accepted. This particular pattern is obviously only useful for certain locales — in a real application you’d probably have to vary the pattern used depending on the locale of the user.
Examples
In this example, we present a simple interface with a element that lets the user choose which country they’re in, and a set of elements to let them enter each part of their phone number; there is no reason why you can’t have multiple tel inputs.
Each input has a placeholder attribute to show a hint to sighted users about what to enter into it, a pattern to enforce a specific number of characters for the desired section, and an aria-label attribute to contain a hint to be read out to screenreader users about what to enter into it.
The example looks like this:
This is an interesting idea, which goes to show a potential solution to the problem of dealing with international phone numbers. You would have to extend the example of course to provide the correct pattern for potentially every country, which would be a lot of work, and there would still be no foolproof guarantee that the users would enter their numbers correctly.
It makes you wonder if it is worth going to all this trouble on the client-side, when you could just let the user enter their number in whatever format they wanted on the client-side and then validate and sanitize it on the server. But this choice is yours to make.
Подбор маски ввода по телефонному номеру
Введение
Обзор существующих решений
Предлагаемое решение
В результате было решено доработать привычную маску ввода так, чтобы она менялась в соответствии с текущим значением номера. Кроме того, по мере ввода номера предлагается отображать название определившейся страны. Данный подход, субъективно, должен решить все недостатки перечисленных выше решений.
С учётом того, что количество стран в мире относительно невелико, было принято решение составить список масок ввода для всех стран. В качестве источника использовались сведения, опубликованные на сайте международного союза электросвязи.
Сбор данной информации преподнёс немало сюрпризов. В процессе сбора сведений приходилось учитывать все возможные варианты телефонных номеров, в том числе внутри страны. Однако, ввиду большого количества обработанной вручную информации, возможно, в собранной базе остались неточности. С течением времени планируется вносить исправления в первоначальный набор.
Программная реализация
В качестве ядра маски ввода была использована реализация jquery.inputmask, о которой многократно упоминалось на Хабрахабр. Данный плагин сейчас активно развивается и, к тому же, спроектирован таким образом, что для него достаточно просто писать расширения. Однако в данной задаче написать такое расширение оказалось практически невозможно. Я не стал дорабатывать или переписывать исходный плагин под свои нужды, т.к. его автор продолжает активную работу над расширением функционала, в результате чего применение моих правок может оказаться проблематичным. Поэтому мне пришлось написать плагин-надстройку над основным ядром, который отслеживает (плюс перехватывает) внешние воздействия и производит модификацию данных. Для того, чтобы внедрить свои обработчики внешних воздействий до обработчиков основного плагина использовался плагина-библиотека jquery.bind-first.
Сортировка разрешённых масок ввода
Поиск подходящей маски ввода
При сравнении входного текста с очередной маской из отсортированного списка принимаются во внимание только значимые символы каждой маски. Если строка оказывается длиннее маски ввода, несмотря на то что все предшествующие символы прошли проверку, данная маска ввода считается неподходящей. В случае, если входному тексту удовлетворяет несколько масок ввода, то возвращается первая из них. Далее в найденной маске все значимые символы (в том числе нешаблонные) заменяются на шаблонный, который является комбинацией всех символов, разрешённых любым из шаблонных символов.
Обработка и перехват событий
Все события навешиваются в пространстве inputmask. Это позволяет избежать некорректного поведения при вызове inputmask после инициализации надстройки (т.к. ядро при инициализации снимает все ранее установленные обработчики в пространстве inputmask).
Пример использования
Формат списка масок
Список масок представляет собой JavaScript-массив объектов, предпочтительно с одинаковым набором свойств. Как минимум одно свойство, которое содержит маску ввода, должно присутствовать у всех объектов массива. Имя параметра, содержащего маску, может быть произвольным. Ниже представлен фрагмент такого массива:
Параметры подключения плагина
До подключения требуется загрузить и отсортировать список масок. Это делается выполнением следующей функции:
Для инициализации плагина нужно применить метод inputmasks к полю ввода:
Проектируем поле ввода «Номер телефона» для мобильных интерфейсов
Поле «Номер телефона» вместе с полем «Дата рождения» сложно сделать правильно. Есть много форматов телефонных номеров, которые пользователи могут выбирать, и они часто не уверены, какой из них корректный. Иногда пользователи даже не уверены, должны ли они указывать код страны.
Когда пользователи не уверены в правильности выбранного формата, они опасаются, что форма не примет введенные данные. Ошибка проверки из-за неверного формата номера телефона может заставить их отказаться от заполнения всей формы.
Ваши пользователи не должны задаваться вопросом, какой формат номера телефона правильный или получить ошибку проверки из-за неверного формата номера. Если это так, то поле «Номер телефона» вашей формы имеет плохой пользовательский опыт и нуждается в редизайне.
Избегайте плохих примеров и следуйте лучшим практикам, если хотите улучшить свои формы.
Сомнительный способ
Некоторые дизайнеры считают, что позволять вводить номер телефона в любом формате – решение проблемы. Это предотвратило бы ошибки проверки заполнения формы, но тогда пользователи не будут знать, какой формат они должны использовать.
Любая неопределенность для пользователя, может снизить коэффициент конверсии вашей формы. Пользователи должны быть уверены в формате номера телефона, иначе они будут беспокоиться о том, что вводимая ими информация не пройдет проверку.
Пользователям также не ясно, нужно ли указывать код страны перед номером телефона. Они могут ошибиться, введя код своей страны, когда это не требуется, что приведет к неправильному номеру телефона.
Неэффективный способ
Некоторые дизайнеры считают, что показ примера правильного формата в текстовом поле позволит решить неопределенность формата. Пользователь просто посмотрит на пример и наберет свой номер телефона в соответствующем формате.
Оказывается, пользователи замечают пример, но большинство из них не следует ему. Исследование показало, что «89% испытуемых набрали свой номер телефона в формате, отличном от приведенного примера».
Предоставление отформатированного примера не помогает, поскольку большинство пользователей игнорируют его. Это также приводит к ошибкам проверки, когда пользователь ввел номер в неправильном формате. Исследование показало, что ошибки проверки формата привели к отказу от заполнения формы.
Сложный способ
Некоторые дизайнеры говорят, что разделение строки номера телефона на отдельные текстовые поля решает проблемы с форматированием. Для американского номера у вас будет три текстовых поля. Эта практика делает форматирование правильным и последовательным, но только для американских пользователей.
Пользователи из других стран не смогут ввести данные, потому что их номера телефонов имеют другой формат и длину. Создание текстовых полей, локализованных под одну страну, не удобно для пользователей из других стран.
Отдельные текстовые поля также затрудняют ввод данных для мобильных пользователей. Тесты юзабилити показали, что многим пользователям было «трудно перемещаться между полями на мобильных устройствах». Это также затрудняет исправление введенных данных, если была допущена ошибка.
Легкий способ
Лучшая практика – это, когда пользователям даже не нужно думать о формате номера телефона или коде страны, потому что он автоматически исправляется на нужный.
Автоматическое форматирование ввода с геолокацией и маской ввода – это лучший способ представить поле «Номера телефона». Когда пользователи набирают свой номер телефона, надлежащий формат отображается без каких-либо усилий со стороны пользователя.
Пользователям не нужно вводить никаких скобок, тире, слэшей, точек или пробелов, только цифры. В поле есть одно ограничение – можно вводить только цифры, чтобы предотвратить ошибки проверки, если пользователи введут другие символы.
Геолокация страны пользователя позволяет автоматически форматировать номер телефона каждого пользователя независимо от того, откуда он. Вы также узнаете код страны пользователя, без необходимости его набора. Это означает, что для пользователя будет меньше работы, а для вас лучший коэффициент конверсии.
Код страны должен отображаться рядом с номером телефона, чтобы пользователи знали, что им не нужно вводить его. Самый интуитивный способ сделать это – отобразить значок флага страны пользователя внутри текстового поля рядом с введенными данными.
Можно разрешить пользователям изменять код страны, если они хотят ввести международный номер телефона. Нажав на значок флага, вы увидите раскрывающееся меню с кодами других стран.
Не заставляйте пользователя думать
Когда пользователи заполняют формы, они не хотят думать. Они хотят заполнить форму как можно быстрее. Разрешая пользователям вводить свой номер телефона в любом формате, вы заставляете их думать. Вместо этого, разгрузите пользователей, автоматически форматируя вводимые ими данные.
Внесение этого изменения в поле «Номер телефона» может предотвратить отказ от заполнения формы и увеличить коэффициент конверсии. Просто следуйте этим рекомендациям.