Seam与JSF框架

a4j:support
在 UIComponent-based 组件上添加ajax 功能,使他们有JavaScript 事件属性.
在解码期间:如果一个请求为Ajax-performed, 从ExternalContext 中的requestParameterMap 属性中得到Map,如果该Map 中"clientId" key 对应的值非空,在组件上创建一个 javax.faces.event.ActionEvent, 并且传递该事件到
该组件的queueEvent()中,然后把他的reReander 区域中的组件id 添加到reReander 属性中.在编码过程中.不编码一个组件. 相反的,在父组件上添加一个与事件属性的值相同的值绑定.结果,当呈现时,父组件创建一个在提交一个ajax 请求时用到的JS 代码.如果该组件有子UIParameter 组件,添加他的name/value 作为附加的请求参数.如果父组件是一个UIInput 的实例,并且ajaxType 属性是input, 则也提交input 域中的值. 在这种情况下,你可以在UIForm 外面提交一个单一的input 域.
a4j:support 属性

actionListener
方法绑定,当该组件被ajax 请求激活时,将调用该监听器方法处理该事件.该方法必须为public 的并且接受一个 AjaxEvent 参数,返回void.

action
方法绑定到要被激活的程序动作方法, 如果该
UIComponent 被用户激活, 根据immediate 属性的值,方法在 请求处理生命周期中的Apply Request Values 或者 Invoke Application 阶段 被调用.

oncomplete
在客户端请求完成时调用的js 代码

rendered
如果为false,该组件将不会被显示.

status
Request status 组件的id(在 UIComopnent.findComponent()中使用)

reRender
该组件调用Ajax 请求后重新渲染的组件的ID(在 UIComopnent.findComponent()中使用),可以使一个id,也
可以使逗号分开的很多id,或者是数据or 集合的EL 表达式

targetId
reRender 的别名 : 该组件调用Ajax 请求后重新渲染的组件
的ID(在 UIComopnent.findComponent()中使用),可以使一
个id,也可以使逗号分开的很多id,或者是数据or 集合的EL
表达式

id
每个组件都应该有个唯一的id. 如果没有指定的话,将会自动产生.

disableDefault
使目标事件的动作不可用 ( 在javascript 代码中添加 "return false;" )

requestDelay
在JS 事件上延迟 ( 单位 ms. )发送Ajax 请求.与事件队列公共工作可以减少键盘或者鼠标移动触发请求的次数

eventsQueue
用来避免在同一个事件上的重复请求的队列的名字.可以用来减少周期事件(如:按键,鼠标移动)请求的次数.

bypassUpdates
如果使true,在处理验证阶段后跳过更新模型值阶段到呈现阶段.可以用来验证组件的输入值.

immediate
如果该组件被Ajax 请求激活的话,标记该组件应该立即(在
应用请求值阶段)被感兴趣的监听器和动作处理,而不是等
到调用应用程序阶段.(译者注:该标记和JSF 中的immediate
标记所代表的意思差不多,跳过验证阶段到呈现响应阶段)

limitToList
如果为true,仅仅更新'reRender'属性中指定的组件,否则
(默认值)更新所有Ajax Region 中的组件

ajaxSingle
如果为 true , 仅仅提交一个field/link,而不是整个form
中的内容.

event
父组件的JS 事件属性的名称 ( onclick , onchange,
etc. ) , for which we will build AJAX submission code.

binding
组件绑定.
所有你需要指定的东西 - 父组件用来触发ajax 请求的事件和被reRender 的区域, 和处理事件的Java bean 方法.
Code:

 <a4j:region selfRendered="true"> 
 <h:selectBooleanCheckbox value="#{pizza.tip}"> 
 <a4j:support event="change" reRender="#{partsId.list}" 
 action="#{Some.show_hide}"/> 
 </h:selectBooleanCheckbox> 
 </a4j:region> 
 

因此,在上面的例子中,checkbox 状态的改变将提交当前的区域. 'show_hide'动作将被调用,并且 'list'中的id 所指定的组件将被更新.

a4j:commandLink
呈现一个Html <a> 元素,当点击时的动作就象一个form 提交一样.
在解码的过程中:
从ExternalContext 的属性requestParameterMap 中得到一个Map,如果该Map 中包含"clientId" key 的非空值, 在组件上创建一个 Javax.faces.event.ActionEvent 事件,并且传递该事件给组件的queueEvent() 方法.如果该请求是Ajax-performed,把reRander 属性中的IDs 值添加到嵌套的AjaxContainer 的 rendered areas list 中 ,在解码的过程中也添加组件的参数
(PARAM_NAME 和 PARAM_VALUE 是任何嵌套的子UIParameter 的names 和 values .) names 和 values 必须是被URLEncoded 处理过的.如果styleClass 属性被指定了,呈现它的值为html 中的class 属性的值. 呈现任何non-UIParameter 子组件为<a>的相应的子组件. 这些看起来就像一个Link 文
本.
a4j:commandLink

