Маска ввода для HTML элемента input

На этом уроке с помощью плагина masked input рассмотрим процесс создания различных масок ввода текстовым элементам формы.

Назначение плагина masked input

Плагин masked input предназначен для установления маски ввода элементу input с помощью кода JavaScript. Данный плагин для своего функционирования требует наличие подключённой библиотеки jQuery. Скачать плагин jquery.maskedinput.js (jquery.maskedinput.min) можно посредством следующей ссылки:

Демо Скачать maskedInput

Подключение плагина

После того как Вы скачали этот плагин (файл js), его необходимо подключить. Это осуществляется с помощью элемента script:

<!-- Подключение библиотеки jQuery -->
<script src="jquery.js"></script>
<!-- Подключение jQuery плагина Masked Input -->
<script src="jquery.maskedinput.min.js"></script>

Создание HTML маски ввода

Создания маски ввода осушествляется в js коде с помощью следующих знаков:

  • Цифра 9 – соответствует цифре от 0 до 9.
  • Символ a – представляет собой любой английский символ (A-Z, a-z).
  • Знак * - представляет собой любой алфавитно-цифровой символ (A-Z, a-z, 0-9).

Например рассмотрим процесс создания маски ввода телефона для элемента input, имеющего id="phone":

<!--HTML элемент, который будет иметь маску ввода телефонного номера  -->
<input  id="phone" type="text">	
<script>
//Код jQuery, установливающий маску для ввода телефона элементу input
//1. После загрузки страницы,  когда все элементы будут доступны выполнить...
$(function(){
  //2. Получить элемент, к которому необходимо добавить маску
  $("#phone").mask("8(999) 999-9999");
});
</script>
Создание HTML элементу input маски ввода телефона
Создание HTML элементу input маски ввода телефона
Внимание: По умолчанию в качестве заполнителя маски используется знак нижнего подчеркивания ('_').

Если в качестве заполнителя Вы хотите использовать что-то другое, то его можно указать посредством параметра placeholder следующим образом:

<!--HTML элемент, который будет иметь заполнитель дд.мм.гггг -->
<input  id="date" type="text">
<!--HTML элемент, который будет иметь в качестве заполнителя пробел -->
<input  id="index" type="text">
<script>
$(function() {
  //задание заполнителя с помощью параметра placeholder
  $("#date").mask("99.99.9999", {placeholder: "дд.мм.гггг" });
  //задание заполнителя с помощью параметра placeholder
  $("#index").mask("999999", {placeholder: " " });
});
</script>
Использование различных заполнителей в масках ввода masked input
Использование различных заполнителей в масках ввода masked input

Кроме placeholder данный плагин имеет ещё параметр completed. Он предназначен для задания действий, которые будут выполнятся после того как пользователь завершит ввод маски ввода.

Например, выведем с помощью метода alert сообщение пользователю, когда он завершит ввод маски телефона:

<!-- Ввод номера телефона осуществляется с помощью маски  -->
<input  id="phone" type="text">
<script>
$(function(){
  //Использование параметра completed
  $("#phone").mask("8(999) 999-9999", {
    completed: function(){ alert("Вы ввели номер: " + this.val()); }
  });
});
</script>
Сообщение, отображаемое пользователю после того как он завершил ввод маски телефона
Сообщение, отображаемое пользователю после того как он завершил ввод маски телефона

Иногда бывают такие ситуации, когда одна часть маски является обязательной для заполнения, а другая часть нет. Чтобы это указать, в Masked Input используется знак '?'. Этот знак является специальным символом, после которого необходимо разместить часть маски необязательной для заполнения.

Например, пользователю необходимо ввести число от 0 до 0.99. При этом обязательным для заполнения является указание хотя бы одного знака после запятой.

<!-- Ввод номера телефона осуществляется с помощью маски  -->
<input  id="number" type="text">
<script>
jQuery(function($){
  //создания своего специального символа для маски
  $("#number").mask("0.9?9");
});
</script>
Демонстрация работы маски для ввода числа с одним или двумя знаками после запятой
Демонстрация работы маски для ввода числа с одним или двумя знаками после запятой

Настройка маски ввода Masked Input

