Маска ввода для 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    29440 +1

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

  1. Александр 22 февраля 2016, 12:51 # 0
    Не могу найти, подскажите пожалуйста. Мне надо, что бы маска была типа +7(937)___-__-__ Так как символ «9» служит для обозначения ввода цифры, то в коде прописывается: "+7(937)999-99-99". То есть пользователь видит: +7(_37)___-__-__. Как прописать уже заполненную цифру 9, а не место для ввода цифр от 0 до 9?
    1. Александр Мальцев 22 февраля 2016, 13:50 # 0
      Вам необходимо переопределить определения и использовать маску следующим образом:
      $.mask.definitions['9'] = '';
      $.mask.definitions['n'] = '[0-9]';
      $(function(){
        $("#phone").mask("8(937) nnn-nnnn");
      });
      
      1. Александр 22 февраля 2016, 15:03 # 0
        Спасибо.
    2. Артем 08 марта 2016, 01:40 # 0
      Здравствуйте!
      Подскажите пожалуйста как сформировать маску для ввода времени, например:
      с 00:00 по 00:00
      .
      1. Александр Мальцев 08 марта 2016, 09:37 # 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. Артем 08 марта 2016, 10:55 # 0
          Александр, спасибо огромное за оперативный ответ!
          Я так пробовал, такая мысль меня посетила, но проблема заключается в том, что у нас всего 23 часа, а после нашей маски доступно для ввода становиться 24, 25, 26, 27, 28, 29.
          Может быть есть возможность указать интервал например с 0 по 23, для поля Hh.
          1. Артем 08 марта 2016, 12:21 # 0
            Если конкретного решения нету именно с использование маски, я придумал временное, но в целом рабочее решение :)
            // Изменение поля "Время доставки" для значения "с чч" и "по чч"
               $('#cargoTimeByHDelivery, #cargoTimeToHDelivery').change(function()
               {
            	// Идентификатор изменения
            	   var cargoTimeId = this.id;
            	// Значение поля для часов
            	   var cargoTimeVal = this.value;
            
            	if (cargoTimeVal > 23)
            	{
            	   $('#'+cargoTimeId).val(23);
             	}
               });
            
      2. Кос 16 апреля 2016, 20:48 # 0
        Александр, здравствуйте. Подскажите пожалуйста, я хочу использовать маску для ввода почтового индекса. Маска индекса выглядит так: h9a-9a9, где h[L-M], 9[0-9], a[A-Z,a-z] — . Но мне надо сделать следующим образом в зависимости от того какая будет указана первая буква можно будет внести определенный диапазон цифр. К примеру, если человек введет букву M, то может вставить цифры от 0-3, а если L, то вставить от 2-5. Как то можно осуществить эту проверку? Мне надо проверять только первые три символа.

        Спасибо
        1. Александр Мальцев 17 апреля 2016, 09:05 # 0
          Здравствуйте.
          С помощью плагина jquery.maskedinput.js это будет трудновато осуществить. Т.к. он не позволяет на лету изменять $.mask.definitions в зависимости от того какой символ Вы нажали.
          Попробуйте _https://github.com/RobinHerbots/jquery.inputmask. Он вроде позволяет создавать динамические маски. Или как вариант, написать свою собственную маску.
        2. Даниил 30 апреля 2016, 06:47 # 0
          Подскажите как сделать что бы маска была такого типа: 4444- и после тире можно написать от 0 до 5 символов.
          1. Александр Мальцев 01 мая 2016, 01:51 # 0
            $.mask.definitions['d']='[0-5]';
            $("#id").mask("4444-?ddddd");
            
            1. Даниил 05 мая 2016, 18:30 # 0
              Спасибо!
              1. Cemeh 06 мая 2016, 08:09 # 0
                $("#id").mask(«4444-?ddddd»);

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

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

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

                т.е. после необязательных нужны "-" и два числа например.
                1. Александр Мальцев 07 мая 2016, 09:18 # 0
                  Такой возможности нет.
            2. Константин 18 мая 2016, 17:49 # 0
              Подскажите, пожалуйста, как сделать у маски с телефоном дополнительную фишку. Заключается эта фишка в том, чтобы телефон можно было вводить не откуда хочешь, а только с начала строки. Допустим, маска в инпуте такая +7 (___) ___-__-__ По умолчанию скрипт позволяет вводить цифры с любого положения. Например, после скобок или в другом месте, если поставить туда курсор. Это происходит так +7 (___) _45-_6-8_ Необходимо что-то прописать, чтобы при постановке курсора не в начало, он возвращался в начало строки автоматически и не позволял вводить цифры с неположенного места. Для чего это нужно? Экономит время посетителям сайта для повторного ввода телефона, если они его неправильно начали вводить. Очень актуально, когда заходят с мобильника.
              1. Евгений 20 мая 2016, 09:24 # 0
                А как сделать чтоб не давать отправлять форму если телефон не соответствует маске?
                1. Александр Мальцев 23 мая 2016, 12:57 # 0
                  Проверять свойство length на соответствие некоторому числу.
                  Получить значение length можно следующим образом:
                  $('#phone1').val().length
                  
                2. Евгений 29 мая 2016, 14:04 # 0
                  возможно ли сделать шаблон для ввода суммы, например ввожу 1000000, а маска отрабатывает 1.000.000 или что-то подобное?
                  1. Александр Мальцев 31 мая 2016, 12:34 # 0
                    Маска нужна для того чтобы контролировать ввод, а не форматировать отображение. Это можно сделать с помощью события, которое срабатывает когда элемент теряет фокус. Например с помощью focusout или blur.
                  2. Владимир 15 июня 2016, 08:14 # 0
                    Здравствуйте. Выше был задан очень хороший вопрос.
                    Как сделать так, чтобы курсор становился в начало маски автоматически? Очень важная фишка
                    1. Алексей 15 июня 2016, 20:01 # 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. Чингиз 26 июня 2016, 13:02 # 0
                        Здравствуйте. Мне нужно создать маску типа (+994) 45 123-45-67. Это реализовал. Но дело в том, что вместо (+994) может быть (+1) или (+1234). Когда делаю маску типа (+9999) 99 999-99-99, то номер (+994)… не проходит проверку. Надеюсь смог объяснить идею. Как реализовать это?
                        1. Александр Мальцев 06 июля 2016, 13:49 # 0
                          А что Вам мешает воспользоваться тем, как это сделано в примере 7. Т.е. (+994), (+1) и (+1234) в виде раскрывающего списка. А остальное значение в поле.
                        2. Иван 27 июня 2016, 07:56 # 0
                          Здравствуйте, подскажите как сделать маску для телефона +7 (xxx) xxx-xx-xx, только так чтобы если человек вбивает телефон с цифры 8, чтоб она не вбивалась первым символом, чтоб было не +7 (895) 0хх-хх-хх, а было +7 (950) ххх-хх-хх? это возможно реализовать?
                          и можно ли сделать чтоб маска была видна при фокусирование на элемент в последней версии плагина, и курсор вставал сразу после первой скобки, как в ранних версиях?
                          1. Александр Мальцев 06 июля 2016, 13:44 # 0
                            Этот плалин (masked input) не позволяет изменять значения маски на лету. Необходимо посмотреть что-то другое…
                          2. Александра 05 июля 2016, 12:41 # 0
                            Коллеги, добрый день,
                            Подскажите как возможно настроить поле для формы со следующим параметром:
                            Требуется вводить строго 8 цифр «99999999». Но вот количество таких наборов по 8 может быть много, из разряда:
                            99999999
                            99999999,99999999
                            99999999,99999999,99999999,99999999
                            Запятая должна ставиться сама если вводятся цифры дальше.
                            Спасибо.
                            1. Александр Мальцев 06 октября 2016, 10:51 # 0
                              С помощью этого плагина jQuery этого не достигнуть.
                            2. Oleg 25 июля 2016, 08:28 # 0
                              есть похожий jquery плагин jquery.inputmask, он как раз не позволяет вводить с середины поля вводы, а автоматически ставит курсор в начало либо после последнего введенного символа
                              1. Neznajka 05 октября 2016, 13:26 # 0
                                А можно ли задать маску для ввода дробного числа, которое может иметь 1 или 2 цифры в целой части, а в дробной — от 0 до 4 знаков?
                                Пробовал «9?9.9999» — не подходит: если программно поместить в это поле подходящее число (например 8.225), то после клика мышкой по этому полю данное число само преобразуется в 82.25 :(
                                1. Александр Мальцев 06 октября 2016, 11:24 # 0
                                  Вам необходимо сделать 2 необязательные части. Одну слева (до точки) и одну справа (после точки). А этот плагин позволяет сделать только одну необязательную часть. Поэтому сделать с помощью masked input не получится.
                                2. waelayari 29 ноября 2016, 10:46 # 0
                                  Здравствуйте, а вы можете прислать рабоче демо файлики… у мне не заработал плагин

                                  спасибо
                                  1. Александр Мальцев 30 ноября 2016, 12:59 # 0
                                    Здравствуйте, вот ссылка на рабочий пример: yadi.sk/d/DIxQzr8kzqSX6
                                  2. waelayari 08 декабря 2016, 14:04 # 0
                                    Спасибо большой заработал… еще момент как можно validate form error message field empty или error enter all digits ???
                                    1. Александр Мальцев 11 декабря 2016, 12:12 # 0
                                      Если вы используете его в форме, то проверку перед отправкой можно выполнить разными путями. Например, добавить к нему атрибут
                                      required="required"
                                      и оставить его проверку самому браузеру. Либо написать для его валидации необходимый код на JavaScript.
                                      Например, что-то такое:
                                      if ($('#idэлемента').val().length!=10) {
                                        // вы ввели неправильное количество символов в элемент...
                                      }
                                      
                                    2. Вячеслав 20 января 2017, 10:42 # 0
                                      Здравствуйте. Подскажите, пожалуйста, как в данном плагине реализовать, чтобы маска была видна не только при событии focus, а при загрузке страницы.
                                      1. Александр Мальцев 22 января 2017, 12:43 # 0
                                        Здравствуйте. Её можно указать, например, с помощью атрибута placeholder:
                                        <input  id="phone1" type="text" class="form-control" placeholder="8(___) ___-____">
                                        
                                      2. Химик 15 февраля 2017, 10:59 # 0
                                        Здравствуйте. Подскажите, имеется ли возможность в данном плагине задать маску для числа (в определенном диапазоне). Например, от 1 до 30?
                                        1. Александр Мальцев 18 февраля 2017, 01:53 # 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');
                                            }
                                          });

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