注意: 在 Dreamweaver CC 和更高版本中不再支持 ColdFusion。

关于 ColdFusion 表单                

ColdFusion 表单为您提供了用于验证表单数据的几个内置机制。例如,可以检查以确保用户输入了有效的日期。一些表单控件具有其它功能。许多表单控件没有 HTML 相应部分,而其它表单控件则直接支持根据数据源动态填充控件。

Dreamweaver 为使用 ColdFusion MX 7 或更高版本作为开发服务器的 ColdFusion 开发人员提供了多种增强功能。这些增强功能包括更多的“插入”面板按钮、菜单项和属性检查器,以便您可以快速建立 ColdFusion 表单并设置其属性。还可以生成代码以验证由站点访问者提供的信息。例如,您可以检查用户提供的电子邮件地址是否包含 @ 符号,或者必填的文本域是否包含特定类型的值。

启用 ColdFusion 增强功能                  

这些增强功能中的某些功能要求您将运行 ColdFusion MX 7 或更高版本的计算机定义为 Dreamweaver 的测试服务器。例如,用于表单控件的属性检查器仅当您指定正确的测试服务器时才可用。

只需定义一次测试服务器。然后,Dreamweaver 就可自动检测测试服务器版本,并在检测到 ColdFusion 时提供增强功能。

    • 如果尚未为 ColdFusion 项目定义 Dreamweaver 站点,则请定义。

    • 选择“站点”>“管理站点”,然后从列表中选择您的站点并单击“编辑”。

    • 选择“服务器”类别并将一个运行 ColdFusion MX 7 或更高版本的计算机指定为 Dreamweaver 站点的测试服务器。确保指定了有效的 Web URL。

    • 打开任一 ColdFusion 文档。

      在打开 ColdFusion 文档之前,您将看不到对 Dreamweaver 工作区所做的任何可见更改。

创建 ColdFusion 表单                  

您可以使用多个“插入”面板按钮、菜单项和属性检查器在 Dreamweaver 中快速创建 ColdFusion 表单并设置其属性。

注意:只有您对运行 ColdFusion MX 7 或更高版本的计算机具有访问权限时,才能使用这些增强功能:

    • 打开一个 ColdFusion 页面,将插入点放在希望 ColdFusion 表单出现的位置。

    • 选择“插入”>“ColdFusion 对象”>“CFForm”>“CFForm”,或者从“插入”面板选择“CFForm”类别并单击“CF 表单”图标。

      Dreamweaver 将插入一个空的 ColdFusion 表单。在“设计”视图中,此表单以红色的虚轮廓线指示。如果没有看到此轮廓线,请确定选中了“查看”>“可视化助理”>“不可见元素”。

    • 确保表单仍处于选定状态,然后使用属性检查器设置以下任一表单属性。

      CFForm

      设置表单的名称。

      动作

      可用于指定在提交表单时要处理的 ColdFusion 页面的名称。

      方法

      可用于定义浏览器用来将表单数据发送给服务器的方法:

      POST

      使用 HTTP post 方法发送数据;此方法将单个消息中的数据发送给服务器。

      GET

      使用 HTTP get 方法发送数据,将表单域内容放置在 URL 查询字符串中。

      目标

      可用于修改 cfform 标签的目标属性的值。

      编码类型

      指定用来传输表单数据的编码方法。

      注意:编码类型指的不是字符编码。此属性指定用于将表单提交给服务器的内容类型(如果方法的值为 post)。此属性的默认值为 application/x-www-form-urlencoded。

      格式

      确定要创建的表单的类型:

      HTML

      生成 HTML 表单并将其发送给客户端。cfgrid 和 cftree 子控件可以使用 Flash 或 applet 格式。

      Flash

      生成 Flash 表单并将其发送给客户端。所有控件都使用 Flash 格式。

      XML

      生成 XForms XML 并将结果放置在具有 ColdFusion 表单名称的变量中。不向客户端发送任何内容。cfgrid 和 cftree 子控件可以使用 Flash 或 applet 格式。

      样式

      可用于指定表单的样式。有关详细信息,请参阅 ColdFusion 文档。

      Flash/XML 外观

      可用于指定光晕颜色以设置输出的样式。该主题确定用于高亮显示和所选元素的颜色。

      保留数据

      确定在表单发送到自身时是否用提交值覆盖初始控件值。

      • 如果为 False,则使用在控件标签属性中指定的值。

      • 如果为 True,则使用提交的值。

      脚本源文件

      指定 JavaScript 文件(包含标签及其子标签使用的客户端代码)相对于 Web 根目录的 URL。如果该文件不在默认位置,则此属性十分有用。在某些阻止对 /CFIDE 目录进行访问的主机环境和配置中,可能需要此属性。默认位置在“ColdFusion 管理员”中设置;默认情况下为 /CFIDE/scripts/cfform.js。

      存档

      为 cfgrid、cfslider 和 cftree applet 控件指定可下载 Java 类的 URL。默认位置为 /CFIDE/classes/cfapplets.jar。

      高度

      指定表单的高度。

      宽度

      指定表单的宽度。

      为 cfform 显示标签编辑器

      可用于编辑属性检查器中未列出的属性。

    • 插入 ColdFusion 表单控件。

      在 ColdFusion 表单中将插入点放置在希望 ColdFusion 表单控件出现的位置上,然后从“插入”菜单中选择该控件(“插入”>“ColdFusion 对象” >“CFForm”),或者从“插入”面板中的“CFForm”类别中选择该控件。

    • 如果需要,用属性检查器设置该控件的属性。

      确保在“设计”视图中选择了该控件,然后在属性检查器中设置属性。有关这些属性的详细信息,请单击属性检查器中的“帮助”图标。

    • 调整 ColdFusion 表单的布局。

      如果要创建基于 HTML 的表单,可以使用换行符、段落标记、预格式化文本或表格来设置表单的格式。不能将一个 ColdFusion 表单插入另一个 ColdFusion 表单中(即标签不能交迭),但是可以在一个页面中包含多个 ColdFusion 表单。

      如果要创建基于 Flash 的表单,则使用层叠样式表 (CSS) 样式对表单进行布局。ColdFusion 会忽略表单中的所有 HTML。

      请记住用描述性文本作为 ColdFusion 表单域的标签,以使用户可以知道自己正在对什么内容进行响应。例如,创建一个“键入您的姓名”标签以要求输入姓名信息。