Плагин Masked Input позволяет использовать в маске кроме предопределенных специальных знаков (9, a, *) свои собственные.

Например, создадим для маски специальный символ ~, который при вводе должен быть заменён на знак (+) или минус (-).

<!-- HTML элемент, имеющий маску телефона -->
<input  id="number" type="text">
<script>
jQuery(function($){
  //создания специального символа для маски
  $.mask.definitions['~']='[+-]';
  $("#number).mask("~9.99");
});
</script>
Демонстрация работы маски для ввода положительного или отрицательного числа
Демонстрация работы маски для ввода положительного или отрицательного числа

Например, создадим маску для ввода CSS цвета в шестнадцатеричном формате:

<!-- HTML элемент, имеющий маску для ввода цвета в шестнадцатиричном формате -->
<input  id="color" type="text">
<script>
jQuery(function($){
  //создания специального символа h для маски
 $.mask.definitions['h']='[A-Fa-f0-9]';
  $("#color).mask("#hhhhhh");
});
</script>
Демонстрация работы маски для ввода цвета CSS в шестандцатиричном формате
Демонстрация работы маски для ввода цвета CSS в шестандцатиричном формате

Пример создания маски ввода телефона

Рассмотрим пример создания маски для ввода телефона в зависимости от выбранной страны:

<div class="form-group">
  <label for="phone">Телефон: </label>
  <select id="country" class="form-control">
    <option value="ru"><img src="">Россия +7</option>
    <option value="ua">Украина +380</option>
    <option value="by">Белоруссия +375</option>
  </select>
  <input id="phone" type="text" class="form-control">
</div>

<script>
jQuery (function ($) {  
  $(function() {
    function maskPhone() {
      var country = $('#country option:selected').val();
      switch (country) {
        case "ru":
          $("#phone").mask("+7(999) 999-99-99");
          break;
        case "ua":
          $("#phone").mask("+380(999) 999-99-99");
          break;
        case "by":
          $("#phone").mask("+375(999) 999-99-99");
          break;          
      }    
    }
    maskPhone();
    $('#country').change(function() {
      maskPhone();
    });
  });
});
</script>
Демонстрация работы маски для ввода телефона в зависимости от выбранной страны
Демонстрация работы маски для ввода телефона в зависимости от выбранной страны


   JavaScript и jQuery 0    32534 +1

Комментарии (48)

  1. Olejonok # 0
    Вопрос снимаю.
    Переопределил:
    $.mask.definitions['9'] = '';
    $.mask.definitions['n'] = '[0-9]';
    1. Olejonok # 0
      какую маску сделать для телефона начинающегося с +994?
      $("#phone").mask("+994(99) 999-99-99")
      При вводе мы видим:
      +__4(__) ___-__-__
      1. Max # +1
        Заметил странное поведение на мобильнике.
        Когда вводишь номер по маске $("#phone").mask('+7(999)999-99-99') при вводе 4 знака (первого после правой скобки), знак вводится, но курсор остаётся слева и так после каждого разделителя.
        1. Александр Мальцев # 0
          Попробовал в Chrome, ничего такого не заметил. Наверно зависит от браузера.
          1. Max # 0
            Воспроизводится
            Chrome 55.0.2883.91
            Android 7.0.0
            Sony Z5

            Воспроизводится
            Chrome 56.0.2924.87
            Android 6.0.1
            Sony Z3

            Не воспроизводится
            Chrome 50.0.2661.89
            Android 4.4.2
            SAMSUNG Galaxy Tab 4
            1. Александр Мальцев # 0
              Если критично, то попробуйте использовать другой плагин для маски: github.com/igorescobar/jQuery-Mask-Plugin
              Подключение:
              <script src="js/jquery.mask.min.js"></script>
              
              Использование:
              <input type="text" id="phone" name="phone" required="required">
              
              <!-- Сценарий JavaScript -->
              <script>
              $(function() {
                $("#phone").mask("+7(000)000-00-00", {
                  placeholder: "+7(___)___-__-__",
                  clearIfNotMatch: true
                });
              });
              </script>
              
            2. buble.gena # 0
              Тоже такая проблема есть, наблюдается на ряде телефонов, например SAMSUNG GALAXY NOTE 4
          2. Max # 0
            Приветствую!
            Не работает плагин, если элемент приехал через AJAX.
            1. Александр Мальцев # +1
              В этом случае необходимо воспользоваться одним из следующих способов:
              1. Запустить инициализацию maskedinput после добавления элемента в DOM:
              $("#id").mask("8(999) 999-9999");
              
              2. Вызвать при получении ответа (в ajax jquery — свойство success) собственное событие, например, as_complete:
              $(document).trigger('as_complete');
              
              Теперь можно будет очень просто инициализировать элемент, а именно в тот момент когда будет возникать событие as_complete:
              $(document).on('as_complete', document, function() {
                $("#phone").mask("8(999) 999-9999");
              });
              
              1. Max # 0
                Спасибо!
                Повесил событие на ajaxcomplited.

                P.S.
                Для мобильников в типе можно пользоваться тэгом tel, весьма удобный ввод становится.
            2. Химик # 0
              Здравствуйте. Подскажите, имеется ли возможность в данном плагине задать маску для числа (в определенном диапазоне). Например, от 1 до 30?
              1. Александр Мальцев # 0
                Нет, такую маску создать не получится. Можно реализовать маску для ввода 1 или 2 цифр.
                $("#id").mask("9?9");
                А потом просто проводить его валидацию:
                $('#id').keyup(function(){
                  var value = $(this).val();
                  if (parseInt(value) >= 1 && parseInt(value) <= 30) {
                    $(this).css('background-color','green');
                  } else {
                    $(this).css('background-color','red');
                  }
                });
              2. Вячеслав # 0
                Здравствуйте. Подскажите, пожалуйста, как в данном плагине реализовать, чтобы маска была видна не только при событии focus, а при загрузке страницы.
                1. Александр Мальцев # 0
                  Здравствуйте. Её можно указать, например, с помощью атрибута placeholder:
                  <input  id="phone1" type="text" class="form-control" placeholder="8(___) ___-____">
                  
                2. waelayari # 0
                  Спасибо большой заработал… еще момент как можно validate form error message field empty или error enter all digits ???
                  1. Александр Мальцев # 0
                    Если вы используете его в форме, то проверку перед отправкой можно выполнить разными путями. Например, добавить к нему атрибут
                    required="required"
                    и оставить его проверку самому браузеру. Либо написать для его валидации необходимый код на JavaScript.
                    Например, что-то такое:
                    if ($('#idэлемента').val().length!=10) {
                      // вы ввели неправильное количество символов в элемент...
                    }
                    
                  2. waelayari # 0
                    Здравствуйте, а вы можете прислать рабоче демо файлики… у мне не заработал плагин

                    спасибо
                    1. Александр Мальцев # 0
                      Здравствуйте, вот ссылка на рабочий пример: yadi.sk/d/DIxQzr8kzqSX6
                    2. Neznajka # 0
                      А можно ли задать маску для ввода дробного числа, которое может иметь 1 или 2 цифры в целой части, а в дробной — от 0 до 4 знаков?
                      Пробовал «9?9.9999» — не подходит: если программно поместить в это поле подходящее число (например 8.225), то после клика мышкой по этому полю данное число само преобразуется в 82.25 :(
                      1. Александр Мальцев # 0
                        Вам необходимо сделать 2 необязательные части. Одну слева (до точки) и одну справа (после точки). А этот плагин позволяет сделать только одну необязательную часть. Поэтому сделать с помощью masked input не получится.
                      2. Oleg # 0
                        есть похожий jquery плагин jquery.inputmask, он как раз не позволяет вводить с середины поля вводы, а автоматически ставит курсор в начало либо после последнего введенного символа
                        1. Александра # 0
                          Коллеги, добрый день,
                          Подскажите как возможно настроить поле для формы со следующим параметром:
                          Требуется вводить строго 8 цифр «99999999». Но вот количество таких наборов по 8 может быть много, из разряда:
                          99999999
                          99999999,99999999
                          99999999,99999999,99999999,99999999
                          Запятая должна ставиться сама если вводятся цифры дальше.
                          Спасибо.
                          1. Александр Мальцев # 0
                            С помощью этого плагина jQuery этого не достигнуть.
                          2. Иван # 0
                            Здравствуйте, подскажите как сделать маску для телефона +7 (xxx) xxx-xx-xx, только так чтобы если человек вбивает телефон с цифры 8, чтоб она не вбивалась первым символом, чтоб было не +7 (895) 0хх-хх-хх, а было +7 (950) ххх-хх-хх? это возможно реализовать?
                            и можно ли сделать чтоб маска была видна при фокусирование на элемент в последней версии плагина, и курсор вставал сразу после первой скобки, как в ранних версиях?
                            1. Александр Мальцев # 0
                              Этот плалин (masked input) не позволяет изменять значения маски на лету. Необходимо посмотреть что-то другое…
                            2. Чингиз # 0
                              Здравствуйте. Мне нужно создать маску типа (+994) 45 123-45-67. Это реализовал. Но дело в том, что вместо (+994) может быть (+1) или (+1234). Когда делаю маску типа (+9999) 99 999-99-99, то номер (+994)… не проходит проверку. Надеюсь смог объяснить идею. Как реализовать это?
                              1. Александр Мальцев # 0
                                А что Вам мешает воспользоваться тем, как это сделано в примере 7. Т.е. (+994), (+1) и (+1234) в виде раскрывающего списка. А остальное значение в поле.
                              2. Алексей # 0
                                Подскажите пожалуйста почему после подключения jquery.maskedinput.js перестает работать кнопка «НАВЕРХ» с таким скриптом
                                // Кнопка наверх
                                
                                    $(document).ready(function(){
                                         $(window).scroll(function () {
                                                if ($(this).scrollTop() > 50) {
                                                    $('#back-to-top').fadeIn();
                                                } else {
                                                    $('#back-to-top').fadeOut();
                                                }
                                            });
                                            // scroll body to 0px on click
                                            $('#back-to-top').click(function () {
                                                $('#back-to-top').tooltip('hide');
                                                $('body,html').animate({
                                                    scrollTop: 0
                                                }, 800);
                                                return false;
                                            });
                                     
                                            $('#back-to-top').tooltip('show');
                                     
                                    });
                                

                                из за чего конфликт? Спасибо.
                                1. Владимир # 0
                                  Здравствуйте. Выше был задан очень хороший вопрос.
                                  Как сделать так, чтобы курсор становился в начало маски автоматически? Очень важная фишка
                                  1. Евгений # 0
                                    возможно ли сделать шаблон для ввода суммы, например ввожу 1000000, а маска отрабатывает 1.000.000 или что-то подобное?
                                    1. Александр Мальцев # 0
                                      Маска нужна для того чтобы контролировать ввод, а не форматировать отображение. Это можно сделать с помощью события, которое срабатывает когда элемент теряет фокус. Например с помощью focusout или blur.
                                    2. Евгений # 0
                                      А как сделать чтоб не давать отправлять форму если телефон не соответствует маске?
                                      1. Александр Мальцев # 0
                                        Проверять свойство length на соответствие некоторому числу.
                                        Получить значение length можно следующим образом:
                                        $('#phone1').val().length
                                        
                                      2. Константин # 0
                                        Подскажите, пожалуйста, как сделать у маски с телефоном дополнительную фишку. Заключается эта фишка в том, чтобы телефон можно было вводить не откуда хочешь, а только с начала строки. Допустим, маска в инпуте такая +7 (___) ___-__-__ По умолчанию скрипт позволяет вводить цифры с любого положения. Например, после скобок или в другом месте, если поставить туда курсор. Это происходит так +7 (___) _45-_6-8_ Необходимо что-то прописать, чтобы при постановке курсора не в начало, он возвращался в начало строки автоматически и не позволял вводить цифры с неположенного места. Для чего это нужно? Экономит время посетителям сайта для повторного ввода телефона, если они его неправильно начали вводить. Очень актуально, когда заходят с мобильника.
                                        1. Даниил # 0
                                          Подскажите как сделать что бы маска была такого типа: 4444- и после тире можно написать от 0 до 5 символов.
                                          1. Александр Мальцев # 0
                                            $.mask.definitions['d']='[0-5]';
                                            $("#id").mask("4444-?ddddd");
                                            
                                            1. Cemeh # 0
                                              $("#id").mask(«4444-?ddddd»);

                                              Ограничить действие необязательных символов как-то можно?

                                              Допустим после 0-5 необзятельных нужны обязательные
                                              $("#id").mask(«4444-?ddddd!?-99»);

                                              есть какой-нибудь модификатор (условно "!?") отменяющий действие необязательности символов?

                                              т.е. после необязательных нужны "-" и два числа например.
                                              1. Александр Мальцев # 0
                                                Такой возможности нет.
                                              2. Даниил # 0
                                                Спасибо!
                                            2. Кос # 0
                                              Александр, здравствуйте. Подскажите пожалуйста, я хочу использовать маску для ввода почтового индекса. Маска индекса выглядит так: h9a-9a9, где h[L-M], 9[0-9], a[A-Z,a-z] — . Но мне надо сделать следующим образом в зависимости от того какая будет указана первая буква можно будет внести определенный диапазон цифр. К примеру, если человек введет букву M, то может вставить цифры от 0-3, а если L, то вставить от 2-5. Как то можно осуществить эту проверку? Мне надо проверять только первые три символа.

                                              Спасибо
                                              1. Александр Мальцев # 0
                                                Здравствуйте.
                                                С помощью плагина jquery.maskedinput.js это будет трудновато осуществить. Т.к. он не позволяет на лету изменять $.mask.definitions в зависимости от того какой символ Вы нажали.
                                                Попробуйте _https://github.com/RobinHerbots/jquery.inputmask. Он вроде позволяет создавать динамические маски. Или как вариант, написать свою собственную маску.
                                              2. Артем # 0
                                                Здравствуйте!
                                                Подскажите пожалуйста как сформировать маску для ввода времени, например:
                                                с 00:00 по 00:00
                                                .
                                                1. Александр Мальцев # 0
                                                  Приветствую!
                                                  Например, так:
                                                  $(function(){
                                                    $.mask.definitions['H'] = "[0-2]";
                                                    $.mask.definitions['h'] = "[0-9]";    
                                                    $.mask.definitions['M'] = "[0-5]";
                                                    $.mask.definitions['m'] = "[0-9]";
                                                    $("#id").mask("с Hh:Mm по Hh:Mm");
                                                  });
                                                  
                                                  1. Артем # 0
                                                    Александр, спасибо огромное за оперативный ответ!
                                                    Я так пробовал, такая мысль меня посетила, но проблема заключается в том, что у нас всего 23 часа, а после нашей маски доступно для ввода становиться 24, 25, 26, 27, 28, 29.
                                                    Может быть есть возможность указать интервал например с 0 по 23, для поля Hh.
                                                    1. Артем # 0
                                                      Если конкретного решения нету именно с использование маски, я придумал временное, но в целом рабочее решение :)
                                                      // Изменение поля "Время доставки" для значения "с чч" и "по чч"
                                                         $('#cargoTimeByHDelivery, #cargoTimeToHDelivery').change(function()
                                                         {
                                                      	// Идентификатор изменения
                                                      	   var cargoTimeId = this.id;
                                                      	// Значение поля для часов
                                                      	   var cargoTimeVal = this.value;
                                                      
                                                      	if (cargoTimeVal > 23)
                                                      	{
                                                      	   $('#'+cargoTimeId).val(23);
                                                       	}
                                                         });
                                                      
                                                2. Александр # 0
                                                  Не могу найти, подскажите пожалуйста. Мне надо, что бы маска была типа +7(937)___-__-__ Так как символ «9» служит для обозначения ввода цифры, то в коде прописывается: "+7(937)999-99-99". То есть пользователь видит: +7(_37)___-__-__. Как прописать уже заполненную цифру 9, а не место для ввода цифр от 0 до 9?
                                                  1. Александр Мальцев # 0
                                                    Вам необходимо переопределить определения и использовать маску следующим образом:
                                                    $.mask.definitions['9'] = '';
                                                    $.mask.definitions['n'] = '[0-9]';
                                                    $(function(){
                                                      $("#phone").mask("8(937) nnn-nnnn");
                                                    });
                                                    
                                                    1. Александр # 0
                                                      Спасибо.

                                                  Вы должны авторизоваться, чтобы оставлять комментарии.