Provided by: manpages-zh_1.5.1-1_all bug

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 argstag     入棧,為它產生一荈}標簽。使用    ::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 榆瑼獐陏情AC表。

       ::html::radioValue name value
              為一 RADIO 表單元素產生一 "name=name  value=value"  .如果  CGI
              變量 namevalue, 那麼 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 標簽。 nameparam
              用來產生 SELECT 標簽。 choices 列表是一 Tcl  樣式的  name-value
              列表。

       ::html::selectPlain name param choices ?current?
              類似  ::html::selectchoices 是一 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