Инструкция по использованию HalSoft.forms
1. Распаковать архив, переместить файл halsoft.forms.php в нужную директорию
2. Включить скрипт в свой проект методом:
require_once('halsoft.forms.php');
3. Вызвать функцию там, где нужно отобразить или присвоить переменной форму
E( название формы, параметры формы [, текст внутри тегов, события] );
Разберем каждый параметр функции E();
_______________________________________________________
Название формы - здесь может быть одна из следующих букв (констант):
i - что эквивалентно строке 'input'
s - что эквивалентно строке 'select'
f - что эквивалентно строке 'form'
t - что эквивалентно строке 'textarea'
******************************************************************************
Параметры формы - здесь могут быть перечислены через запятую параметры формы,
такие как type, name, value, style и др. Но важно учитывать синтаксис.
n=название формы,s=стиль формы,t=тип формы и т.д.
То есть достаточно написать первую букву параметра и чему оно равняется.
Вот весь список
n - name
o - options
a - action
v - value
t - type
s - style
c - class
i - id
m - method
e - enctype
checked - checked
*******************************************************************************
Текст внутри тегов - название говорит само за себя, пример
E(t,'n=info','Текст внутри тегов');
эквивалентно
<textarea name = "info">Текст внутри тегов</textarea>
**************************************
События - здесь может быть события onclick, onMouseOver, onMouseOut и т.д. синтаксис onClick="script();"
Пример
E(i,'t=button','','onClick="somScript();"');
эквивалентно
<input type = "button" onclick = "somScript();"/>
_______________________________________________________________________
Приведём пример как на страницу вывести форму input с параметрами name = "login" и type= "text"
<?
require_once('halsoft.forms.php');
echo E(i,'t=text,n=login');
?>
Как видим, функция значительно скоращает наш код.
Вместо того, чтобы писать
echo '<input type="text" name="login"/>';
мы просто вызвали функцию
echo E(i,'t=text,n=login');
/////////////////////////////////////////////////////////////////////
Теперь посмотрим как работать со списками select.
echo E(s,'n=city,o=1:Москва;2:Петербург;3:Ростов');
Разберём параметры нашей формы, а именно строку n=city,o=1:Москва;2:Петербург;3:Ростов
n=city - это понятно, это значит name = "city"
Но вот как понимать o=1:Москва;2:Петербург;3:Ростов ?
Очень просто o= означает 'options=' и дальше перечисление
через точку с запятой опций в виде 'значение:название'
то есть, строка o=1:Москва;2:Петербург;3:Ростов
эквивалентна HTML коду
<option value="1">Москва</option>
<option value="2">Петербург</option>
<option value="3">Ростов</option>
Теперь сравните
echo '<select name="city">
<option value="1">Москва</option>
<option value="2">Петербург</option>
<option value="3">Ростов</option>
</select>';
или
echo E(s,'n=city,o=1:Москва;2:Петербург;3:Ростов');
Какая из этих записей выглядит компактнее и эффективнее?
//////////////////////////////////////////////////////
Про автозаполение форм
Этот скрипт в разы увеличивает работу над автозаполнение нужных нам форм
Примеры
Форма input
E(i,'t=text,n=login,v=Введите логин');
//В этом случае на странице появится форма для ввода текста с уже введенным текстом "Введите логин"
Форма select
echo E(s,'n=city,o=1:Москва;2:Петербург;3:Ростов,v=2');
//В этом случае на странице появится форма выбора (select) с уже выбранным элементом 'Петербург',
//так как у него значение 2, а мы задали v=2 (value = "2")
echo E(t,'n=info,v=Введите сюда информацию');
//В этом случает появится форма textarea с name - info и значением поумолчанию "Введите сюда информацию"
Для checkbox элементов значение поумолчанию устанавливается параметром checked
E(i,'t=checkbox,n=variant,checked');
Эквивалентно <input type="checkbox" name="variant" checked/>
И под конец, советую открыть файл example.php - сначала просмотреть в браузере, а потом внимательно изучить его код