1.1.0 • Published 6 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') | Заполнить минимально кол-во полей в группе, либо пропустить |