actionListener
方法绑定,当该组件被ajax 请求激活时,将调用该监听器方法
处理该事件.该方法必须为public 的并且接受一个 AjaxEvent
参数,返回void.

title
该组件产生的标记元素的提示文字(当鼠标移动到该组件上面
出现的提示文字)

oncomplete
在客户端请求完成时调用的js 代码

shape
default|rect|circle|poly [CI] 该属性指定一个区域的形状.可能的取值: * default: 指定整个区域. * rect:指定一个矩形区域. * circle: 定义一个圆形区域. * poly: 定义一个多边形区域.

rendered
如果为false,该组件将不会被显示.

charset
该属性指定了通过链接指派的资源的字符编码.

reRender
该组件调用Ajax 请求后重新渲染的组件的ID(在 UIComopnent.findComponent()中使用),可以使一个id,也可
以使逗号分开的很多id,或者是数据or 集合的EL 表达式

targetId
Alias for reRender : 该组件调用Ajax 请求后重新渲染的组
件的ID(在 UIComopnent.findComponent()中使用),可以使一
个id,也可以使逗号分开的很多id,或者是数据or 集合的EL
表达式

id
每个组件都应该有个唯一的id. 如果没有指定的话,将会自动
产生.

dir 文本方向.
rev
该属性用来描述从通过 href 属性指定的锚点到当前文档的
反向链接。该属性值是通过空格分隔的 link 类型(值)的列
表。

bypassUpdates
如果使true,在处理验证阶段后跳过更新模型值阶段到呈现阶
段.可以用来验证组件的输入值.

styleClass
和HTML 的class 属性一样.

accesskey
触发该组件的快捷键

limitToList
如果为true,仅仅更新'reRender'属性中指定的组件,否则(默认值)更新所有Ajax Region 中的组件

onkeypress
键盘事件,键被按下和松开

ajaxSingle
如果使true,仅仅提交一个field/link,而不是所有被控制的

ondblclick HTML: 双击事件
style HTML: 应用在该组件上的CSS.
onblur 当元素失去焦点时发生的事件
onmouseover
当滑鼠移动到组件上方时
onkeyup 当使用者按下并放开按键
value 该组件的当前值

action
方法绑定到要被激活的程序动作方法, 如果该 UIComponent
被用户激活, 根据immediate 属性的值,方法在 请求处理生命
周期中的Apply Request Values 或者 Invoke Application 阶
段 被调用.

tabindex 设置不同元素之间获得焦点的顺序

hreflang
该属性指定了通过 href 指派的资源的基本语言，并且仅在
href 被指定的情况下使用(也就是说如果 A 中没有指定
href 属性，就不应该出现 hreflang 属性)。

type
该属性指定链接资源所采用的内容类型。(译者注:例如网页通
常为 text/html)

lang 产生该组件标记所使用的语言

onclick
当鼠标点击时发生的事件
status 请求状态组件的ID(在UIComopnent.findComponent()中使用)
onmouseout 鼠标光标移开元素时发生的事件
onkeydown 键按下时发生的事件
onmousedown 按下鼠标按键时发生的事件

requestDelay
在JS 事件上延迟 ( 单位 ms. )发送Ajax 请求.与事件队列公
共工作可以减少键盘或者鼠标移动触发请求的次数

eventsQueue
用来避免在同一个事件上的重复请求的队列的名字.可以用来
减少周期事件(如:按键,鼠标移动)请求的次数.
rel
该属性描述了从当前文档到通过 href 属性定义的锚点之间
的关系。该属性值是通过空格分隔的 link 类型(值)的列表
(译者注:在 Web 标准开发中，这个通常用来代替 target 属
性，配合脚本，用来表示目的窗口)。

immediate
如果该组件被Ajax 请求激活的话,标记该组件应该立即(在应
用请求值阶段)被感兴趣的监听器和动作处理,而不是等到调
用应用程序阶段.(译者注:该标记和JSF 中的immediate 标记
所代表的意思差不多,跳过验证阶段到呈现响应阶段)

onfocus 使用在表单元素中，当元素获得焦点时发生的事件
onmouseup 当释放鼠标按键时发生的事件
binding 组件绑定.
onmousemove 鼠标光标在元素上移动时发生的事件
coords
定义区域 -- coords
a.矩形：必须使用四个数字，前两个数字为左上角座标，后两
个数字为右下角座标
例：Code:

＜area shape=rect coords=100,50,200,75 href="URL" 
 ＞ 

b.圆形：必须使用三个数字，前两个数字为圆心的座标，最后
一个数字为半径长度
例：Code:

＜area shape=circle coords=85,155,30 href="URL"＞ 

c.任意图形（多边形）：将图形之每一转折点座标依序填入
例：Code:

＜area shape=poly 
 coords=232,70,285,70,300,90,250,90,200,78 href="URL"＞ 

