Функции для работы с формой
---------------------------
Эти функции предназначены для упрощения создания формы ввода
пользовательских данных.
Всего имеется 7 функций для формирования тэгов формы:
1. %input()% - однострочный ввод текста
2. %text()% - многострочный ввод текста
3. %checkbox()% - флажки (чекбоксы)
4. %radio()% - переключатели
%radio2()% - альтернатива %radio()%
5. %select()% - выпадающее меню
%select2()% - альтернатива %select()%
6. %button()% - кнопка
7. %submit()% - кнопка для отправки данных на сервер
Все функции имеют схожий синтаксис вызова.
Необязательно задавать все агрументы у функций, если какой то
агрумент не задан - будет использовано значение по умолчанию.
Для определения стилей большинства тэгов функции имеют аргумент
style, который может принимать следующие значения:
- пустая строка ("") добавляет в тэг стиль по умолчанию, который
задан парсером
- 0 - ничего в тэг добавлено не будет
- любая другая строка будет определять пользовательский стиль
оформления тэга (css или название класса)
Описание аргументов функций.
1. синтаксис: %input(name, value, size, maxlength, style, extra)%
описание: однострочный ввод текста, тэг <input type=text>
функция может принимать до 6-и аргументов:
1. name - имя тэга, под этим именем данные будут отправлены
на сервер
2. value - начальное значение строки
3. size - размер поля ввода, определяет размер поля на экране
4. maxlength - максимальное количество символов, которое можно ввести
5. style - стиль тэга
6. extra - любые дополнительные параметры тэга
2. синтаксис: %text(name, value, size, maxlength, style, extra)%
описание: многострочный ввод текста, тэг <textarea>
функция может принимать до 7-и аргументов:
1. name - имя тэга, под этим именем данные будут отправлены на сервер
2. value - начальное значение строки
3. cols - количество видимых столбцов
4. rows - количество видимых строк
5. wrap - опрелеяет поведение при выходе строки в поле ввод за видимые
границы поля
6. style - стиль тэга
7. extra - любые дополнительные параметры тэга
3. синтаксис: %checkbox(name, checked, value, label)%
описание: флажки, тэг <input type=checkbox>
1. name - имя тэга, под этим именем данные будут отправлены на
сервер
2. checked - первоначальное значение флажка (выбран/не выбран - 1/0)
3. value - значение, которое будет отправлено на сервер, если флажок
будет установлен
4. label - подпись к флажку
4. %radio(name, checked, values, sep)% или
%radio2(name, checked, values, sep)%
описание: переключатели, тэг <input type=checkbox>
1. name - имя тэга, под этим именем данные будут отправлены на
сервер
2. checked - значение, которое будет выбрано первоначально
3. values - набор значений и их подписи, из которых должен
производиться выбор. набор задается в квадратных
скобках ([]), значения и подписи перечисляются через
запятую. Для альтернативного варианта %radio2()%
необходимо задавать только набор значений, подписи будут
браться из значений.
4. sep - строка разделителя, которая определяет как будут
разделены тэги переключателя (напимер: "<br>" или " ")
5. %select(name, checked, values, style, extra)% или
%select2(name, checked, values, style, extra)%
описание: выпадающее меню, тэг <select>
1. name - имя тэга, под этим именем данные будут отправлены на
сервер
2. checked - значение, которое будет выбрано первоначально
3. values - набор значений и их подписи, из которых должен
производиться выбор. набор задается в квадратных
скобках ([]), значения и подписи перечисляются через
запятую. Для альтернативного варианта %select2()%
необходимо задавать только набор значений, подписи будут
браться из значений.
4. style - стиль тэга
5. extra - любые дополнительные параметры тэга
6. %button(name, value, title, style, extra)%
описание: кнопка, тэг <input type=button>
1. name - имя тэга
2. value - надпись на кнопке
3. title - подсказка (tooltip), всплывающая при наведении курсора на
кнопку
4. style - стиль тэга
5. extra - любые дополнительные параметры тэга
7. %submit(name, value, title, style, extra)%
описание: кнопка для отправки данных на сервер, тэг <input type=submit>
1. name - имя тэга
2. value - надпись на кнопке
3. title - подсказка (tooltip), всплывающая при наведении курсора на
кнопку
4. style - стиль тэга
5. extra - любые дополнительные параметры тэга
--------------------------------
Чтобы лучше понять, как работают эти функции, а также шаблоны в целом,
вы можете использовать этот пример. Загрузите этот код в любую
дополнительную страницу и изучайте его, меняя параметры.