1.1.0 • Published 5 years ago

formatfield v1.1.0

Weekly downloads
1
License
ISC
Repository
-
Last release
5 years ago

Библиотека для форматирования ввода в поля

Примеры

Создана для совместной работы с библиотеками 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"Замена раскладки клавиатуры
titleCasetrue/falseПреобразует первую букву каждого слова заглавной. Разрешены буквы, пробелы, "-"
upperCasetrue/falseПреобразует все буквы в заглавные
integerPositivetrue/falseТолько целые, положительные числа
integertrue/falseТолько целые числа
decimalsnumber/true/falseДробные числа. Сокращает число до указанного количество цифр после запятой
pointing"," | "."Устанавливает символ для десятичных чисел
lettersOnlytrue/falseПозволяет вводить только буквы и пробел
noSpacestrue/falseЗапрет на пробелы

Как использовать маску ввода

Документация jquery.maskedinput $("#phone").mask("(999) 999-9999");

Как использовать валидацию полей

Документация jquery validation

  • Для активации валидации у формы
<form class="validate"></form>
  • Для обязательных полей
<input class="required" />
$("input").rules("add", {
  minlength: 2
});

Основные параметры

СвойствоЗначениеОписание
emailtrue/falseВалидация email
urltrue/falseВалидация url
equalTostring (selector)Проверка на соответствие (например для повторного ввода пароля)
notEqualTostring (selector)Проверка на различие полей
maxlengthnumberМаксимальное кол-во символов
minlengthnumberМинимальное кол-во символов
rangelengtharrayЧисло в промежутке
minnumberМинимальное число
maxnumberМаксиимальное число
stepnumberКратное число
alphanumerictrue/falseТолько буквы, числа и подчеркивания
ipv4true/falseВалидация ipv4
ipv6true/falseВалидация ipv6
maxfilesnumberМаксимальное кол-во файлов
maxsizenumberМаксимальный вес одного файла
maxsizetotalnumberМаксимальный вес всех файлов
require_from_grouparray (1, '.group')Минимальное кол-во заполненных полей в группе
skip_or_fill_minimumarray (1, '.group')Заполнить минимально кол-во полей в группе, либо пропустить
1.1.0

5 years ago

1.0.0

5 years ago