通常a4j:commandLink 是一个 具有AJAX 支持的HTML

<input> 元素. 包含所
有的a4j: support 的主要功能, 还有它自己的onclick 事件的Ajax 请求和所有
与a4j:Support 组合的CommandLink 特性.



a4j:commandButton
呈现一个HTML "input" 元素.
在解码的过程中:
从ExternalContext 的属性requestParameterMap 中得到一个Map,如果该Map 中包含"clientId" key 的非空值, 在组件上创建一个 javax.faces.event.ActionEvent 事件,并且传递该事件给组件的queueEvent() 方法.如果该请求是Ajax-performed,把reRander 属性中的IDs 值添加到嵌套的AjaxContainer 的 rendered areas list 中 . 在编码的过程中: 为onclick 事件创建一个AJAX.Submit JavaScript 调用.呈现组件的clientId 为name 属性的值.呈现组件的当前值为value 属性的值. 如果styleClass 属性被指定了,呈现它的值为class 属性的值. 呈现 HTML "input"元素的子元素.


a4j:commandButton
actionListener
方法绑定,当该组件被ajax 请求激活时,将调用该监听器方法
处理该事件.该方法必须为public 的并且接受一个 AjaxEvent
参数,返回void.

title
该组件产生的标记元素的提示文字(当鼠标移动到该组件上面
出现的提示文字)

oncomplete 在客户端请求完成时调用的js 代码

rendered 如果为false,该组件将不会被显示.

reRender
该组件调用Ajax 请求后重新渲染的组件的ID(在
UIComopnent.findComponent()中使用),可以使一个id,也可
以使逗号分开的很多id,或者是数据or 集合的EL 表达式

targetId
Alias for reRender : 该组件调用Ajax 请求后重新渲染的组
件的ID(在 UIComopnent.findComponent()中使用),可以使一
个id,也可以使逗号分开的很多id,或者是数据or 集合的EL
表达式

onchange
使用在表单元素中，当某些东西改变时发生的事件

dir 文本方向.

id
每个组件都应该有个唯一的id. 如果没有指定的话,将会自动产生.

bypassUpdates
如果使true,在处理验证阶段后跳过更新模型值阶段到呈现阶段.可以用来验证组件的输入值.

styleClass 和HTML 的class 属性一样.

accesskey 触发该组件的快捷键

limitToList
如果为true,仅仅更新'reRender'属性中指定的组件,否则(默认值)更新所有Ajax Region 中的组件

onkeypress 键盘事件,键被按下和松开

ajaxSingle 如果使true,仅仅提交一个field/link,而不是所有被控制的

ondblclick HTML: 双击事件

image
在这个button 中要显示的图片的绝对或者相对URL 如果指定了该 "input" 元素将为"image"类型.

style HTML: 应用在该组件上的CSS.

size 定义组件显示的尺度

onblur 当失去焦点时发生的事件

onmouseover 当滑鼠移动到组件上方时

value 该组件的当前值

action
方法绑定到要被激活的程序动作方法, 如果该 UIComponent
被用户激活, 根据immediate 属性的值,方法在 请求处理生命
周期中的Apply Request Values 或者 Invoke Application 阶
段 被调用.

onkeyup 当使用者按下并放开按键

tabindex 设置不同元素之间获得焦点的顺序

lang 产生该组件标记所使用的语言

type
submit|reset|image|button 指定创建组件的类型,默认值为
Submit.

disabled 把控件的状态设置为不能使用

onclick 当鼠标点击时发生的事件

status 请求状态组件的ID(在UIComopnent.findComponent()中使用)

onmouseout 鼠标光标移开元素时发生的事件
alt 文本方向.
onkeydown 键按下时发生的事件
onmousedown 按下鼠标按键时发生的事件

requestDelay
在JS 事件上延迟 ( 单位 ms. )发送Ajax 请求.与事件队列公共工作可以减少键盘或者鼠标移动触发请求的次数

eventsQueue
用来避免在同一个事件上的重复请求的队列的名字.可以用来减少周期事件(如:按键,鼠标移动)请求的次数.

immediate
如果该组件被Ajax 请求激活的话,标记该组件应该立即(在应用请求值阶段)被感兴趣的监听器和动作处理,而不是等到调用应用程序阶段.(译者注:该标记和JSF 中的immediate 标记所代表的意思差不多,跳过验证阶段到呈现响应阶段)

onfocus 当组件获得焦点时发生的事件

onmouseup 当释放鼠标按键时发生的事件

binding 组件绑定.

onmousemove 鼠标光标在元素上移动时发生的事件

简单来说a4j:CommandButton 是一个带有AJAX Support 的 HTML <input> 元素 . 包含所有的a4j:support 的主要功能, 还有它自己的onclick 事件的Ajax 请求和所有与a4j:Support 组合的CommandButton 特性.