Clipper compiler

Небольшой коментарий по поводу параметра 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, возвращает идентификатор тега