描述

使用特定的模板输出一个自定义的UI widget(组件).附加的对象可以通过param标签传递给模板.设置的对象可以在模板里面通过 $parameters.paramname 获取.

在后面的JSP和Velocity例子里,两个参数被传递给组件.在component(组件)内部,它们可以通过 $parameters.get('key1') 和 $parameters.get('key2') 的方式被访问.Velocity也允许你通过 $parameters.key1 和 $parameters.key2来引用它们.

目前,你的自定义UI组件可以使用Velocity,JSP或者Freemarker编写,通过文件的后缀会找到正确的处理引擎来处理.

注意: value参数总是会被在OgnlValueStack上进行运算,因此如果你想传递一个字符串常量给你的组件,确保它包含在引号中,例如 value="'value1'",否则,value stack会在stack上搜索一个包含方法名为getValue1()的对象.(我是这么写的,但是我不完全确定是这样的.我会很快验证它)

参数

名称	必填	缺省值	类型	描述
theme	false		Object/String	用来输出元素的theme(不使用缺省)
template	false		Object/String	用来输出元素的template(不使用缺省)
cssClass	false		Object/String	元素使用的css class
cssStyle	false		Object/String	元素使用的css style
title	false		Object/String	设置输出的html元素的html title属性
disabled	false		Object/String	设置输出的html元素的属性 disabled
label	false		Object/String	输出一个元素的label的表达式
labelPosition	false	left	Object/String	不推荐.
labelposition	false		Object/String	定义表单元素的label的位置 (top/left)
requiredposition	false		Object/String	定义必填元素的位置 (left\|right)
name	false		Object/String	元素的名字
required	false	false	Boolean	如果设置为true,输出的元素会被标识为必填
tabindex	false		Object/String	设置输出的html元素的tabindex属性
value	false		Object/String	预设input元素的value.
onclick	false		Object/String	设置html元素的onclick属性
ondblclick	false		Object/String	设置html元素的ondblclick
onmousedown	false		Object/String	设置html元素的 onmousedown 属性
onmouseup	false		Object/String	设置html元素的 onmouseup 属性
onmouseover	false		Object/String	设置html元素的 onmouseover属性
onmousemove	false		Object/String	设置html元素的 onmousemove属性
onmouseout	false		Object/String	设置html元素的 onmouseout属性
onfocus	false		Object/String	设置html元素的 onfocus 属性
onblur	false		Object/String	设置html元素的 onblur 属性
onkeypress	false		Object/String	设置html元素的 onkeypress属性
onkeydown	false		Object/String	设置html元素的 onkeydown属性
onkeyup	false		Object/String	设置html元素的onkeyup属性
onselect	false		Object/String	设置html元素的 onselect属性
onchange	false		Object/String	设置html元素的 onchange属性
tooltip	false		String	设置特别组件的tooltip属性
tooltipConfig	false		String	设置tooltip元素的配置
id	false		Object/String	元素的id. 对于UI和表单标签它会被用作HTML的id属性

例子

JSP

<ww:component template="/my/custom/component.vm"/>

或者

<ww:component template="/my/custom/component.vm">
      <ww:param name="key1" value="value1"/>
      <ww:param name="key2" value="value2"/>
    </ww:component>

Velocity

#tag( Component "template=/my/custom/component.vm" )

或者

#bodytag( Component "template=/my/custom/component.vm" )
      #param( "key1" "value1" )
      #param( "key2" "value2" )
    #end