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

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

  1. Александр # 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
        Спасибо.
    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
        Александр, здравствуйте. Подскажите пожалуйста, я хочу использовать маску для ввода почтового индекса. Маска индекса выглядит так: 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
          Подскажите как сделать что бы маска была такого типа: 4444- и после тире можно написать от 0 до 5 символов.
          1. Александр Мальцев # 0
            $.mask.definitions['d']='[0-5]';
            $("#id").mask("4444-?ddddd");
            
            1. Даниил # 0
              Спасибо!
              1. Cemeh # 0
                $("#id").mask(«4444-?ddddd»);

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

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

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

                т.е. после необязательных нужны "-" и два числа например.
                1. Александр Мальцев # 0
                  Такой возможности нет.
            2. Константин # 0
              Подскажите, пожалуйста, как сделать у маски с телефоном дополнительную фишку. Заключается эта фишка в том, чтобы телефон можно было вводить не откуда хочешь, а только с начала строки. Допустим, маска в инпуте такая +7 (___) ___-__-__ По умолчанию скрипт позволяет вводить цифры с любого положения. Например, после скобок или в другом месте, если поставить туда курсор. Это происходит так +7 (___) _45-_6-8_ Необходимо что-то прописать, чтобы при постановке курсора не в начало, он возвращался в начало строки автоматически и не позволял вводить цифры с неположенного места. Для чего это нужно? Экономит время посетителям сайта для повторного ввода телефона, если они его неправильно начали вводить. Очень актуально, когда заходят с мобильника.
              1. Евгений # 0
                А как сделать чтоб не давать отправлять форму если телефон не соответствует маске?
                1. Александр Мальцев # 0
                  Проверять свойство length на соответствие некоторому числу.
                  Получить значение length можно следующим образом:
                  $('#phone1').val().length
                  
                2. Евгений # 0
                  возможно ли сделать шаблон для ввода суммы, например ввожу 1000000, а маска отрабатывает 1.000.000 или что-то подобное?
                  1. Александр Мальцев # 0
                    Маска нужна для того чтобы контролировать ввод, а не форматировать отображение. Это можно сделать с помощью события, которое срабатывает когда элемент теряет фокус. Например с помощью focusout или blur.
                  2. Владимир # 0
                    Здравствуйте. Выше был задан очень хороший вопрос.
                    Как сделать так, чтобы курсор становился в начало маски автоматически? Очень важная фишка
                    1. Алексей # 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
                        Здравствуйте. Мне нужно создать маску типа (+994) 45 123-45-67. Это реализовал. Но дело в том, что вместо (+994) может быть (+1) или (+1234). Когда делаю маску типа (+9999) 99 999-99-99, то номер (+994)… не проходит проверку. Надеюсь смог объяснить идею. Как реализовать это?
                        1. Александр Мальцев # 0
                          А что Вам мешает воспользоваться тем, как это сделано в примере 7. Т.е. (+994), (+1) и (+1234) в виде раскрывающего списка. А остальное значение в поле.
                        2. Иван # 0
                          Здравствуйте, подскажите как сделать маску для телефона +7 (xxx) xxx-xx-xx, только так чтобы если человек вбивает телефон с цифры 8, чтоб она не вбивалась первым символом, чтоб было не +7 (895) 0хх-хх-хх, а было +7 (950) ххх-хх-хх? это возможно реализовать?
                          и можно ли сделать чтоб маска была видна при фокусирование на элемент в последней версии плагина, и курсор вставал сразу после первой скобки, как в ранних версиях?
                          1. Александр Мальцев # 0
                            Этот плалин (masked input) не позволяет изменять значения маски на лету. Необходимо посмотреть что-то другое…
                          2. Александра # 0
                            Коллеги, добрый день,
                            Подскажите как возможно настроить поле для формы со следующим параметром:
                            Требуется вводить строго 8 цифр «99999999». Но вот количество таких наборов по 8 может быть много, из разряда:
                            99999999
                            99999999,99999999
                            99999999,99999999,99999999,99999999
                            Запятая должна ставиться сама если вводятся цифры дальше.
                            Спасибо.
                            1. Александр Мальцев # 0
                              С помощью этого плагина jQuery этого не достигнуть.
                            2. Oleg # 0
                              есть похожий jquery плагин jquery.inputmask, он как раз не позволяет вводить с середины поля вводы, а автоматически ставит курсор в начало либо после последнего введенного символа
                              1. Neznajka # 0
                                А можно ли задать маску для ввода дробного числа, которое может иметь 1 или 2 цифры в целой части, а в дробной — от 0 до 4 знаков?
                                Пробовал «9?9.9999» — не подходит: если программно поместить в это поле подходящее число (например 8.225), то после клика мышкой по этому полю данное число само преобразуется в 82.25 :(
                                1. Александр Мальцев # 0
                                  Вам необходимо сделать 2 необязательные части. Одну слева (до точки) и одну справа (после точки). А этот плагин позволяет сделать только одну необязательную часть. Поэтому сделать с помощью masked input не получится.
                                2. waelayari # 0
                                  Здравствуйте, а вы можете прислать рабоче демо файлики… у мне не заработал плагин

                                  спасибо
                                  1. Александр Мальцев # 0
                                    Здравствуйте, вот ссылка на рабочий пример: yadi.sk/d/DIxQzr8kzqSX6

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