JSF - h:selectManyCheckbox

h:selectManyCheckbox 标签渲染一组类型为“checkbox”的 HTML 输入元素，并使用 HTML 表格和标签对其进行格式化。

JSF 标签

<h:selectManyCheckbox value = "#{userData.data}"> 
   <f:selectItem itemValue = "1" itemLabel = "Item 1" /> 
   <f:selectItem itemValue = "2" itemLabel = "Item 2" /> 
</h:selectManyCheckbox>

渲染输出

<table>
   <tr>
      <td>
         <input name = "j_idt6:j_idt8" id = "j_idt6:j_idt8:0" value = "1" 
            type = "checkbox" checked = "checked" />
         <label for = "j_idt6:j_idt8:0" class = ""> Item 1</label>
      </td>
      
      <td>
         <input name = "j_idt6:j_idt8" id = "j_idt6:j_idt8:1" value = "2" 
            type = "checkbox" checked = "checked" />
         <label for = "j_idt6:j_idt8:1" class = ""> Item 2</label>
      </td>     
   </tr>
</table>

标签属性

序号	属性及描述
1	id 组件标识符
2	binding 对可在支持Bean中使用的组件的引用
3	rendered 布尔值；false 抑制渲染
4	styleClass 层叠样式表 (CSS) 类名
5	value 组件的值，通常是值绑定
6	valueChangeListener 对响应值更改的方法的绑定
7	converter 转换器类名
8	validator 创建并附加到组件的验证器的类名
9	required 布尔值；如果为 true，则需要在关联字段中输入值
10	accesskey 一个键，通常与系统定义的元键组合使用，用于将焦点赋予元素
11	accept 表单的内容类型的逗号分隔列表
12	accept-charset 表单的字符编码的逗号或空格分隔列表。accept-charset 属性使用名为 acceptcharset 的 JSF HTML 属性指定。
13	alt 非文本元素（如图像或小程序）的替代文本
14	charset 链接资源的字符编码
15	coords 形状为矩形、圆形或多边形的元素的坐标
16	dir 文本方向。有效值为 ltr（从左到右）和 rtl（从右到左）
17	disabled 输入元素或按钮的禁用状态
18	hreflang 使用 href 属性指定的资源的基语言；hreflang 只能与 href 一起使用。
19	lang 元素的属性和文本的基语言
20	maxlength 文本字段的最大字符数
21	readonly 输入字段的只读状态；在只读字段中可以选择文本，但不能编辑
22	rel 当前文档和使用 href 属性指定的链接之间的关系
23	rev 从使用 href 指定的锚点到当前文档的反向链接。属性的值是链接类型的空格分隔列表
24	rows 文本区域中可见行的数量。h:dataTable 有一个 rows 属性，但它不是 HTML 直通属性。
25	shape 区域的形状。有效值：default、rect、circle、poly。（default 表示整个区域）
26	style 内联样式信息
27	tabindex 指定选项卡索引的数值
28	target 打开文档的框架的名称
29	title 用于辅助功能的标题，描述元素。可视浏览器通常为标题的值创建工具提示
30	type 链接的类型；例如，stylesheet
31	width 元素的宽度
32	onblur 元素失去焦点
33	onchange 元素的值更改
34	onclick 鼠标按钮在元素上单击
35	ondblclick 鼠标按钮在元素上双击
36	onfocus 元素获得焦点
37	onkeydown 按下键
38	onkeypress 按下键并随后释放
39	onkeyup 释放键
40	onmousedown 鼠标按钮在元素上按下
41	onmousemove 鼠标在元素上移动
42	onmouseout 鼠标离开元素区域
43	onmouseover 鼠标移动到元素上
44	onmouseup 释放鼠标按钮
45	onreset 表单重置
46	onselect 在输入字段中选择文本
47	disabledClass 禁用元素的 CSS 类
48	enabledClass 启用元素的 CSS 类
49	layout 元素布局规范：lineDirection（水平）或 pageDirection（垂直）
50	border 元素的边框

示例应用程序

让我们创建一个测试 JSF 应用程序来测试上述标签。

步骤	描述
1	按照JSF - 第一个应用程序章节中的说明，在com.tutorialspoint.test包下创建一个名为helloworld的项目。
2	如下所述修改home.xhtml。保持其余文件不变。
3	如下所述在 webapps 目录中创建result.xhtml。
4	如下所述在com.tutorialspoint.test包下创建一个名为UserData.java的托管Bean。
5	编译并运行应用程序，以确保业务逻辑按要求工作。
6	最后，将应用程序构建为 war 文件，并将其部署到 Apache Tomcat Web 服务器。
7	使用如下最后一步中说明的适当 URL 启动您的 Web 应用程序。

UserData.java

package com.tutorialspoint.test;

import java.io.Serializable;

import javax.faces.bean.ManagedBean;
import javax.faces.bean.SessionScoped;

@ManagedBean(name = "userData", eager = true)
@SessionScoped
public class UserData implements Serializable {
   private static final long serialVersionUID = 1L;
   public String[] data = {"1","2","3"};
   
   public String[] getData() {
      return data;
   }

   public void setData(String[] data) {
      this.data = data;
   }
}

home.xhtml

<?xml version = "1.0" encoding = "UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns = "http://www.w3.org/1999/xhtml"
   xmlns:f = "http://java.sun.com/jsf/core"    
   xmlns:h = "http://java.sun.com/jsf/html">
   
   <head>
      <title>JSF Tutorial!</title>
   </head>
   
   <h:body>
      <h2>h:selectManyCheckbox example</h2>
      <hr />
      
      <h:form>
         <h3>Mutiple checkboxes</h3> 
         <h:selectManyCheckbox value = "#{userData.data}">
            <f:selectItem itemValue = "1" itemLabel = "Item 1" />
            <f:selectItem itemValue = "2" itemLabel = "Item 2" />
            <f:selectItem itemValue = "3" itemLabel = "Item 3" />
            <f:selectItem itemValue = "4" itemLabel = "Item 4" />
            <f:selectItem itemValue = "5" itemLabel = "Item 5" />
         </h:selectManyCheckbox>
         <h:commandButton value = "Submit" action = "result" />
      </h:form> 		
   
   </h:body>
</html>

result.xhtml

<?xml version = "1.0" encoding = "UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns = "http://www.w3.org/1999/xhtml"
   xmlns:f = "http://java.sun.com/jsf/core"    
   xmlns:h = "http://java.sun.com/jsf/html"
   xmlns:ui = "http://java.sun.com/jsf/facelets">
   
   <h:body>
      <h2>Result</h2>
      <hr />
      
      <ui:repeat value = "#{userData.data}" var = "s">		
         #{s}
      </ui:repeat>   	
   </h:body>
</html>

完成所有更改后，让我们像在 JSF - 创建应用程序章节中一样编译和运行应用程序。如果您的应用程序一切正常，这将产生以下结果。

选择多个复选框并按下提交按钮。我们选择了四项。您将看到选择的结果。

jsf_basic_tags.htm

打印页面