Небольшой коментарий по поводу параметра other , имеющийся во многих фукнциях и методах классов HTML и HTML_TAG . Этот параметр предназначен для создания в тегах полей не поддающихся систематизации, вы всегда можете воспользоваться им для создания нестандартного тега с нестандартными полями/атрибутами. В качестве other может использоваться:

- строка, и в этом случае эта строка просто попадет в описание тега, например :
  html_tagNew("BR",'other_field="value_field"')
  и в данном случае представление этого тега в выходном потоке или файле будет выглядеть как:
  < BR other_field="value_field" > < /BR >
- массив дополнительный полей с их значениями в виде:

              {
              	{ "name_field1", value_field1 },
              	{ "name_field2", value_field2 },
                      ......
              }

## Include files

### clr_html.ch

Файл с описаниями популярных цветов, используемых в HTML-документах.

### html.ch

Файл с описаниями команд для управления HTML-документами.
Я думаю что расписывать их особенно не стоит, и по описанию в html.ch будет понятно что делают команды.
А вот если у кого проявится желание написать доку на эти команды, или перепахать весь html.ch - мы только будет приветсвовать.

## Описание класса HTML_TAG

### Атрибуты/свойства

Название атрибута | Значение атрибута
--- | ---
className | "HTML_TAG"
tagName | строковое название тега
fields | двухмерный массив полей тега

### Методы/функции

#### функция html_tagNew

Создает новый объект класса HTML_TAG

Название параметра | назначение
--- | ---
tagname | название создаваемого тега
other | дополнительные поля тега, не попавшие в остальные параметры функции
title | значение поля title
style | значение поля style
class | значение поля class
event | значение поля event
id | значение поля id
lang | значение поля lang
language | значение поля language

#### метод html:toString()

параметров не имеет, возвращает строковое представление открывающего тега со всеми полями

#### метод html:closeString()

параметров не имеет, возвращает строковое представление закрывающего тега

#### метод html:addField()

addField(field_name,field_value) - добавляет в тег новое поле с именем field_name и значением field_value, возвращает идентификатор/номер этого поля.

## Описание класса HTML

### Атрибуты/свойства

Название атрибута | Значение атрибута
--- | ---
className | "HTML"
fileName | имя файла с которым ассоциируется данных экземпляр класса, т.е. этот документ был/будет прочитан/записан из/в указанный файл
title | титульное название этого объекта
tags | массив всех тегов и данных этого объекта

### Методы/функции

#### функция htmlNew(fileName,title)

Создает новый объект класса HTML, но не читает его из файла, для этого имеется соотвествующий метод. Если filename отсутсвует то объект будет прочитан/записан со/в входного/выходной поток.

#### метод html:writeToFile(fileName)

Записывает строковое представление объекта в указанный fileName, если fileName не указан то запишет в html:fileName

#### метод html:writeToHttp()

Записывает http-заголовок и следом за ним строковое представление объекта в выходной поток.

#### метод html:addTag(tag)

добавляет tag, созданный через html_tagNew в конец списка тегов, возвращает идентификатор в списке html_tags или 0 если добавление не произошло.

#### метод html:closeTag(tag_ident)

создает закрывающий тег для тега с идентификатором tag_ident, возвращает идентификатор созданного тега.

#### метод html:addData(data_string)

добавляет в объект текстовые данные, возвращает идентификатор.

#### метод html:newLine(lBr)

добавляет в объект CRLF и если lBR==.t. то еще и тег BR, возвращает идентификатор добавленного тега.

#### метод html:setPageColor(color)

в теге BODY устанавливает поле BGCOLOR в значение color, возвращает .t. или .f.

#### метод html:setTextColor(color)

в теге BODY устанавливает поле TEXT в значение color, возвращает .t. или .f.

#### метод html:setBgImage(img_url)

в теге BODY устанавливает поле BACKGROUND в значение img_url, возвращает .t. или .f.

#### метод html:setCEnter(lOn)

в зависимости от lOn добавляет открывающий/закрывающий тег CENTER, возвращает идентификатор тега

#### метод html:startFont(face,size,color,lBold,lItalic,lUline)

Формирует и добавляет тег FONT в соотвествии с указанными face,size,color. И если переданы lBold,lItalic,lUline то и добавляет еще и теги включения соответсвующих шрифтов. Возвращает идентификатор тега FONT

#### метод html:endFont()

Добавляет закрывающий тег FONT, возвращает его идентификатор

#### метод html:setFontType(font_type,lOn)

Добавляет открывающий/закрывающий тег (в зависимости от lOn) для типа фонта font_type (B,I,BIG, и т.п.), возвращает идентификатор тега

#### метод html:say(str,font,size,type,color)

#### метод html:sayColor(str,color)

Формирует тег FONT с соответсвующими параметрами font,size,type,color, добавляет str в описание документа и формирует закрывающий тег FONT. Возвращает идентификатор присвоенный str

#### метод html:qout(p1,p2,p3,.....)

#### метод html:qqout(p1,p2,p3,.....)

Результат работы этих методов аналогичен командам ?,?? и функциям qout,qqout. Т.е. преобразует p1,p2,p3,... в строковое представление и добавляет их через запятую в описание документа. Возвращает идентификатор.

#### метод html:Space()

Добавляет в документ ключевое слово nbsp

#### метод html:putImage(file,alt,border,height,name,target,other)

Формирует тег IMG из переданных параметров и добавляет его в документ, возвращает идентификатор добавленного тега.