插入 ColdFusion 表单控件                

使用“插入”面板或“插入”菜单快速将 ColdFusion 表单控件插入到 ColdFusion 表单中。应先创建空的 ColdFusion 表单,然后再将控件插入其中。

注意:只有您对运行 ColdFusion MX 7 或更高版本的计算机具有访问权限时,才能使用这些增强功能。

    • 在“设计”视图中,将插入点放在表单轮廓内。

    • 从“插入”菜单(“插入”>“ColdFusion 对象”>“CFForm”)中或“插入”面板的“CFForm”类别中选择控件。

    • 在页面上单击该控件以选择它,然后在属性检查器中设置其属性。

      有关特定控件的属性的信息,请参阅控件相关的主题。

插入 ColdFusion 文本域                  

可以以可视方式将 ColdFusion 文本域或密码域插入到表单中,然后设置其选项。

注意: 只有您对运行 ColdFusion MX 7 或更高版本的计算机具有访问权限时,才能使用此增强功能。

以可视方式插入 ColdFusion 文本域                

    • 在“设计”视图中,将插入点放在表单轮廓内。

    • 在“插入”面板中的“CFForm”类别中,单击“CF 文本域”图标,或选择“插入”>“ColdFusion 对象”>“CFForm”>“CFtextfield”。

      一个文本域随即出现在表单中。

    • 选择文本域,并在属性检查器中设置其属性。

    • 若要在页面中为文本域添加标签,请在该文本域旁单击,然后键入标签文本。

以可视方式插入密码域                  

    • 重复前面步骤中的步骤 1 和步骤 2 以插入文本域。

    • 选择插入的文本域以显示其属性检查器。

    • 在属性检查器中,从“文本模式”弹出菜单中选择“密码”值。

CFTextField 选项 (ColdFusion)                  

若要设置 ColdFusion 文本域或密码域的选项,请在 CFTextField 属性检查器中设置以下任一选项:

CFtextfield

设置 id 属性(针对 <cfinput> 标签)。

可用于指定当页面在浏览器中第一次打开时要在域中显示的文本。它既可以是静态信息,也可以是动态信息。

若要指定动态值,请单击“值”框旁的闪电图标,然后在“动态数据”对话框中选择一个记录集列。在浏览器中查看表单时,该记录集列向文本域提供一个值。

文本模式

用于在标准文本输入域和密码输入域之间进行切换。由此控件修改的属性为 type

只读

可用于将显示文本设置为只读。

最大长度

设置文本域可以接受的最大字符数。

掩码

可用于为所请求的文本指定掩码。此属性可用于验证用户输入。掩码格式由 A、9、X 和 ? 字符组成。

