ref: 75d44bc306ffcbaadaa18c161bf54071304510b0
dir: /sys/include/html.h/
#pragma lib "libhtml.a" #pragma src "/sys/src/libhtml" /* UTILS */ extern uchar* fromStr(Rune* buf, int n, int chset); extern Rune* toStr(uchar* buf, int n, int chset); /* Common LEX and BUILD enums */ /* Media types */ enum { ApplMsword, ApplOctets, ApplPdf, ApplPostscript, ApplRtf, ApplFramemaker, ApplMsexcel, ApplMspowerpoint, UnknownType, Audio32kadpcm, AudioBasic, ImageCgm, ImageG3fax, ImageGif, ImageIef, ImageJpeg, ImagePng, ImageTiff, ImageXBit, ImageXBit2, ImageXBitmulti, ImageXXBitmap, ModelVrml, MultiDigest, MultiMixed, TextCss, TextEnriched, TextHtml, TextJavascript, TextPlain, TextRichtext, TextSgml, TextTabSeparatedValues, TextXml, VideoMpeg, VideoQuicktime, NMEDIATYPES }; /* HTTP methods */ enum { HGet, HPost }; /* Charsets */ enum { UnknownCharset, US_Ascii, ISO_8859_1, UTF_8, Unicode, NCHARSETS }; /* Frame Target IDs */ enum { FTtop, FTself, FTparent, FTblank }; /* LEX */ typedef struct Token Token; typedef struct Attr Attr; #pragma incomplete Token /* BUILD */ typedef struct Item Item; typedef struct Itext Itext; typedef struct Irule Irule; typedef struct Iimage Iimage; typedef struct Iformfield Iformfield; typedef struct Itable Itable; typedef struct Ifloat Ifloat; typedef struct Ispacer Ispacer; typedef struct Genattr Genattr; typedef struct SEvent SEvent; typedef struct Formfield Formfield; typedef struct Option Option; typedef struct Form Form; typedef struct Table Table; typedef struct Tablecol Tablecol; typedef struct Tablerow Tablerow; typedef struct Tablecell Tablecell; typedef struct Align Align; typedef struct Dimen Dimen; typedef struct Anchor Anchor; typedef struct DestAnchor DestAnchor; typedef struct Map Map; typedef struct Area Area; typedef struct Background Background; typedef struct Kidinfo Kidinfo; typedef struct Docinfo Docinfo; typedef struct Stack Stack; typedef struct Pstate Pstate; typedef struct ItemSource ItemSource; typedef struct Lay Lay; /* defined in Layout module */ #pragma incomplete Lay /* Alignment types */ enum { ALnone = 0, ALleft, ALcenter, ALright, ALjustify, ALchar, ALtop, ALmiddle, ALbottom, ALbaseline, }; struct Align { uchar halign; /* one of ALnone, ALleft, etc. */ uchar valign; /* one of ALnone, ALtop, etc. */ }; /* * A Dimen holds a dimension specification, especially for those * cases when a number can be followed by a % or a * to indicate * percentage of total or relative weight. * Dnone means no dimension was specified */ /* To fit in a word, use top bits to identify kind, rest for value */ enum { Dnone = 0, Dpixels = (1<<29), Dpercent = (2<<29), Drelative = (3<<29), Dkindmask = (3<<29), Dspecmask = (~Dkindmask) }; struct Dimen { int kindspec; /* kind | spec */ }; /* * Background is either an image or a color. * If both are set, the image has precedence. */ struct Background { Rune* image; /* url */ int color; }; /* * There are about a half dozen Item variants. * The all look like this at the start (using Plan 9 C's * anonymous structure member mechanism), * and then the tag field dictates what extra fields there are. */ struct Item { Item* next; /* successor in list of items */ int width; /* width in pixels (0 for floating items) */ int height; /* height in pixels */ int ascent; /* ascent (from top to baseline) in pixels */ int anchorid; /* if nonzero, which anchor we're in */ int state; /* flags and values (see below) */ Genattr*genattr; /* generic attributes and events */ int tag; /* variant discriminator: Itexttag, etc. */ }; /* Item variant tags */ enum { Itexttag, Iruletag, Iimagetag, Iformfieldtag, Itabletag, Ifloattag, Ispacertag }; struct Itext { Item; /* (with tag ==Itexttag) */ Rune* s; /* the characters */ int fnt; /* style*NumSize+size (see font stuff, below) */ int fg; /* Pixel (color) for text */ uchar voff; /* Voffbias+vertical offset from baseline, in pixels (+ve == down) */ uchar ul; /* ULnone, ULunder, or ULmid */ }; struct Irule { Item; /* (with tag ==Iruletag) */ uchar align; /* alignment spec */ uchar noshade; /* if true, don't shade */ int size; /* size attr (rule height) */ int color; /* color attr */ Dimen wspec; /* width spec */ }; struct Iimage { Item; /* (with tag ==Iimagetag) */ Rune* imsrc; /* image src url */ int imwidth; /* spec width (actual, if no spec) */ int imheight; /* spec height (actual, if no spec) */ Rune* altrep; /* alternate representation, in absence of image */ Map* map; /* if non-nil, client side map */ int ctlid; /* if animated */ uchar align; /* vertical alignment */ uchar hspace; /* in pixels; buffer space on each side */ uchar vspace; /* in pixels; buffer space on top and bottom */ uchar border; /* in pixels: border width to draw around image */ Iimage* nextimage; /* next in list of document's images */ void* aux; }; struct Iformfield { Item; /* (with tag ==Iformfieldtag) */ Formfield*formfield; void* aux; }; struct Itable { Item; /* (with tag ==Itabletag) */ Table* table; }; struct Ifloat { Item; /* (with tag ==Ifloattag) */ Item* item; /* table or image item that floats */ int x; /* x coord of top (from right, if ALright) */ int y; /* y coord of top */ uchar side; /* margin it floats to: ALleft or ALright */ uchar infloats; /* true if this has been added to a lay.floats */ }; struct Ispacer { Item; /* (with tag ==Ispacertag) */ int spkind; /* ISPnull, etc. */ }; /* Item state flags and value fields */ enum { IFbrk = 0x80000000, /* forced break before this item */ IFbrksp = 0x40000000, /* add 1 line space to break (IFbrk set too) */ IFnobrk = 0x20000000, /* break not allowed before this item */ IFcleft = 0x10000000, /* clear left floats (IFbrk set too) */ IFcright= 0x08000000, /* clear right floats (IFbrk set too) */ IFwrap = 0x04000000, /* in a wrapping (non-pre) line */ IFhang = 0x02000000, /* in a hanging (into left indent) item */ IFrjust = 0x01000000, /* right justify current line */ IFcjust = 0x00800000, /* center justify current line */ IFsmap = 0x00400000, /* image is server-side map */ IFindentshift = 8, IFindentmask = (255<<IFindentshift), /* current indent, in tab stops */ IFhangmask = 255 /* current hang into left indent, in 1/10th tabstops */ }; /* Bias added to Itext's voff field */ enum { Voffbias = 128 }; /* Spacer kinds */ enum { ISPnull, /* 0 height and width */ ISPvline, /* height and ascent of current font */ ISPhspace, /* width of space in current font */ ISPgeneral /* other purposes (e.g., between markers and list) */ }; /* Generic attributes and events (not many elements will have any of these set) */ struct Genattr { Rune* id; Rune* class; Rune* style; Rune* title; SEvent* events; }; struct SEvent { SEvent* next; /* in list of events */ int type; /* SEonblur, etc. */ Rune* script; }; enum { SEonblur, SEonchange, SEonclick, SEondblclick, SEonfocus, SEonkeypress, SEonkeyup, SEonload, SEonmousedown, SEonmousemove, SEonmouseout, SEonmouseover, SEonmouseup, SEonreset, SEonselect, SEonsubmit, SEonunload, Numscriptev }; /* Form field types */ enum { Ftext, Fpassword, Fcheckbox, Fradio, Fsubmit, Fhidden, Fimage, Freset, Ffile, Fbutton, Fselect, Ftextarea }; /* Information about a field in a form */ struct Formfield { Formfield*next; /* in list of fields for a form */ int ftype; /* Ftext, Fpassword, etc. */ int fieldid; /* serial no. of field within its form */ Form* form; /* containing form */ Rune* name; /* name attr */ Rune* value; /* value attr */ int size; /* size attr */ int maxlength; /* maxlength attr */ int rows; /* rows attr */ int cols; /* cols attr */ uchar flags; /* FFchecked, etc. */ Option* options; /* for Fselect fields */ Item* image; /* image item, for Fimage fields */ int ctlid; /* identifies control for this field in layout */ SEvent* events; /* same as genattr->events of containing item */ }; enum { FFchecked = (1<<7), FFmultiple = (1<<6) }; /* Option holds info about an option in a "select" form field */ struct Option { Option* next; /* next in list of options for a field */ int selected; /* true if selected initially */ Rune* value; /* value attr */ Rune* display; /* display string */ }; /* Form holds info about a form */ struct Form { Form* next; /* in list of forms for document */ int formid; /* serial no. of form within its doc */ Rune* name; /* name or id attr (netscape uses name, HTML 4.0 uses id) */ Rune* action; /* action attr */ int target; /* target attr as targetid */ int method; /* HGet or HPost */ int nfields; /* number of fields */ Formfield*fields; /* field's forms, in input order */ }; /* Flags used in various table structures */ enum { TFparsing = (1<<7), TFnowrap = (1<<6), TFisth = (1<<5) }; /* Information about a table */ struct Table { Table* next; /* next in list of document's tables */ int tableid; /* serial no. of table within its doc */ Tablerow*rows; /* array of row specs (list during parsing) */ int nrow; /* total number of rows */ Tablecol*cols; /* array of column specs */ int ncol; /* total number of columns */ Tablecell*cells; /* list of unique cells */ int ncell; /* total number of cells */ Tablecell***grid; /* 2-D array of cells */ Align align; /* alignment spec for whole table */ Dimen width; /* width spec for whole table */ int border; /* border attr */ int cellspacing; /* cellspacing attr */ int cellpadding; /* cellpadding attr */ Background background; /* table background */ Item* caption; /* linked list of Items, giving caption */ uchar caption_place; /* ALtop or ALbottom */ Lay* caption_lay; /* layout of caption */ int totw; /* total width */ int toth; /* total height */ int caph; /* caption height */ int availw; /* used for previous 3 sizes */ Token* tabletok; /* token that started the table */ uchar flags; /* Lchanged, perhaps */ }; struct Tablecol { int width; Align align; Point pos; }; struct Tablerow { Tablerow*next; /* Next in list of rows, during parsing */ Tablecell*cells; /* Cells in row, linked through nextinrow */ int height; int ascent; Align align; Background background; Point pos; uchar flags; /* 0 or TFparsing */ }; /* * A Tablecell is one cell of a table. * It may span multiple rows and multiple columns. * Cells are linked on two lists: the list for all the cells of * a document (the next pointers), and the list of all the * cells that start in a given row (the nextinrow pointers) */ struct Tablecell { Tablecell*next; /* next in list of table's cells */ Tablecell*nextinrow; /* next in list of row's cells */ int cellid; /* serial no. of cell within table */ Item* content; /* contents before layout */ Lay* lay; /* layout of cell */ int rowspan; /* number of rows spanned by this cell */ int colspan; /* number of cols spanned by this cell */ Align align; /* alignment spec */ uchar flags; /* TFparsing, TFnowrap, TFisth */ Dimen wspec; /* suggested width */ int hspec; /* suggested height */ Background background; /* cell background */ int minw; /* minimum possible width */ int maxw; /* maximum width */ int ascent; /* cell's ascent */ int row; /* row of upper left corner */ int col; /* col of upper left corner */ Point pos; /* nw corner of cell contents, in cell */ }; /* Anchor is for info about hyperlinks that go somewhere */ struct Anchor { Anchor* next; /* next in list of document's anchors */ int index; /* serial no. of anchor within its doc */ Rune* name; /* name attr */ Rune* href; /* href attr */ int target; /* target attr as targetid */ }; /* DestAnchor is for info about hyperlinks that are destinations */ struct DestAnchor { DestAnchor*next; /* next in list of document's destanchors */ int index; /* serial no. of anchor within its doc */ Rune* name; /* name attr */ Item* item; /* the destination */ }; /* Maps (client side) */ struct Map { Map* next; /* next in list of document's maps */ Rune* name; /* map name */ Area* areas; /* list of map areas */ }; struct Area { Area* next; /* next in list of a map's areas */ int shape; /* SHrect, etc. */ Rune* href; /* associated hypertext link */ int target; /* associated target frame */ Dimen* coords; /* array of coords for shape */ int ncoords; /* size of coords array */ }; /* Area shapes */ enum { SHrect, SHcircle, SHpoly }; /* Fonts are represented by integers: style*NumSize + size */ /* Font styles */ enum { FntR, /* roman */ FntI, /* italic */ FntB, /* bold */ FntT, /* typewriter */ NumStyle }; /* Font sizes */ enum { Tiny, Small, Normal, Large, Verylarge, NumSize }; enum { NumFnt = NumStyle*NumSize, DefFnt = FntR*NumSize+Normal, }; /* Lines are needed through some text items, for underlining or strikethrough */ enum { ULnone, ULunder, ULmid }; /* Kidinfo flags */ enum { FRnoresize = (1<<0), FRnoscroll = (1<<1), FRhscroll = (1<<2), FRvscroll = (1<<3), FRhscrollauto = (1<<4), FRvscrollauto = (1<<5) }; /* Information about child frame or frameset */ struct Kidinfo { Kidinfo*next; /* in list of kidinfos for a frameset */ int isframeset; /* fields for "frame" */ Rune* src; /* only nil if a "dummy" frame or this is frameset */ Rune* name; /* always non-empty if this isn't frameset */ int marginw; int marginh; int framebd; int flags; /* fields for "frameset" */ Dimen* rows; /* array of row dimensions */ int nrows; /* length of rows */ Dimen* cols; /* array of col dimensions */ int ncols; /* length of cols */ Kidinfo*kidinfos; Kidinfo*nextframeset; /* parsing stack */ }; /* Document info (global information about HTML page) */ struct Docinfo { /* stuff from HTTP headers, doc head, and body tag */ Rune* src; /* original source of doc */ Rune* base; /* base URL of doc */ Rune* doctitle; /* from <title> element */ Background background; /* background specification */ Iimage* backgrounditem; /* Image Item for doc background image, or nil */ int text; /* doc foreground (text) color */ int link; /* unvisited hyperlink color */ int vlink; /* visited hyperlink color */ int alink; /* highlighting hyperlink color */ int target; /* target frame default */ int chset; /* ISO_8859, etc. */ int mediatype; /* TextHtml, etc. */ int scripttype; /* TextJavascript, etc. */ int hasscripts; /* true if scripts used */ Rune* refresh; /* content of <http-equiv=Refresh ...> */ Kidinfo*kidinfo; /* if a frameset */ int frameid; /* id of document frame */ /* info needed to respond to user actions */ Anchor* anchors; /* list of href anchors */ DestAnchor*dests; /* list of destination anchors */ Form* forms; /* list of forms */ Table* tables; /* list of tables */ Map* maps; /* list of maps */ Iimage* images; /* list of image items (through nextimage links) */ }; extern int dimenkind(Dimen d); extern int dimenspec(Dimen d); extern void freedocinfo(Docinfo* d); extern void freeitems(Item* ithead); extern Item* parsehtml(uchar* data, int datalen, Rune* src, int mtype, int chset, Docinfo** pdi); extern void printitems(Item* items, char* msg); extern int targetid(Rune* s); extern Rune* targetname(int targid); extern int validitems(Item* i); #pragma varargck type "I" Item* /* Control print output */ extern int warn; extern int dbglex; extern int dbgbuild; /* * To be provided by caller * emalloc and erealloc should not return if can't get memory. * emalloc should zero its memory. */ extern void* emalloc(ulong); extern void* erealloc(void* p, ulong size);