Adobe ColdFusion 8

cfformitem

描述

在一个Flash表单插入一条水平的线，一条垂直的线，一个空白占位，或者文本。使用在Flash和XML表单的cfform 或 cfformgroup 标签主体里。忽略HTML表单。

语法

<cfformitem 
    type = "hrule|vrule|spacer"
    height = "pixels"
    style = "style specification"
    visible = "yes|no"
    width = "pixels"/>

或者

<cfformitem 
    type = "html|text|script"
    bind = "bind expression"
    enabled = "yes|no"
    height = "pixels"
    style = "style specification"
    tooltip = "text"
    visible = "yes|no"
    width = "pixels">
    ...text
</cfformitem>

注: 你可以在attributeCollection 中指定这个标签的属性，作为一个结构的value,在attributeCollection 中指定结构的名称，并使用这个标签的属性名称作为这个结构的Keys.

属性

下面的表格罗列了标签在Flash表单里的属性和行为。对于XML表单，如果没有其他的提示，该标签就被传递给XML，但是它不会被ColdFusion提供的基本XSL样式单解析。

注意: 标明为只适用于Flash的属性不能被ColdFusion提供的皮肤使用。然而，他们，包括了在所有控件里产生的XML，除了文本和HTML类型。

属性

必选/可选; formats

默认

描述

type

必选;

Flash 和 XML

 

Flash:

  • html:把文本放置在表单里的该标签主体中，你可以使用下面的文本格式标签，大多数标签都对应标签，文本是：a, b, br, font, i, img, li, p, textformat, 和 u。使用这些格式标签的更多细节，请看Flash文件。style属性在类型里的文本text里没有作用。
  • text:在表单里的标签主体里放置了文本，不用解读任何的标记。你可以通过使用style属性来控制所有的文本外观。
  • spacer:放置一个指定了高度和宽度的可见spacer在表单里。用来在表单控件之间放置空白。这个标签不需要 任何子属性。
  • hrule:在表单里放置一个水平的规则。这个标签不需要子属性。
  • vrule:在表单里放置一个垂直的规则，这个标签不需要子属性。
  • script:让你在Flash表单里创建函数，这样可以减少到达64 KB上限的可能。

XML:

  • html:把CFML标签的主体文本放在XMLxf:output元素的一个CDATA部分里。
  • text:把CFML标签的主体文本XML化（避开一些符号比如<），并把它放在XMLxf:output 元素的CDATA部分里。
  • hrule:把一个hr标签放在输出内容里。使用style属性来指定所有特色，包括了高度和宽苏。这个标签不需要任何子属性。

任何其他字符串:产生了一个带有类型名作为外观属性的XMLxf:group元素。CFML标签的主体放在cf:attribute name="body" 元素的CDATA部分里。XSL技术转化為ColdFusion提供了忽视这些要素。

bind

可选;

Flash

 

一个Flash捆绑表达式，它公布了从另一个表单域收集处理域信息。如果你用这个属性，ColdFusion会忽略你指定在cftextitem标签主体里的任意文本。当cfformitem标签在cfformgroup type="repeater"里时，这个属性会很有用。

更多信息,请看cfinput标签描述里的Flash form data binding。

enabled

可选;

Flash

yes

Boolean值，指定了控件是否可用。不能使用的文本显示为浅灰色。在spacers属性和rule属性上不可用。

height

可选;

Flash

 

item的高度，单位是像素。如果你忽略了这个属性，Flash会自动衡量。在ColdFusion的XSL皮肤，替代使用的是style属性。

style

可选;

Flash and XML

 

Flash:

  • 必须是一个CSS格式里的类型指定。
  • 如果类型属性是html就忽略该属性。

更多指定Flash样式的信息，请看ColdFusion Developer's Guide里的"Creating Forms in Flash" 。不和spacer类型一起使用。

XML:

  • ColdFusion传递了style属性给XML。ColdFusion的皮肤包括了产生的HTML的类型属性。

tooltip

可选;

Flash

 

文本，用来当鼠标停在控件时候显示。在spacers上没有作用。

visible

可选;

Flash

yes

Boolean值，指定了是否展示控件。会被一个可见的控件占领的Space是空白的。在spacers上没有作用。

width

可选;

Flash

 

item的宽度，单位是像素。如果你忽略了这个属性，Flash会自动衡量宽度。在ColdFusion的XSL皮肤，替代使用的是style属性。
使用方法

该标签要求一个结束标签或在打开标签的关闭结束字母前的斜线。如下所示：

<cfformitem type="hrule" />

更多在Flash表单里使用该标签的信息请看ColdFusion Developer's Guide里的 "Creating Forms in Flash"。

范例

下面的范例展示了通过使用水平的rules 和 text来展示 一个简单的Flash表单。（The following example shows a simple Flash form by using horizontal rules and text:）

<h3>cfformitem Example</h3>
<cfform name="myform" height="450" width="500" format="Flash" >
    <cfformitem type="hrule" />
    <cfformitem type="text">
        This simple form has two hrule cfformitem tags around the cfformitem tag that
            contains this text.
    </cfformitem>
    <cfformitem type="hrule" />
</cfform>

更复杂的表单, 请看 cfformgroup.