注意:如果是 cfinput type="password" 标签,则忽略掩码属性。

验证

为当前域指定验证类型。

验证于

指定域的验证时间:onSubmit、onBlur 或 onServer。

标签

可用于为文本域指定标签。

模式

可用于指定 JavaScript 正则表达式模式以验证输入。省略前导斜杠和结尾斜杠。

高度

可用于指定控件的高度(以像素为单位)。

宽度

可用于指定控件的宽度(以像素为单位)。

大小

可用于指定控件的大小。

必填

可用于指定在将表单提交给服务器前文本域是否必须包含数据。

显示标签编辑器

可用于编辑属性检查器中未列出的属性。

插入 ColdFusion 隐藏域                  

可以以可视方式将 ColdFusion 隐藏域插入到表单中并设置其属性。使用隐藏域可以存储或提交无需用户输入的信息。该信息对用户而言是隐藏的。

注意:只有您对运行 ColdFusion MX 7 或更高版本的计算机具有访问权限时,才能使用此增强功能。

    • 在“设计”视图中,将插入点放在表单轮廓内。

    • 在“插入”面板的“CFForm”类别中,单击“CF 隐藏字段”图标。

      一个标记随即出现在 ColdFusion 表单中。如果看不到标记,可选择“查看”>“可视化助理”>“不可见元素”。

    • 选择页面中的隐藏域,在属性检查器中设置以下任一选项:

      Cfhiddenfield

      可用于为隐藏域指定唯一名称。

      可用于为隐藏域指定值。它既可以是静态数据,也可以是动态数据。

      若要指定动态值,请单击“值”框旁的闪电图标,然后在“动态数据”对话框中选择一个记录集列。在浏览器中查看表单时,该记录集列向文本域提供一个值。

      验证

      为当前域指定验证类型。

      验证于

      指定域的验证时间:onSubmit、onBlur 或 onServer。

      标签

      可用于为控件指定标签。ColdFusion 服务器在运行时将忽略此属性。

      模式

      可用于指定 JavaScript 正则表达式模式以验证输入。省略前导斜杠和结尾斜杠。

      高度

      可用于指定控件的高度(以像素为单位)。ColdFusion 服务器在运行时将忽略此属性。

      宽度

      可用于指定控件的宽度(以像素为单位)。ColdFusion 服务器在运行时将忽略此属性。

      大小

      可用于指定控件的大小。ColdFusion 服务器在运行时将忽略此属性。

      必填

      可用于指定在将表单提交给服务器前隐藏文本域是否必须包含数据。

      显示标签编辑器

      可用于编辑属性检查器中未列出的属性。

插入 ColdFusion 文本区域                  

可以以可视方式将 ColdFusion 文本区域插入到表单中并设置其属性。文本区域为包含多行文本的输入元素。

注意:只有您对运行 ColdFusion MX 7 或更高版本的计算机具有访问权限时,才能使用此增强功能。

    • 将插入点放在表单轮廓内。

    • 在“插入”面板的“CFForm”类别中,单击“CF 文本区域”图标。

      一个文本区域随即出现在 ColdFusion 表单中。

    • 选择页面中的文本域,在属性检查器中设置以下任一选项:

      Cftextarea

      可用于为控件指定唯一名称。

      字符宽度

      可用于设置每行的字符数。

      行数

      可用于设置文本区域中显示的行数。

      换行

      可用于指定用户输入文本如何换行。

      必填

      可用于指定用户是必须在域中输入数据(已选中),还是不必在域中输入数据(未选中)。

      初始值

      可用于指定当页面最初在浏览器中打开时要在文本区域中显示的文本。

      验证

      指定域的验证类型。

      验证于

      指定域的验证时间:onSubmit、onBlur 或 onServer。

      标签

      可用于为控件指定标签。

      样式

      可用于指定控件的样式。有关详细信息,请参阅 ColdFusion 文档。

      高度

      可用于指定控件的高度(以像素为单位)。ColdFusion 服务器在运行时将忽略此属性。

      宽度

      可用于指定控件的宽度(以像素为单位)。ColdFusion 服务器在运行时将忽略此属性。

      显示标签编辑器

      可用于编辑属性检查器中未列出的属性。

    • 若要设置文本区域的标签,请在该文本区域旁单击,然后输入标签文字。

插入 ColdFusion 按钮                  