#### метод html:text(text,width,lWrap)

Добавляет в документ тег TEXT обрамленный тегами PRE, возвращает идетнификатор тега TEXT

#### метод html:multiCol(text,cols,gutter,width)

Добавляет в документ тег MULTICOL, возвращает идентификатор

#### метод html:putHeading(text,Weight,align,lCenter)

Добавляет в документ заголовок соответсвующего Weight размера и при необходимости ( LCenter) обрамляет его тегами CENTER. Возвращает идентификатор тега Hx

#### метод html:hLine(size,width)

Добавляет в документ горизонтальную линию соответсвующего Size & Weight размера, возвращает идентификатор тега

#### метод html:Paragraph(lOn,align,style)

Добавляет в документ открывающий/закрывающий (lOn) тег P, возвращает идентификатор тега

#### метод html:putBreak()

равнозанчно newLine(.t.)

#### метод html:startMarquee(other,align,behavior,bgcolor,direct,height, hspace,loop,scrollAmount,scrollDelay, vSpace,width)

Добавляет тег "бегущей строки", возвращает идентификатор тега

#### метод html:endMarquee()

Добавляет закрывающий тег "бегущей строки", возвращает идентификатор тега

#### метод html:url( text, url, target, other )

Формирует "ссылку", возвращает идентификатор открывающего тега

#### метод html:imageUrl(url,target,file,alt,border,height,name,other)

Формирует "ссылку" с картинкой, возвращает идентификатор открывающего тега

#### метод html:startTable(other,align,border,backGround,bgColor, borderColor,borderColorDark,borderColorLight, cellPadding,cellSpacing,frame, hspace,rules,vSpace,width)

Добавляет открывающий тег TABLE, возвращает идентификатор тега

#### метод html:endTable()

Добавляет закрывающий тег TABLE, возвращает идентификатор тега

#### метод html:THcell(text,other,align,backGround,bgColor, borderColor,borderColorDark,borderColorLight, colspan,rowspan,nowrap,vAlign,width)

Формирует тег с названием колонки в таблице, возвращает идентификатор тега

#### метод html:startTrow(other,align,border,backGround,bgColor, borderColor,borderColorDark,borderColorLight, vAlign,width)

Формирует тег новой строки в таблице, возвращает идентификатор тега

#### метод html:endTrow()

Добавляет закрывающий тег TR, возвращает идентификатор тега

#### метод html:startTcell(other,align,backGround,bgColor, borderColor,borderColorDark,borderColorLight, colSpan,noWrap,rowSpan,vAlign,width)

Формирует тег новой ячейки в таблице, возвращает идентификатор тега

#### метод html:endTcell()

Добавляет закрывающий тег TD, возвращает идентификатор тега

#### метод html:startList(ordering,other,compact,type)

Формирует тег начала [не]сортированного списка (ordering), возвращает идентификатор тега

#### метод html:listItem(text,other,type,value)

Добавляет элемент списка, возвращает идентификатор тега

#### метод html:endList()

Добавляет закрывающий тег UL | UL, возвращает идентификатор тега

#### метод html:startSelect(name,other,size,multiple)

Формирует тег SELECT для выбора значения из списка возвращает идентификатор тега

#### метод html:addOption(value,text,other,selected)

Добавляет элемент списка, возвращает идентификатор тега

#### метод html:endSelect()

Добавляет закрывающий тег SELECT, возвращает идентификатор тега

#### метод html:startForm(other,action,enctype,method,target)

Формирует открывающий тег новой новой формы, возвращает идентификатор тега

#### метод html:endForm()

Добавляет закрывающий FORM, возвращает идентификатор тега

#### метод html:inputImage(src,other,align,name)

Добавляет тег INPUT TYPE="IMG", возвращает идентификатор тега

#### метод html:formGet(type,name,value,size,maxlength,other)

Добавляет тег INPUT TYPE=type, возвращает идентификатор тега

#### метод html:formReset(text,name,other)

Добавляет тег INPUT TYPE="reset", возвращает идентификатор тега

#### метод html:formSubmit(text,name,other)

Добавляет тег INPUT TYPE="submit", возвращает идентификатор тега

#### метод html:checkBox(name,value,checked,other)

Добавляет тег INPUT TYPE="checkbox", возвращает идентификатор тега

#### метод html:radioBox(name,value,checked,other)

Добавляет тег INPUT TYPE="radio", возвращает идентификатор тега

#### метод html:formFile(name,value,size,maxLength,other)

Добавляет тег INPUT TYPE="file", возвращает идентификатор тега

#### метод html:formHidden(name,value,size,maxLength,other)

Добавляет тег INPUT TYPE="hidden", возвращает идентификатор тега

#### метод html:formPasswd(name,value,size,maxLength,other)

Добавляет тег INPUT TYPE="password", возвращает идентификатор тега

#### метод html:formText(name,value,size,maxLength,other)

Добавляет тег INPUT TYPE="text", возвращает идентификатор тега

#### метод html:startFrameSet(other,cols,rows,border,borderColor, frameBorder,frameSpacing)

Формирует открывающий тег FRAMESET, возвращает идентификатор тега

#### метод html:frame(name,url,other,borderColor, frameBorder, marginHeight,marginWidth,noResize,scrolling)

Формирует тег FRAME, возвращает идентификатор тега

#### метод html:endFrameSet()

Добавляет закрывающий тег FRAMESET, возвращает идентификатор тега

© Ю.Хныкин, uri@itk.ru, 2000