Маска поля с помощью JQuery

Для создания маски нам понадобятся две JS-библиотеки:

• jQuery (локальная копия версии jquery-1.6.3.min);
• Masked Input Plugin (локальная копия версии jquery.maskedinput-1.3.min; чуть-чуть подправлена – добавлена поддержка кириллицы) – это плагин для jQuery, который собственно и реализует маску.

Создайте для них в CRM Веб-ресурсы и подключите их к нужной форме (например, для Интереса).

Далее, нам понадобится еще один JS Веб-ресурс, содержащий код инициации маски и сохранения значения маски:

if (typeof (MyFunctionsPack) == "undefined") { MyFunctionsPack = {}; }

MyFunctionsPack.MyFunctions = {
    Mask: function (field, format) {
        $("#" + field).mask(format);
    },
    formatField: function (fieldName) {
        if (Xrm.Page.getAttribute(fieldName).getValue() != $("#" + fieldName).val())
        Xrm.Page.getAttribute(fieldName).setValue($("#" + fieldName).val());
    }
}

Данный код состоит из двух функций:

• Mask: собственно и инициирует наложение маски на поле. Принимает два праметра:
• field – имя поля на которого накладывается маска;
• format – формат маски может быть следующих видов:

  aaa-aaa aaa-aa
  9(999) 999-99-99
  ******-**
  

  где символы:

• a (латинская) – представляют собой символы A-Z, a-z, А-Я, а-я (поддержка кирилицы добавлена только в локальной копии, если качали исходную библиотеку Вам придется добавить поддержку самостоятельно);
• 9 — представляют собой символы от 0 до 9;
• * — представляют собой символы A-Z, a-z, А-Я, а-я, 0-9.
• formatField: данная функция сохраняет значение маски в поле CRM. Причина этого в том, что плагин Masked Input Plugin не хранит значение маски в полях CRM, поэтому мы должны позаботиться о переносе значения а поле CRM самостоятельно. Делается то путем элементарного сравнения значения в html и значения в поле CRM. Если они отличаются, то это значит, что пользователь изменил поле. Функция принимает вего один параметр – имя поля, для которого включена маска.

На онлоаде формы задействуйте функцию Mask и передайте ей имя поля и формат маски. А на онсейве вызовите функцию formatField и передайте имя поля с маской.

Идем проверять… 🙂

Дополнительно

Вы также можете с помощью этого плагина сделать следующие вещи:

• Заменители — символы отображающиеся на месте еще не введенных пользователем символов (по умолчанию это знак подчеркивания «_»):

  Mask: function (field, format, plchldr) {
      $("#" + field).mask(format, { placeholder: plchldr });
  }
  

• Обратный вызов функции при заполнении маски:

  Mask: function (field, format) {
      $("#" + field).mask(format, { completed: function () { alert("Вы ввели следующее: " + this.val()); } });
  }
  

• Вы можете теперь задать свои определения маски:

  Mask: function (field, format, plchldr) {
      $.mask.definitions['~'] = '[+-]';
      $("#" + field).mask(format, { placeholder: plchldr });
  }
  

  И в качестве формата маски передать:

  ~9.99 ~9.99 999

• Часть Вашей маски может быть опциональной. Для этого используется специальный символ «?» — все, что перечислено после него считается не обязательным для ввода. Например:

  (999) 999-9999? x99999