可以以可视方式将 ColdFusion 按钮插入到表单中并设置其属性。ColdFusion 按钮控制 ColdFusion 表单的操作。ColdFusion 按钮可以用于将 ColdFusion 表单数据提交到服务器或重置 ColdFusion 表单。标准 ColdFusion 按钮通常带有“提交”、“重置”或“发送”标签。您还可以分配其它已经在脚本中定义的处理任务。例如,该按钮可以根据指定的值计算所选项目的总价。

注意:只有您对运行 ColdFusion MX 7 或更高版本的计算机具有访问权限时,才能使用此增强功能。

    • 将插入点放在 ColdFusion 表单轮廓内。

    • 在“插入”面板的“CFForm”类别中,单击“CF 按钮”图标。

      一个按钮随即出现在 ColdFusion 表单中。

    • 选择页面中的按钮,在属性检查器中设置以下任一选项:

      Cfbutton

      可用于为控件指定唯一名称。

      动作

      可用于指定要创建的按钮的类型。

      显示标签编辑器

      可用于编辑属性检查器中未列出的属性。

      ColdFusion 服务器在运行时将忽略其它属性。

插入 ColdFusion 复选框                  

可以以可视方式将 ColdFusion 复选框插入到表单中并设置其属性。使用复选框使用户可以从一组选项中选择多个选项。

注意:只有您对运行 ColdFusion MX 7 或更高版本的计算机具有访问权限时,才能使用此增强功能。

    • 将插入点放在表单轮廓内。

    • 在“插入”面板的“CFForm”类别中,单击“CF 复选框”图标。

      一个复选框将出现在 ColdFusion 表单中。

    • 选择页面中的复选框,在属性检查器中设置以下任一选项:

      Cfcheckbox

      可用于为控件指定唯一名称。

      选定值

      可用于指定在用户选中复选框时由其返回的值。

      初始状态

      可用于指定当页面在浏览器中第一次打开时是否选中复选框。

      验证

      指定复选框的验证类型。

      验证于

      指定复选框的验证时间:onSubmit、onBlur 或 onServer。

      标签

      可用于为复选框指定标签。

      模式

      可用于指定 JavaScript 正则表达式模式以验证输入。省略前导斜杠和结尾斜杠。

      高度

      可用于指定控件的高度(以像素为单位)。ColdFusion 服务器在运行时将忽略此属性。

      宽度

      可用于指定控件的宽度(以像素为单位)。ColdFusion 服务器在运行时将忽略此属性。

      大小

      可用于指定控件的大小。ColdFusion 服务器在运行时将忽略此属性。

      必填

      可用于指定在将表单提交给服务器前是否必须选中复选框。

      显示标签编辑器

      可用于编辑属性检查器中未列出的属性。

    • 若要为复选框添加标签,请在页面上相应复选框的旁边单击,然后键入标签文本。

插入 ColdFusion 单选按钮                  

可以以可视方式将 ColdFusion 单选按钮插入到表单中并设置其属性。在要求用户只能从一组选项中选择一个选项时,请使用单选按钮。单选按钮通常成组地使用。同一组中的所有单选按钮都必须具有相同的名称。

注意:只有您对运行 ColdFusion MX 7 或更高版本的计算机具有访问权限时,才能使用此增强功能。

    • 将插入点放在表单轮廓内。

    • 选择“插入”>“ColdFusion 对象”>“CFForm”>“CFradiobutton”。

      一个单选按钮随即出现在 ColdFusion 表单中。

    • 选择页面中的单选按钮,在属性检查器中设置以下任一选项:

      Cfradiobutton

      可用于为控件指定唯一名称。

      选定值

      可用于指定在用户选中单选按钮时由其返回的值。

      初始状态

      可用于指定当页面在浏览器中第一次打开时是否选中单选按钮。

      验证

      指定单选按钮的验证类型。

      验证于

      指定单选按钮的验证时间:onSubmit、onBlur 或 onServer。

      标签

      可用于为单选按钮指定标签。

      模式

      可用于指定 JavaScript 正则表达式模式以验证输入。省略前导斜杠和结尾斜杠。

      高度

      可用于指定控件的高度(以像素为单位)。ColdFusion 服务器在运行时将忽略此属性。

      宽度

      可用于指定控件的宽度(以像素为单位)。ColdFusion 服务器在运行时将忽略此属性。

      大小

      可用于指定控件的大小。ColdFusion 服务器在运行时将忽略此属性。

      必填

      可用于指定在将表单提交给服务器前是否必须选中单选按钮。

      显示标签编辑器

      可用于编辑属性检查器中未列出的属性。

    • 若要设置单选按钮的标签,请在页面上该按钮的旁边单击,然后输入标签文本。

,