1.1.0 • Published 5 years ago
formatfield v1.1.0
Библиотека для форматирования ввода в поля
Примеры
Создана для совместной работы с библиотеками jquery.maskedinput, jquery validation
Установка
Основное
Подключить перед закрытием </body>
<script src="https://code.jquery.com/jquery-3.4.1.min.js"></script>
<script src="./libs/formatField.min.js"></script>
/* Либо */
<script src="./libs/all.min.js"></script> // Содержит все необходимые библиотеки (formatField.js, jquery.maskedinput, jquery validation)
Используя менеджер пакетов
npm i formatfield --save
Использование
По data атрибутам:
<!-- для ввода ФИО -->
<input data-mask="fio" />
<!-- для ввода телефона -->
<input data-mask="phone" />
<!-- для ввода email -->
<input data-mask="email" />
<!-- для ввода букв и пробелов -->
<input data-mask="letters" />
<!-- для ввода целых чисел -->
<input data-mask="number" />
<!-- для ввода дробных чисел -->
<input data-mask="decimals" />
Как использовать фильтрацию ввода в input
$("[data-mask=name]").formatFeild({
titleCase: true,
layout: "toRu"
});
Параметры
Свойство | Значение | Описание |
---|---|---|
layout | "toRu" | "toEn" | Замена раскладки клавиатуры |
titleCase | true/false | Преобразует первую букву каждого слова заглавной. Разрешены буквы, пробелы, "-" |
upperCase | true/false | Преобразует все буквы в заглавные |
integerPositive | true/false | Только целые, положительные числа |
integer | true/false | Только целые числа |
decimals | number/true/false | Дробные числа. Сокращает число до указанного количество цифр после запятой |
pointing | "," | "." | Устанавливает символ для десятичных чисел |
lettersOnly | true/false | Позволяет вводить только буквы и пробел |
noSpaces | true/false | Запрет на пробелы |
Как использовать маску ввода
Документация jquery.maskedinput
$("#phone").mask("(999) 999-9999");
Как использовать валидацию полей
Документация jquery validation
- Для активации валидации у формы
<form class="validate"></form>
- Для обязательных полей
<input class="required" />
$("input").rules("add", {
minlength: 2
});
Основные параметры
Свойство | Значение | Описание |
---|---|---|
true/false | Валидация email | |
url | true/false | Валидация url |
equalTo | string (selector) | Проверка на соответствие (например для повторного ввода пароля) |
notEqualTo | string (selector) | Проверка на различие полей |
maxlength | number | Максимальное кол-во символов |
minlength | number | Минимальное кол-во символов |
rangelength | array | Число в промежутке |
min | number | Минимальное число |
max | number | Максиимальное число |
step | number | Кратное число |
alphanumeric | true/false | Только буквы, числа и подчеркивания |
ipv4 | true/false | Валидация ipv4 |
ipv6 | true/false | Валидация ipv6 |
maxfiles | number | Максимальное кол-во файлов |
maxsize | number | Максимальный вес одного файла |
maxsizetotal | number | Максимальный вес всех файлов |
require_from_group | array (1, '.group') | Минимальное кол-во заполненных полей в группе |
skip_or_fill_minimum | array (1, '.group') | Заполнить минимально кол-во полей в группе, либо пропустить |