Provided by:
manpages-zh_1.5.1-1_all 
NAME
html - 產生 HTML 框架的子程式
` SYNOPSIS
package require Tcl 8.2
package require html ?1.2.1?
::html::author author
::html::bodyTag args
::html::cell param value ?tag?
::html::checkbox name value
::html::checkSet key sep list
::html::checkValue name ?value?
::html::closeTag
::html::default key ?param?
::html::description description
::html::end
::html::eval arg ?args?
::html::extractParam param key ?varName?
::html::font args
::html::for start test next body
::html::foreach varlist1 list1 ?varlist2 list2 ...? body
::html::formValue name ?defvalue?
::html::getFormInfo args
::html::getTitle
::html::h level string ?param?
::html::h1 string ?param?
::html::h2 string ?param?
::html::h3 string ?param?
::html::h4 string ?param?
::html::h5 string ?param?
::html::h6 string ?param?
::html::hdrRow args
::html::head title
::html::headTag string
::html::if expr1 body1 ?elseif expr2 body2 ...? ?else bodyN?
::html::keywords args
::html::mailto email ?subject?
::html::meta args
::html::minorMenu list ?sep?
::html::minorList list ?ordered?
::html::openTag tag args
::html::passwordInput ?name?
::html::passwordInputRow label ?name?
::html::quoteFormValue value
::html::radioSet key sep list
::html::radioValue name value
::html::refresh seconds url
::html::init ?list?
::html::row args
::html::paramRow list ?rparam? ?cparam?
::html::select name param choices ?current?
::html::selectPlain name param choices ?current?
::html::submit label ?name?
::html::set var val
::html::tableFromArray arrname ?param? ?pat?
::html::tableFromList querylist ?param?
::html::textarea name ?param? ?current?
::html::textInput name args
::html::textInputRow label name args
::html::title title
::html::varEmpty name
::html::while test body
yz DESCRIPTION
html 包提供了產生 HTML 的命令。這些命令一般返回 HTML
字符串作為結果。特殊的是，它怳ㄕV stdout 輸出結果。
::html::init 命令應當最汗掍峞A從而初始化整蚍珔禲C也可以使用這-
茪l程式來定義 HTML 標記參數的預設C
::html::author author
Side effect only. 在調用 ::html::head 之前調用它，來定義-
悸漣@者。作者以 HEAD 段中的注釋形式給出。
::html::bodyTag args
產生一 BODY 標簽。標簽參數來自 args 或是在 ::html::init
中定義的 body.* 屬性。
::html::cell param value ?tag?
產生一 TD (或 TH) 標簽，一蚧，和一蚚鶶 TD (或 TH)
標簽。標簽參數來自param 或是在 ::html::init 中定義的 TD.*
屬性。它使用 ::html::font 來在表格單元中插入一蚍郱 FONT
標簽。 tag 參數預設是 "td".
::html::checkbox name value
產生一 CHECKBOX 表單元素，使用指定的名稱和C這使用了
::html::checkValue.
::html::checkSet key sep list
產生一 CHECKBOX 表單元素和相關標簽的集合。list 應當包含一-
茈i選標簽和漲C表。這使用了 ::html::checkbox.
::html::checkValue name ?value?
為一 CHECKBOX 表單元素產生一 "name=name value=value" . 如果
CGI 變量 name 的O value，那麼 SELECTED 將加入到返回丑Cvalue
預設O "1".
::html::closeTag
從 ::html::openTag 創建的棧中彈出一蚍陏情A產生相應的關閉標簽
(例如，/BODY)。
::html::default key ?param?
這茪l程式由 ::html::tagParam 用來產生標簽的參數名稱和-
C表。::html::default 子程式用來為那些不在 param
中的項目產生預設C如果 key 代表的t param 中的一蚧，那麼這-
茪l程式返回孔字符串。否則，它為 key 代表的表單元素返回一
"parameter=value" 字符串。key 的形式是 "tag.parameter"
(例如，body.bgcolor)。使用 ::html::init 來注冊預設Cparam
預設是空字符串。
::html::description description
Side effect only. 在調用 ::html::head 前調用它來為雇定義一
META 標簽。這蚍陏惘b隨後調用 ::html::head 時產生。
::html::end
從棧中彈出所有開標簽，產生相應的關閉標簽
(例如，</body></html>)。
::html::eval arg ?args?
這茪l程式類似於內置的 Tcl eval 命令，唯一的區別是它返回 "",
因此可以在一 HTML 模板檔案中調用，不會添加不需n的結果。
::html::extractParam param key ?varName?
這是一虒挭懇{式，從 param ，一 HTML 式樣的 "name=quotedvalue"
列表中得到所有 key 的CvarName 用作一 Tcl
變量名，賦以參數中找到的C這茖蝻藀^ 1，如果 param
中找到了參數，否則返回 0。如果沒有指定 varName ，將使用 key
作為變量名。
::html::font args
產生一蚍郱 FONT 標簽。標簽的參數來自 args 和 ::html::init
定義的 HTML 預設C
::html::for start test next body
這茪l程式與內置的 Tcl for 控制結構相似。但它返回聯接的
(subst'ed) body 而不是去p算 body 的C循環的每一次都會在返回-
切p接另外一茼r符串。
::html::foreach varlist1 list1 ?varlist2 list2 ...? body
這茪l程式與內置的 Tcl foreach 控制結構相似。但它返回聯接的 body
而不是去p算 body 的C循環的每一次都會將另外一茼r符串聯接到返回-
丑C
::html::formValue name ?defvalue?
返回一茼W稱-鵅A使用現有的 CGI 數據來初始化C結果有以下形式：
name="fred" value="freds value"
::html::getFormInfo args
產生隱藏的字段來捕獲表單C如果 args 是空，那麼為所有 CGI
衎媮蘌疆r段。否則 args 是一-
茪t表單元素名稱的字符串模式的列表。
::html::getTitle
返回 title 字符串，沒有包圍的 TITLE 標簽。title 以一茈前調用的
::html::title 定義。
::html::h level string ?param?
產生一蚍陏D (例如, H1) 標簽。string 嵌於標題中，param
用作標簽參數。
::html::h1 string ?param?
產生一 H1 標簽。參見 ::html::h.
::html::h2 string ?param?
產生一 H2 標簽。參見 ::html::h.
::html::h3 string ?param?
產生一 H3 標簽。參見 ::html::h.
::html::h4 string ?param?
產生一 H4 標簽。參見 ::html::h.
::html::h5 string ?param?
產生一 H5 標簽。參見 ::html::h.
::html::h6 string ?param?
產生一 H6 標簽。參見 ::html::h.
::html::hdrRow args
產生一茠礄璁獢A包含 TR 和 TH 標簽。args 中的每-
ㄧm入自己的表格單元中。這使用了 ::html::cell.
::html::head title
產生一 HEAD 段，包含雇的 TITLE。如果先前調用了 ::html::author,
::html::keywords, ::html::description, 或 ::html::meta
那麼附加的標簽將插入到 HEAD 段中。它使用 ::html::openTag 將一荈}
HTML 標簽入棧.
::html::headTag string
保存一茈]含於 ::html::head 產生的 HEAD 段中的標簽。string 是一-
蚍陏惜什ㄓF尖括號之外的所有東西。
::html::if expr1 body1 ?elseif expr2 body2 ...? ?else bodyN?
這茪l程式與內置的 Tcl if 控制結構相似。但它返回聯接的 body
而不是去p算它每茪壑 body 的C注意這蚖y法與內置的 Tcl if
控制結構相比稍有制。
::html::keywords args
Side effect only. 在調用 ::html::head 之前調用它來定義一荈-
悸疑鶬鉿r META 標簽。在 ::html::head 結果中將包含這 META 標簽。
::html::mailto email ?subject?
產生一茖 mailto: URL 的超鏈接。
::html::meta args
Side effect only. 在調用 ::html::head 之前調用它來定義一荈悸
META 標簽。 args 是一 Tcl 樣式的名稱和C表，用作 META 標簽的
name= 和 value= 參數。在 ::html::head 結果中將包含這 META
標簽。
::html::minorMenu list ?sep?
產生一系列超鏈接。list 是一 Tcl 樣式的名稱和-
C表，內容是鏈接的標簽和地址。sep 是分隔每蚚麇答漱憟說A預設是 "
| ".
::html::minorList list ?ordered?
產生一荓漫峊摹疑麇策C表。list 是一 Tcl 樣式的名稱和-
C表，內容是鏈接的標簽和地址。ordered 是一茈牯-
A用來選擇有序表或無序表，預設是 false.
::html::openTag tag args
將 tag 入棧，為它產生一荈}標簽。使用 ::html::closeTag
來從棧中彈出標簽。
::html::passwordInput ?name?
產生一 PASSWORD 類型的 INPUT 標簽。 name 預設為 "password".
::html::passwordInputRow label ?name?
格式化一茈]含一蚍陏惟M一 PASSWORD 類型的 INPUT
標簽的表格行。name 預設為 "password".
::html::quoteFormValue value
使用 HTML 實體 (quotes, ampersand, and angle brackets.) 來替換
value 中的特殊字符，從而可以引用它怴C
::html::radioSet key sep list
產生一 RADIO 類型的 INPUT 標簽集合以及一-
茯袺鰝漱憟遞陏情C所有單選按鈕共享同樣的 key 作為它怐漲W字。sep
是用來分隔各元素的文本。list 是一 Tcl 榆瑼獐陏情AC表。
::html::radioValue name value
為一 RADIO 表單元素產生一 "name=name value=value" .如果 CGI
變量 name value, 那麼 SELECTED 將被加入返回丑C
::html::refresh seconds url
建立一茖篞s META 標簽。在調用 ::html::head 之前調用它，HEAD
段中將包含一 META 標簽使得雇每 seconds 刷新一次。 url
是可選的，如果指定的話它指定了刷新間隔之後讀取的新雇。
::html::init ?list?
::html::init 接受一 Tcl 樣式的 name-value 列表，定義了名稱是
"tag.parameter" 形式的對象的C例如， "body.bgcolor" 預設將為
BODY 標簽定義I景色。
::html::row args
產生一茠礄璁獢A包含 TR 和 TD 標簽。args 的每-
ㄧm入各自的表格單元中。它使用了 ::html::cell.
::html::paramRow list ?rparam? ?cparam?
產生一茠礄璁獢A包含 TR 和 TD 標簽。args 的每-
ㄧm入各自的表格單元中。它使用了 ::html::cell. rparam 用作 TR
標簽的參數，cparam 的Q傳給 ::html::cell，作為 TD 標簽的參數。
::html::select name param choices ?current?
產生一 SELECT 表單元素以及內置的 OPTION 標簽。 name 和 param
用來產生 SELECT 標簽。 choices 列表是一 Tcl 樣式的 name-value
列表。
::html::selectPlain name param choices ?current?
類似 ::html::select 但 choices 是一 Tcl 漲C表，用於 OPTION
標簽。每 OPTION 的標簽和O相同的。
::html::submit label ?name?
產生一 SUBMIT 類型的 INPUT 標簽。 name 預設是 "submit".
::html::set var val
這茪l程式與內置的 Tcl set 控制結構相似。主n區別是它返回 ""
因此可以在一 HTML
模板檔案中調用，不會產生奇怪的結果。另外的區別是它需n兩荌捊C
::html::tableFromArray arrname ?param? ?pat?
產生一 TABLE 和內置的行，來顯示一 Tcl 數組。param 是為 TABLE
標簽準備的。pat 是一 string match
模式，用來選擇數組元素，預設是 "*".
::html::tableFromList querylist ?param?
產生一 TABLE 和內置的行來顯示 querylist, 一 Tcl 樣式的名稱和-
C表。param 是為 TABLE 標簽設置的。
::html::textarea name ?param? ?current?
產生一 TEXTAREA 標簽，包圍 (wrapped) 在它的當前
::html::textInput name args
產生一 TEXT 類型的 INPUT 表單標簽。這使用了 ::html::formValue.
參數是你想在 INPUT 標簽中添加的任何附加標簽屬性。
::html::textInputRow label name args
產生一 TEXT 類型的 INPUT 標簽，和一茯袺鶻陏惜@起格式化到一-
茠礄璁璊丑C參數是你想在 INPUT 標簽中添加的任何附加標簽屬性。
::html::title title
Side effect only. 在調用 ::html::head 調用它來定義雇的 TITLE。
::html::varEmpty name
如果指定名稱的變量不存在或者為空h返回 1 。
::html::while test body
這茪l程式類似於內置的 Tcl while 空硎c。但它返回聯接的 body
而不是p算 body。循環的每一次都將另一茼r符串聯接到返回丑C
SEE ALSO
ncgi, htmlparse
r KEYWORDS
html, form, table, checkbox, radiobutton, checkbutton
[]
KAv
[]
2003/11/10
m Linux manUpn:
http://cmpp.linuxforum.net