Seam的JSF控件（一）

为了使用这些tagsd，要在你的页面中定义“s”命名空间如下（只用于Facelets）：

      xmlns:s="http://jboss.com/products/seam/taglib">

ui的例子，示范了这其中许多标签的用法。

Table 29.1. Seam的JSF控件参考

	描述 通过控制对话传播支持动作调用的按钮。不提交表单。 属性 value — 标签 action — 指定动作监听者的一种方法绑定。 view — 链接的JSF view id。 fragment — 链接的fragment标识符。 disabled — 该链接处于取消状态吗？ propagation — 确定对话传播风格：begin、join、nest、none 或者 end。 pageflow — 起始的页面流定义。 （这只在 propagation="begin" 或者 propagation="join" 的时候才有用。） 用法 action="#{hotelBooking.cancel}"/>
	描述 利用JBoss的Cache缓存渲染过的页面片断。 注意 实际上使用由内建的 pojoCache 组件管理的JBoss Cache的实例。 属性 key — 是缓存渲染过的内容的键，经常是一个值表达式。 例如，如果我们在缓存一个显示文档的页面片断，我们可以使用 key="Document-#{document.id}"。 enabled — 是一个值表达式，决定是否应该使用缓存。 region — 是一个要使用的JBoss Cache节点（不同的节点可以有不同的过期策略）。 Usage 用法 #{blogEntry.title} [Posted on  type="both"/> ]
	描述 将对话id添加到一个输出链接（或者类似的JSF控件）。只用于Facelets。 属性 无。
	描述 给一个命令链接或者按钮定制对话传播（或者类似的JSF控件）。只用于Facelets。 属性 propagation — 确定对话传播风格；begin、join、nest、none 或者 end。 pageflow — 是一个起始页面流定义。 （这只在 propagation="begin" 或者 propagation="join" 的时候才有用。） 用法
	描述 在Seam的timezone中执行日期或者时间对话。 属性 无。 用法
	描述 给当前的组件分配一个实体转换器。这主要对单选按钮和下拉控件有用。 转换器使用任何具有 @Id 注解（简单的或者复合的）的受控实体。 属性 无。 配置 你必须通过 使用 Seam管理的事务 （请见Section 8.2, “Seam管理的事务”） 如果你的 受控持久化上下文 不是称作 entityManager，那你就需要在 components.xml 中设置它： #{em} 如果你想在实体转换器上使用不止一个实体管理器，你可以在componets.xml中为每一个实体管理器创建一份实体转换器。 #{em} label="#{continent.name}" /> 用法 label="#{continent.name}" noSelectionLabel="Please Select..."/>
	描述 给当前的组件分配一个enum转换器。这主要对单选按钮和下拉控件有用。 属性 无。 用法 label="#{honorific.label}" noSelectionLabel="Please select" />
	描述 在验证失败或者设置了 required="true" 时，“装饰”一个JSF输入域。 属性 template — 用来装饰组件的Facelets模板。 #{invalid} 和 #{required} 可以在 s:decorate 内使用； 如果你按要求设置了正被装饰的输入组件，#{required} 就取值为 true， 并且如果发生校验错误, #{invalid} 取值为 true。 用法 Country: xmlns:ui="http://java.sun.com/jsf/facelets" xmlns:h="http://java.sun.com/jsf/html" xmlns:f="http://java.sun.com/jsf/core" xmlns:s="http://jboss.com/products/seam/taglib"> *
	描述 渲染一个HTML 。 属性 无。 用法 Sorry, but this member does not exist.
	描述 从一个enum值中创建一个 SelectItem。 属性 enumValue — 是enum值的字符串表示法。 label — 在渲染 SelectItem 时要使用的标签。 用法 layout="lineDirection" value="#{newPayment.paymentFrequency}">
	描述 渲染一个文件上载控件。这个控件必须通过在form中使用 multipart/form-data 的编码类型，例如： 对于多部分请求，也必须在 web.xml 中配置Seam Multipart Servlet过滤器： Seam Filter org.jboss.seam.servlet.SeamFilter Seam Filter /* 配置 下列多部分请求的配置选项可以在 components.xml 中进行配置： createTempFiles — 如果这个选择设置为true，上载好的文件就流向一个临时文件，而不是流向内存。 maxRequestSize — 允许上载文件的最大字节数。 下面是一个例子： true 1000000 属性 data — 这个值绑定接收二进制文件数据。 接收域应该声明为一个 byte[] 或者 InputStream （必要）。 contentType — 这个值绑定接收文件的内容类型（可选）。 fileName — 这个值绑定接收的文件名（可选）。 fileSize — 这个值绑定接收的文件大小（可选）。 accept — 可以接受的一个以逗号分隔的内容类型列表，可能浏览器不支持。 例如 "images/png,images/jpg"、"images/"。 style — 控件的样式，即CSS之类的 styleClass — 控件的样式类 用法 accept="image/png" contentType="#{register.pictureContentType}" />