Форматированный ввод данных
Полный список свойств и функций, а так же общие правила их использования, см. здесь: Краткий обзор и правила, список функций VcorpJS.
VcorpJS содержит два плагина-функции форматированного ввода:
- ввода числа с контролами для кликов .spinner()
- ввод номера телефона по маске .phone()
.spinner( node , [ value ] , [ minValue ] , [ maxValue ] , [ handler ] )
Функция работает с полем ввода - элементом <input type="text" ... />
node - ссылка на поле ввода input или его текстовый id
value - числовое целое значение: 0 - только проверка поля ввода на число с корректировкой значения, <0 или >0 - сложение с текущим числом в поле ввода
minValue - число, минимальное целое значение, которое можно ввести в поле ввода
maxValue - число, максимальное целое значение, которое можно ввести в поле ввода
handler - callbak - функция, вызываемая каждый раз (если она указана) как function( value ); где:
- this - ссылка на объект - поле ввода
- value - текущее целое числовое значение поля ввода
handler может быть текстовой строкой с кодом функции, в таком случае имя используемого параметра "value" (см. правила для callback - функций).
Функция возвращает this или false - если node не найден или minValue > maxValue
Плагин использует CSS-классы .pb_spinner, .pb_sp_t, .pb_sp_b
.phone( node , [ handler ] )
Функция контроля ввода 11-значного (не считая +, пробелов и скобок) телефонного номера по маске +N (NNN) NNNNNNN
Внимание! Функцию необходимо вызывать из обработчика события onfocus поля ввода node.
Полная длина - 16 символов (у поля ввода принудительно устанавливается атрибут maxLength=16).
node - ссылка на поле ввода input или его текстовый id
handler - callbak - функция, вызываемая каждый раз (если она указана) как function( e, value ); где:
- this - ссылка на объект - поле ввода
- e - объект события event (e.type == "keydown" или "change" или "blur" )
- value - текущее текстовое значение поля ввода с разделителями, 16 символов
handler может быть текстовой строкой с кодом функции, в таком случае имена используемых параметров "e, value" (см. правила для callbak - функций).
Функция ничего не возвращает, только корректно навешивает обработчики событий (не более 1 раза) на редактируемое поле (при удалении объекта обработчики удаляются вместе с ним, так как являются его частью - свойствами с префиксами .pb_EV и .pb_PH).
Плагин Spinner использует CSS-классы .pb_spinner, .pb_sp_t, .pb_sp_b
Визуальный пример создания и работы Spinner-счётчика:
<!--
HTML - код элемента Spinner
Обратите внимание, что вызов callback-функции происходит только при change от пользователя!
-->
<div class="pb_spinner">
<input type="text" maxlength="2" id="spinner1" value="1" onchange="VcorpJS.spinner(this, 0, 1, 20, function(v){alert(v)})"/>
<div class="pb_sp_t" onclick="VcorpJS.spinner('spinner1', +1, 1, 20)"></div>
<div class="pb_sp_b" onclick="VcorpJS.spinner('spinner1', -1, 1, 20)"></div>
</div>
- вот что получилось
Визуальный пример работы функции-плагина .phone() :
<!-- HTML - код с функцией .phone() -->
<input type="text" value="" onfocus="VcorpJS.phone(this, function(e,v){alert(v)})"/>
- вот что получилось
Для навигации по всем страницам этого раздела сайта используйте пиктограмму или ссылку Навигация в верхней строке навигации.