1、A4J 用户指南Copyright 2006 Exadel 译者: icess( http:/ ) 转载请保留版权标识和译者信息. 目录 1. 介绍 2. 开始使用 Ajax4jsf 环境需求 下载 Ajax4jsf 安装 简单的 AJAX Echo 项目 JSP 页面 数据 Bean faces-config.xml Web.xml 部署3. Ajax4jsf 框架的基本概念 介绍 结构概览 如何做. 发送一个 AJAX 请求 决定发送什么 决定改变什么4. Ajax4JSF 组件库 a4j:ajaxListener a4j:region a4j:page a4j:support a4j:c
2、ommandLink a4j:commandButton a4j:outputPanel a4j:actionparam a4j:status a4j:loadBundle a4j:mediaOutput5. Ajax4jsf内建的换肤功能 6. 技术要求 支持的 java版本 支持的 JavaServer Faces 实现 支持的服务器 支持的浏览器7. 附加的设置 Web程序描述符参数 Sun JSF RI Apache MyFaces Facelets 支持 JBoss Seam 支持8. 与 IDE集成 9. Exadel VCP 和 Ajax4jsf 10. Web上的资源List
3、of Tables4.1. a4j:ajaxListener attributes 4.2. a4j:region attributes 4.3. a4j:page attributes 4.4. a4j:support attributes 4.5. a4j:commandLink attributes 4.6. a4j:commandButton attributes 4.7. a4j:outputPanel attributes 4.8. a4j:actionparam attributes 4.9. a4j:status attributes 4.10. a4j:loadBundle
4、attributes 4.11. a4j:mediaOutput attributes 7.1. Initialization Parametres 7.2. org.ajax4jsf.Filter Initialization Parametres 10.1. Ajax4jsf Resources序言:Ajax4JSF是一个很容易使用的框架.有什么问题可以在 JSF中文论坛讨论. Chapter 1. 介绍这里是一些介绍 a4j的内容,暂时先不翻译了,等有时间再补充上.Ajax4jsf 是一个添加 Ajax功能到 JSF项目中的开源框架,使用该框架不用写JS代码. Ajax4jsf 充分利用
5、了 JSF框架的优点,如: 生命周期, 验证, 转换的灵活性和受管理的静态和动态资源. 使用 Ajax4jsf, 具有 Ajax支持的富组件和高度可自定义的外观感觉可以很容易的与 JSF结合起来.Ajax4JSF 被设计用来:在使用 Ajax时充分显示 JSF的优点.Ajax4jsf 完全被结合到 JSF 生命周期中. 当其他框架仅仅给你访问 Managed Bean的便利时,Ajax4JSF 带给你 Action 和 Value Change 监听器,激活服务端验证,在 Ajax请求-响应周期中的转化 这些功能. 添加 AJAX 功能到已经存在的 JSF 项目. 该框架被实现为使用一个组件库
6、来添加 ajax功能到你的页面中,而不要写 js代码或者使用新的 Ajax装饰器替换你已经做好的 JSF组件. Ajax4jsf 具有页面范围(page-wide)的 Ajax支持,而不是传统的组件范围(component-wide)的 ajax支持. 这意味着你可以在页面中定义一个激活 Ajax请求的事件,和当根据客户端事件触发 Ajax请求来改变服务器端数据后 如何使用 JSF组件树来同步显示 JSF页面. 使用内建的 Ajax支持写自定义富组件. 将来, 我们将有一个完全的组件开发包(CDK)来支持 AJax4JSF. CDK 将包含代码生成工具和一个使用类似 JSP语法的模版工具.这些
7、功能将去除一些创建组件的一个例行工作.使用这个喝满油的组件工厂机器来创建一个带有 Ajax功能的富组件将比使用传统的编码过程创建一个简单的组件还要简单. 项目的 Java类与资源包. 除了核心的 AJAX 功能外, Ajax4jsf 也有管理资源的高级支持,例如:图片,JS 代码和 CSS样式表单,资源框架使 简单的打包这些资源到你自定义组件的 Jar文件中成为可能. 动态(on-the-fly)将非常容易. 作为另外一种附加的功能, 资源框架有一个动态产生图片的工具. 使用这个特性,你可以使用类似于使用 Java Graphic2D库的方法来创建图片. 使用基于皮肤的技术来创建一个现代富用户
8、界面的外观感觉(look-and-feel).Ajax4jsf 提供一个换肤特性 . 该特性允许通过命名的皮肤参数来简单的定义和管理不同颜色模式与其他 UI特性. 你可以从 JSP代码和 Java代码(例如:基于 UI的文本来产生动态的图片)来访问这些皮肤参数 . 注意:, 虽然换肤功能不是完全的替代传统的 CSS,但是它还是值得称赞的. 测试 components, actions, listeners, 和 pages 就像你在创建他们一样容易. 一个制动测试工具正在开发中 .它将在你开发组件使为你的组件产生测试案例. 该测试框架不仅仅测试组件,也测试服务端和客户端的功能包括 JS代码 .
9、作为附加的有用工具,你不需要单独的部署测试程序到 Servlet容器中 就可以做到这些了. Ajax4JSF 组件已经可以使用了, 因此开发者可以立即使用这种省时的具有高级特性的工具来创建提供了更快更可靠的用户体验的 Web程序了. Chapter 2. 开始使用 Ajax4jsfTable of ContentsEnvironment Downloading Ajax4jsf Installation Simple AJAX Echo Project JSP Page Data Bean faces-config.xml Web.xml Deployment环境要求要使用 Ajax4JSF
10、框架你仅仅需要 JDK1.4或者更高,任何 JSF实现,和你最喜欢的 Servlet容器.在下一章我们将给你提供详细的环境信息. Ajax4jsf 被设计为一个容易使用的框架.仅仅有一点简单的设置步骤就可以在你的 JSF程序中使用 Ajax功能了. 下载 Ajax4jsf最新的 Ajax4jsf 发布版在这里 https:/ 下载. 安装 解压 ajax4jsf.zip 文件. 复制 ajax4jsf.jar and oscache-2.2.jar 到程序的 WEB-INF/lib 文件夹下. 把下面的内容添加到你的程序的 WEB-INF/web.xml 文件中: Ajax4jsf Filte
11、r ajax4jsf org.ajax4jsf.Filter ajax4jsf Faces Servlet REQUEST FORWARD INCLUDE 注意. 你可以复制和粘贴上面的内容在 README.txt 文件中. 添加下面的内容: 到你每个使用 Ajax功能的 JSP页面中.简单的 AJAX Echo 项目 让我们来看一个简单的 JSF项目. 我们仅仅需要一个 JSP页面,里面包含一个Form和一些 JSF标签: 和 . 我们这个简单的程序应该可以让我们输入一些文字到中, 然后发送数据到 Server,并在 中显示 Server的响应(给我们一个 Echo信息). JSP 页面下面
12、是一个我们需要的页面代码 (echo.jsp) :repeater 就如你看到的,唯一一行于常给 JSF页面代码不同的就是下面的一行在这里我们在父标签()中添加了一个 AJAX 支持. 该支持绑定了JavaScript事件“onkeyup” .因此, 每一次该事件发布给父标签时,我们的程序将发送一个 AJAX请求到 Server.这意味着我们的受管理的 bean将包含该“text” 域中我们输入的最新数据. 标签的“reRender” 属性(attribute)定义我们的页面的哪一部分被更新. 在这里,该页面唯一被更新的部位是 标签,因为他的 ID值和“reRender” 的属性值向匹配. 在
13、一个页面中更新多个元素(elements)也是很简单的:仅仅把他们的 IDs放在 “reRender” 属性中就可以了. 数据 Bean当然了,为了运行这个程序我们还需要一个受管理的 beanpackage demo;public class Bean private String text;public Bean() public String getText() return text;public void setText(String text) this.text = text; faces-config.xml下一步, 我们需要在 faces-config.xml 中注册上面的 b
14、ean:beandemo.Beanrequesttext注意:这里没有任何东西直接和 Ajax4jsf 有关联.Web.xml最后,不要忘了添加 jar文件和更改 web.xml 文件: a4jEchoTextjavax.faces.STATE_SAVING_METHODserverAjax4jsf Filterajax4jsforg.ajax4jsf.Filterajax4jsfFaces ServletREQUESTFORWARDINCLUDEcom.sun.faces.config.ConfigureListenerFaces Servletjavax.faces.webapp.Face
15、sServlet1Faces Servlet*.jsfBASIC就这样了, 现在你的程序应该可以工作了.部署最终,你可以在 Servlet容器中部署你的程序了. 在你喜欢的容器中部署,然后在你的浏览器中输入: http:/localhost:8080/a4jEchoText/echo.jsf Chapter 3.Ajax4jsf 框架中的基本概念Table of ContentsIntroduction Architecture Overview How To. Send an AJAX Request Decide What to Send Decide What to Change介绍该框
16、架被实现为使用一个组件库来添加 ajax功能到你的页面中,而不要写 js代码或者使用新的 Ajax装饰器替换你已经做好的 JSF组件. Ajax4jsf 具有页面范围(page-wide)的 Ajax支持,而不是传统的组件范围(component-wide)的ajax支持. 这意味着你可以在页面中定义一个激活 Ajax请求的事件,和当根据客户端事件触发 Ajax请求来改变服务器端数据后 如何使用 JSF组件树来同步显示 JSF页面. (This means you can define the event on the page that invokes an AJAX request and
17、 the areas of the page that should be synchronized with the JSF Component Tree after the AJAX request changes the data on the server according to the events fired on the client). 下面的图片展示了它是如何工作的:Ajax4jsf 允许你定义(意味着通过 JSF tags)你希望通过 AJAX请求更新的 JSF页面的不同部分并且提供的一些发送 AJAX请求到服务器端的选项,除了你的JSF页面于常规的 JSF有点不同外,没
18、有其他的不同了,这是一个你不需要写 JS代码和 XMLHttpRequest对象的天堂. 结构概览下面的图片展示了 Ajax4jsf 框架的一些重要的元素Ajax 过滤器(Filter). 为了得到应用 Ajax4jsf 的好处 你必须在在 web.xml 文件中注册一个 Ajax Filter.该过滤器有一些职责. Ajax Filter 可以识别多种 ajax请求种类. 图片 3的序列图展示了在处理常规页面和 AJAX请求页面的不同之处.在开始的情况下,所有的 JSF树将被编码(encoded). 在第二种情况下依据 AJAX 区域(region) (你可以通过使用 tag 来定义 AJA
19、X region )的大小(size). 就如你看到的,第二种情况下 过滤器将解析 AJAX响应的内容,在它被发送到客户端以前, 查看下面的图片来理解这两种方式:在这两种情况下, 你的程序所需要的静态或者动态资源的信息将被注册到ResourseBuilder 类中.当请求一个资源时(图片 4),AJAX filter 检查资源缓存(Resource Cache)看看这个资源是否存在,如果存在该资源将被送到客户端.否则过滤器将在 ResourceBuilder中搜索注册的资源. 如果该资源被注册了,AJAX filter将发送一个请求到 ResourceBuilder 来创建create (de
20、liver)该资源.下面的图片显示了请求资源的处理过程. Ajax动作组件(Action Components). 有 3个 Ajax动作组件: AjaxCommandButton, AjaxCommandLink 和 AjaxSupport. 你可以使用他们从客户端发送 AJAX请求.Ajax容器 (Containers). AjaxContainer 是一个接口,该接口描述了在 Ajax请求中应该被解码(decoded)的 JSF页面中的一个区域.AjaxViewRoot 和 AjaxRegion 实现了该接口. JavaScript引擎 (Engine). Ajax4jsf JavaSc
21、ript 引擎 在客户端运行. 它知道如何根据来自于 Ajax响应的信息来更新你 JSF页面上的不同的区域. 程序开发者不需要直接使用这里的 JavaScript代码.它自动的下载到客户端. 如何做.发送一个 AJAX 请求从 JSF页面发送 ajax请求有不同的方法. 你可以使用 , 或者 tags. 所有的这些标签隐藏了在创建一个 XMHttpRequest 对象和发送 ajax请求所需要的 JavaScript 活动.并且, 他们允许你选择页面中那个 JSF组件被重新渲染(re-rendered) 来表现 Ajax响应的结果 (你可以列出他们的 IDs 在“reRender” 属性中).
22、 和 tags 用来在 “onclick” JavaScript 事件中发送 Ajax请求. 在你选择 JS事件(“onkeyup”, “onmouseover”, etc)时, tag 允许你在普通的 JSF组件中添加 Ajax 功能和发送 ajax请求.提供 Ajax请求功能的大部分重要的属性如下: reRender 属性 - 就如我们前面提到过的,在一个 Ajax响应到来时重新渲染(reRendered)组件. RequestDelay 属性 用来调节请求的频率. 因此每一个来自于键盘事件的请求将会延迟 3 ms ,来减少请求的次数. EventsQueue 储存下一个请求的队列的名字.
23、 队列帮助阻止下一个请求知道当前的处理完. LimitToList 用来控制更新的区域. 设置为 true 将更新仅在reRender list中的区域, 如果为 false,将更新所有 Output Panels区域. ajaxSingle 如果设置为 false用来指定发送请求的区域 如果为true则发送整个区域 - only control caused event.(attributes specify regions to be sent with request if false itll be full region in other case - only control ca
24、used event.) 决定发送什么你可能描述了一个你决定发送到服务器的页面区域.当你发送 ajax请求的时候,通过这种方式你可以控制 JSF View的那个部分在服务器端被解码(decoded).描述你 JSF页面上的一个 Ajax区域的最容易的方法是什么都不做.这是因为在和 tags 中的内容在默认值的情况下认为是 ajax区域.通过使用 tag 你可以在一个 JSF页面中定义多个 Ajax区域 (they can even be nested). 如果你希望渲染 ajax响应以外的区域,那么 renderRegionOnly属性值应该设置为 false.否则 ajax更新被限制在活动区
25、域的元素中. 决定改变什么在大部分情况下都可以使用 “reRender”中的 ids来定义需要更新的 “AJAX zones”. 但是如果你的页面包含 tag(你希望在 ajax响应中更新它的内容)你不可以使用这种方式.我们在上面描述的 tag 的问题涉及到 JSF组件的transientFlag值. 如果该标记的值为 true,这个组件不能参与保存和恢复组件树(saving or restoring)的处理过程. 为了提供一种解决这个问题的方法, Ajax4jsf 利用 tag 定义了一个 output panel . 如果你把 tag 放在 output panel中, 那么在 AJAX
26、响应中 tag 和其他 panel中的 child tags中的内容可以被更新 .有两种方法来控制它: 设置“ajaxRendered” 属性值为 true. 设置动作组件的“reRender” 属性值为 output panel的 ID. Chapter 4. Ajax4JSF 组件库Table of Contentsa4j:ajaxListener a4j:region a4j:page a4j:support a4j:commandLink a4j:commandButton a4j:outputPanel a4j:actionparam a4j:status a4j:loadBundl
27、e a4j:mediaOutputa4j:ajaxListener和 ActionListener 或者 ValueChangeListener的工作方式一样, 只是仅用于AJAX容器. 添加一个指定的类作为 AjaxEvent的监听器. (sent in case of an AJAX request for this container). Table 4.1. a4j:ajaxListener attributestype 注册到 AjaxListener 中类的完全限定的 Java类名当来自于 Region的 AJAX request触发时,将调用 bean的processAjax方法
28、. a4j:region该标签定义在 AJax请求处理过程中被发送到服务器端解码的部分 JSF组件树. Table 4.2. a4j:region 的属性selfRendered 如果为 true,在调用应用程序(InvokeApplication )阶段自渲染子树(如果 immediate 属性设置为 true则是 Decode)renderRegionOnly标记,用来决定活动区域外的内容在 Ajax响应中是否渲染.如果为“true“ , 在 AJAX response过程中活动区域外的组件都不渲染. 如果为“false“, 将渲染包含在响应中的所有组件树.默认值为“true“render
29、ed 如果为 false, 该组件将不被重新渲染.id 每个组件都应该有个唯一的 id. 如果没有指定的话,将会自动产生.immediate如果该组件被 Ajax请求激活的话,标记该组件应该立即(在应用请求值阶段)被感兴趣的监听器和动作处理,而不是等到调用应用程序阶段.(译者注:该标记和 JSF中的 immediate标记所代表的意思差不多,跳过验证阶段到呈现响应阶段)binding 组件绑定ajaxListener方法绑定,当该组件被 ajax请求激活时,将调用该监听器方法处理该事件.该方法必须为 public的并且接受一个 AjaxEvent 参数,返回 void.如果在该组件的区域中有一
30、个 Ajax请求调用了 该区域将根据 Ajax的设置被框架处理. a4j:page该组件呈现一个完全的 HTML页面结构.它必须是 view root (JSP tag)的第一个(并且是仅有的一个)子组件. 没有 Html代码可以在该组件的外面. 它也支持在 Ajax请求中处理子组件,就和一样.对于一个普通的请求,它将把结果呈现为在客户端页面元素中的元素.如果该组件包含一个“head“ facet, 该 facet的内容也呈现在中.对于一个 Ajax请求,在整个结构中仅仅涉及到的组件被呈现.下面是个在 JSP (jspx version)中使用它的例子: . Table 4.3. a4j:pa
31、ge attributesselfRendered 如果为 true,在调用应用程序(InvokeApplication )阶段自渲染子树(如果 immediate 属性设置为 true则是 Decode)lang 用来描述在产生该组件的 markup时用到的语言(产生该组件标记所使用的语言)title 该组件产生的 Markup的 title属性值renderRegionOnly renderRegionOnlyonunload 在页面 unload时执行的 JS代码rendered 如果是 false, 该组件不会被呈现.contentType 设置响应的自定义的 mime内容类型dir
32、文本方向id 每个组件都应该有个唯一的 id. 如果没有指定的话,将会自动产生.styleClass 和 HTML class 属性对应.immediate如果该组件被 Ajax请求激活的话,标记该组件应该立即(在应用请求值阶段)被感兴趣的监听器和动作处理,而不是等到调用应用程序阶段.(译者注:该标记和 JSF中的 immediate标记所代表的意思差不多,跳过验证阶段到呈现响应阶段)onload 在页面 load时执行的 JS代码style 在该组件被呈现时应用的 CSS style(s) pageTitle 作为页面 title 的字符串binding 组件绑定.ajaxListener方
33、法绑定,当该组件被 ajax请求激活时,将调用该监听器方法处理该事件.该方法必须为 public的并且接受一个 AjaxEvent 参数,返回 void.上面的示例结构将被呈现为:a4j:support在 UIComponent-based 组件上添加 ajax功能,使他们有 JavaScript事件属性. 在解码期间:如果一个请求为 Ajax-performed, 从 ExternalContext 中的requestParameterMap属性中得到 Map,如果该 Map中“clientId“ key 对应的值非空,在组件上创建一个 javax.faces.event.ActionEve
34、nt, 并且传递该事件到该组件的 queueEvent()中,然后把他的 reReander区域中的组件 id添加到reReander属性中.在编码过程中.不编码一个组件. 相反的,在父组件上添加一个与事件属性的值相同的值绑定(Instead, it adds ValueBinding for a property of the parent component with the name as a value of its “event“ property).结果,当呈现时,父组件创建一个在提交一个 ajax请求时用到的 JS代码.如果该组件有子 UIParameter组件,添加他的 nam
35、e/value作为附加的请求参数.如果父组件是一个 UIInput的实例,并且 ajaxType属性是 input, 则也提交 input 域中的值. 在这种情况下,你可以在 UIForm外面提交一个单一的 input域. (As a result, when rendered, the parent component builds JavaScript code for submitting an AJAX request on this event. If the component has child UIParameter components, appends its name/v
36、alue as additional request parameters. If a parent component is an instance of UIInput and the ajaxType property is “input“, submits the value of the input field, also. In this case, you can submit a single input field outside of UIForm.)Table 4.4. a4j:support 属性actionListener方法绑定,当该组件被 ajax请求激活时,将调
37、用该监听器方法处理该事件.该方法必须为 public的并且接受一个 AjaxEvent 参数,返回 void.parentProperties parentPropertiesaction方法绑定到要被激活的程序动作方法, 如果该 UIComponent 被用户激活, 根据 immediate属性的值,方法在 请求处理生命周期中的 Apply Request Values 或者 Invoke Application 阶段 被调用.oncomplete 在客户端请求完成时调用的 js代码rendered 如果为 false,该组件将不会被显示.status Request status 组件的
38、id(在 UIComopnent.findComponent()中使用)reRender该组件调用 Ajax请求后重新渲染的组件的 ID(在 UIComopnent.findComponent()中使用),可以使一个 id,也可以使逗号分开的很多 id,或者是数据 or集合的 EL表达式 targetIdreRender的别名 : 该组件调用 Ajax请求后重新渲染的组件的 ID(在 UIComopnent.findComponent()中使用),可以使一个 id,也可以使逗号分开的很多 id,或者是数据 or集合的 EL表达式id 每个组件都应该有个唯一的 id. 如果没有指定的话,将会自动
39、产生.disableDefault 使目标事件的动作不可用 ( 在 javascript代码中添加 “return false;“ )requestDelay 在 JS事件上延迟 ( 单位 ms. )发送 Ajax请求.与事件队列公共工作可以减少键盘或者鼠标移动触发请求的次数eventsQueue 用来避免在同一个事件上的重复请求的队列的名字.可以用来减少周期事件(如:按键,鼠标移动)请求的次数.bypassUpdates 如果使 true,在处理验证阶段后跳过更新模型值阶段到呈现阶段.可以用来验证组件的输入值.immediate如果该组件被 Ajax请求激活的话,标记该组件应该立即(在应用请
40、求值阶段)被感兴趣的监听器和动作处理,而不是等到调用应用程序阶段.(译者注:该标记和 JSF中的 immediate标记所代表的意思差不多,跳过验证阶段到呈现响应阶段)limitToList 如果为 true,仅仅更新reRender属性中指定的组件,否则(默认值)更新所有 Ajax Region中的组件ajaxSingle 如果为 true , 仅仅提交一个 field/link,而不是整个 form中的内容.event 父组件的 JS事件属性的名称 ( onclick , onchange, etc. ) , for which we will build AJAX submission
41、code.binding 组件绑定.所有你需要指定的东西 - 父组件用来触发 ajax请求的事件和被 reRender的区域, 和处理事件的 Java bean方法.因此,在上面的例子中,checkbox 状态的改变将提交当前的区域. show_hide动作将被调用,并且 list中的 id所指定的组件将被更新. a4j:commandLink呈现一个 Html 元素,当点击时的动作就象一个 form提交一样.在解码的过程中:从 ExternalContext的属性 requestParameterMap中得到一个 Map,如果该 Map中包含“clientId“ key 的非空值, 在组件上
42、创建一个 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中的
43、 class属性的值. 呈现任何 non-UIParameter子组件为的相应的子组件. 这些看起来就像一个 Link文本.Table 4.5. a4j:commandLink attributesactionListener方法绑定,当该组件被 ajax请求激活时,将调用该监听器方法处理该事件.该方法必须为 public的并且接受一个 AjaxEvent 参数,返回 void.title 该组件产生的标记元素的提示文字(当鼠标移动到该组件上面出现的提示文字)oncomplete 在客户端请求完成时调用的 js代码shapedefault|rect|circle|poly CI 该属性指定一个
44、区域的形状.可能的取值: * default: 指定整个区域. * rect:指定一个矩形区域. * circle: 定义一个圆形区域. * poly: 定义一个多边形区域.target rendered 如果为 false,该组件将不会被显示.charset 该属性指定了通过链接指派的资源的字符编码.reRender该组件调用 Ajax请求后重新渲染的组件的 ID(在 UIComopnent.findComponent()中使用),可以使一个 id,也可以使逗号分开的很多 id,或者是数据 or集合的 EL表达式targetIdAlias for reRender : 该组件调用 Ajax请
45、求后重新渲染的组件的 ID(在 UIComopnent.findComponent()中使用),可以使一个 id,也可以使逗号分开的很多 id,或者是数据 or集合的 EL表达式id 每个组件都应该有个唯一的 id. 如果没有指定的话,将会自动产生.dir 文本方向.rev该属性用来描述从通过 href 属性指定的锚点到当前文档的反向链接。该属性值是通过空格分隔的 link 类型(值)的列表。bypassUpdates 如果使 true,在处理验证阶段后跳过更新模型值阶段到呈现阶段.可以用来验证组件的输入值.styleClass 和 HTML的 class属性一样.accesskey 触发该组
46、件的快捷键limitToList 如果为 true,仅仅更新reRender属性中指定的组件,否则(默认值)更新所有 Ajax Region中的组件onkeypress 键盘事件,键被按下和松开ajaxSingle 如果使 true,仅仅提交一个 field/link,而不是所有被控制的ondblclick HTML: 双击事件style HTML: 应用在该组件上的 CSS.onblur 当元素失去焦点时发生的事件onmouseover 当滑鼠移动到组件上方时 onkeyup 当使用者按下并放开按键value 该组件的当前值action方法绑定到要被激活的程序动作方法, 如果该 UIComp
47、onent 被用户激活, 根据 immediate属性的值,方法在 请求处理生命周期中的 Apply Request Values 或者 Invoke Application 阶段 被调用.tabindex 设置不同元素之间获得焦点的顺序hreflang该属性指定了通过 href 指派的资源的基本语言，并且仅在 href 被指定的情况下使用(也就是说如果 A 中没有指定 href 属性，就不应该出现 hreflang 属性)。type 该属性指定链接资源所采用的内容类型。(译者注:例如网页通常为 text/html)lang 产生该组件标记所使用的语言onclick 当鼠标点击时发生的事件 s
48、tatus 请求状态组件的 ID(在 UIComopnent.findComponent()中使用)onmouseout 鼠标光标移开元素时发生的事件onkeydown 键按下时发生的事件onmousedown 按下鼠标按键时发生的事件requestDelay 在 JS事件上延迟 ( 单位 ms. )发送 Ajax请求.与事件队列公共工作可以减少键盘或者鼠标移动触发请求的次数eventsQueue 用来避免在同一个事件上的重复请求的队列的名字.可以用来减少周期事件(如:按键,鼠标移动)请求的次数.rel该属性描述了从当前文档到通过 href 属性定义的锚点之间的关系。该属性值是通过空格分隔的
49、link 类型(值)的列表(译者注:在 Web 标准开发中，这个通常用来代替 target 属性，配合脚本，用来表示目的窗口)。immediate如果该组件被 Ajax请求激活的话,标记该组件应该立即(在应用请求值阶段)被感兴趣的监听器和动作处理,而不是等到调用应用程序阶段.(译者注:该标记和 JSF中的 immediate标记所代表的意思差不多,跳过验证阶段到呈现响应阶段)onfocus 使用在表单元素中，当元素获得焦点时发生的事件onmouseup 当释放鼠标按键时发生的事件binding 组件绑定.onmousemove 鼠标光标在元素上移动时发生的事件coords 定义区域 - coords a.矩形：必须使用四个数字，前两个数字为左上角座标，后两个数字为右下角座标 例：area s
