|
html:text>和<html:textarea>标记分别html文本框和文本区,属性如下:
属性描述property 定义当表单被提交时送回到服务器的请求参数的名称,或用来确定文本元素当前值的bean的属性名称name 属性被查询的bean的名称,它决定了文本框和文本区的值。如果没有设置,将使用与这个内嵌表单相关的actionform的名称
<html:text>标记还有以下属性:
属性描述maxlength 能够输入的最大字符数
22
size 文本框的大小(字符数)
<html:textarea>标记特有的属性如下:
属性描述rows 文本区的行数cols 文本区的列数
e) 检查框和复选框标记
<html:checkbox>标记能够显示检查框控件。<html:multibox>标记能够显示html复选框控件,请求对象在传递检查框名称时使用的getparametervalues()调用将返回一个字符串数组。属性如下:
属性描述name bean的名称,其属性会被用来确定检查是否以选中的状态显示。如果没有设置,将使用与这个内嵌表单相关的actionfrom bean的名称。property 检查框的名称,也是决定检查框是否以选中的状态显示的bean属性名称。在复选框的情况下,这个属性必须是一个数组。value 当检查框被选中时返回到服务器的请求参数的值
例如:
<html:checkbox property=”married” value=”y”/>
一个名为married的检查框,在表单提交时会返回一个”y”.
f) 文件标记
<html:file>标记可以显示html文件控件。属性如下:
属性描述name bean的名称,它的属性将确定文件控件中显示的内容。如果没设置,将使用与内嵌表单相关的actionform bean的名称property 这个属性定义了当表单被提交时送回到服务器的请求参数的名称,以及用来确定文件控件中显示内容的bean属性名称accept 服务器能够处理的内容类型集。它也将对客户浏览器对话框中的可选文件类型进行过滤value 按钮上的标记,这个按钮能够在本地文件系统中浏览文件
g) 单选钮标记
<html:radio>标记用来显示html单选钮控件,属性如下:
属性描述name bean的名称,其属性会被用来确定单选钮是否以选中的状态显示。如果没有设置,将使用与这个内嵌表单相关的actionfrom bean的名称。property 当表单被提交时送回到服务器的请求参数的名称,以及用来确定单选钮是否以被选中状态进行显示的bean属性的名称
23
value 当单选钮被选中时返回到服务器的值
h) 隐藏标记
<html:hidden>标记能够显示html隐藏输入元素,属性如下:
属性描述name bean的名称,其属性会被用来确定隐藏元素的当前值。如果没有设置,将使用与这个内嵌表单相关的actionfrom bean的名称。property 定义了当表单被提交时送回到服务器的请求参数的名称,以及用来确定隐藏元素当前值的bean属性的名称value 用来初始化隐藏输入元素的值
i) 密码标记
<html:password>标记能够显示html密码控件,属性如下:
属性描述maxlength 能够输入的最大字符数name bean的名称,它的属性将用来确定密码元素的当前值。如果没有设置,将使用与这个内嵌表单相关的actionfrom bean的名称。property 定义了当表单被提交时送回到服务器的请求参数的名称,以及用来确定密码元素当前值的bean属性的名称redisplay 在显示这个字段时,如果相应的bean属性已经被设置了数据,这个属性决定了是否显示密码的内容size 字段的大小
j) 选择标记
<html:select>标记能够显示html选择控件,属性如下:
属性描述multiple 表明这个选择控件是否允许进行多选name bean的名称,它的属性确定了哪个。如果没有设置,将使用与这个内嵌表单相关的actionfrom bean的名称。property 定义了当表单被提交时送回到服务器的请求参数的名称,以及用来确定哪个选项需要被选中的bean属性的名称size 能够同时显示的选项数目value 用来表明需要被选中的选项
k) 选项标记(这个元素需要嵌套在<html:select>标记里)
<html:option>标记用来显示html选项元素集合,属性如下:
24
属性描述collection bean集合的名称,这个集合存储在某个作用域的属性中。选项的数目与集合中元素的数目相同。property属性能够定义选项值所使用的bean属性,而labelproperty属性定义选项标记所使用的bean的属性labelname 用来指定存储于某个作用域的bean,这个bean是一个字符串的集合,能够定义<html:option>元素的标记(如果标志与值不相同) labelproperty 与collection属性共同使用时,用来定义了存储于某个作用域的bean,这个bean将返回一个字符串集合,能够用来写入<html:option>元素的value属性name 如果这是唯一被指定的属性,它就定义了存储于某个作用域的bean,这个bean将返回一个字符串集合,能够用来写入<html:option>元素的value属性property 这个属性在与collection属性共同使用时,定义了每个要显示选项值的独立bean的name属性。如果不是与collection属性共同使用,这个属性定义了由name属性指定的bean的属性名称(如果有name属性),或是定义了一个actionform bean,这个bean将返回一个集合来写入选项的值
我们看一下这个标记的一些例子:
<html:option collection=”optioncollection” property=”optionvalue”
labelproperty=”optionlabel”/>
标记假设在某个作用域中有一个名为optioncollection的集合,它包含了一些具有optionvalue属性的独立的bean,每个属性将作为一个选项的值。每个选项的标志由bean的optionlabel属性属性进行定义。
<html:option name=”optionvalues” labelname=”optionlabels”/>
标记中optionvalues代表一个存储在某个作用域中的bean,它是一个字符串集合,能够用来写入选项的值,而optionlabels代表一个存储在某个作用域中的bean,它也是一个字符串集合,能够用来写入选项的标志。
2.3.2.显示错误信息的标记
<html:errors>标记能够与actionerrors结合在一起来显示错误信息。这个标记首先要从当前区域的资源文件中读取消息关键字errors.header,然后显示消息的文本。接下去它会在actionerrors对象(通常作为请求参数而存储在action.error_key关键字下)中循环,读取单个actionerror对象的消息关键字,从当前区域的资源文件中读取并格式化相应的消息,并且显示它们。然后它读取与errors.footer关键字相对应的消息并且显示出来。
通过定义property属性能够过滤要显示的消息,这个属性的值应该与actionerrors对象中存储actionerror对象的关键字对应。属性如下:
属性描述bundle 表示应用程序作用域属性的名称,它包含着消息资源,其默认值acion.message_key locale 表示会话作用域属性的名称,它存储着用户当前登录的区域信息。其默认值是action.error_key
25
name 表示请求属性的名称,它存储着actionerrors对象。其默认值是action.error_key property 这个属性指定了actionerrors对象中存储每个独立actionerror对象的关键字,它可以过滤消息
例子:
<html:errors/>
显示集合中所有的错误。
<html:errors property=”missing.name”/>
显示存储在missing.name关键字的错误。
2.3.3.其他html标记
struts html标记还定义了下列标记来显示其他html元素:
<html:html> : 显示html元素
<html:img> : 显示图象标记
<html:link> : 显示html链接或锚点
<html:rewrite> : 创建没有锚点标记的uri
这些标记的详细内容请参照struts文档。
2.4. 模板标记
动态模板是模块化web页布局设计的强大手段。struts模板标记库定义了自定义标记来实现动态模板。
2.4.1.插入标记 |
|