勾選框群組

一組勾選框。這個元件通常是用來從許多選項中選取一或多個項目。您可以靜態地定義選項清單, 或者將它連結到資料儲存體,例如資料庫、Bean,或兩者。整個群組通常是連結到一個資料儲存體。 在送出含有勾選框群組元件的頁面時,所選取之勾選框的值會儲存在指定的位置(例如,資料庫的直欄或 Bean 的內容)。

設計時的元件

勾選框群組元件拖放到頁面上:
「勾選框群組」元件按鈕

頁面中的勾選框群組元件看起來與下面類似:
設計時的「勾選框群組」

執行時期的元件

在執行時期,頁面中的勾選框群組元件看起來與下面類似:
執行時期的「勾選框群組」

「內容及所有屬性」視圖

元件的「內容」視圖會顯示您可以用來設定元件的最常用屬性集,而且針對不同的元件,您也會看到新增控制項、動作或其他元件的選項。若要開啟「內容」視圖,請按一下「視窗 > 顯示視圖 > 內容」;然而依預設會開啟該視圖。

「勾選框群組」元件的這些共同屬性會顯示在「內容」視圖中的 h:selectManyCheckbox協助工具標籤上。請參閱所有勾選框群組屬性 表格,以取得完整的屬性清單。勾選框群組選項的其他配置選項位於 h:selectManyCheckbox 標籤上:

配置選項

說明

為群組中的每一個勾選框新增一個選項

可讓您指定勾選框群組元件中的方框的名稱、值和次序。您可以新增單一選項或一組選項。

「所有屬性」視圖會顯示您可以在元件上設定之所有屬性的表格,包括您可以從「內容」視圖來存取的那些屬性。若要切換至「所有屬性」視圖,請按一下「內容」視圖右上角的「所有屬性」圖示 「所有屬性」圖示

表 1. 所有勾選框群組屬性

屬性名稱

顯示在「內容」視圖中的排列依據

說明

accesskey

協助工具>存取鍵

指定單一鍵盤按鍵作為存取鍵。在執行時期按下指定的存取鍵時, 就會將焦點移至這個元件。

binding

沒有顯示

代表這個元件的 UIComponent,通常是在支持的檔案中。

border

沒有顯示

指定表格的邊框大小(像素)。

converter

沒有顯示

指定值要轉換的資料類型。JavaServer Faces 實作提供一組轉換器實作,供您將元件資料轉換成它的呈現器所不支援的類型。

dir

沒有顯示

指定執行時期的元件呈現方向。值可以是:
  • ltr - 由左至右
  • rtl - 由右至左

disabled

沒有顯示

如果 disabled 設為 true,在執行時期會顯示該元件,但無法使用。如果保留空白,預設值是 false。

disabledClass

沒有顯示

元件相關聯的替代 CSS 類別名稱。從名稱可以判斷它們的使用情況。

enabledClass

沒有顯示

元件相關聯的替代 CSS 類別名稱。從名稱可以判斷它們的使用情況。

id

ID

指派元件的名稱。應該是 JSP 內的唯一名稱。

immediate

沒有顯示

如果是 true,會直接跳到生命週期的呈現階段。

lang

沒有顯示

指定元件屬性值和文字內容的基本語言。採用 ISO 標準語言縮寫碼(如 "en" 代表英文、"en-US" 代表美國英文、"fr" 代表法文、"de" 代表德文)。

layout

方向

指定採用水平或垂直佈置:
  • line_direction = 水平
  • page_direction = 垂直

readonly

沒有顯示

指定元件值不能從其起始值進行變更。

rendered

沒有顯示

可以設成 true 或 false:
  • false - 執行時期不會將元件呈現在瀏覽器中。
  • true - 將會呈現元件。

required

沒有顯示

必須指定元件。勾選這個方框時,使用者必須輸入一個值。

style

樣式:內容

指定元件的 CSS 樣式資訊(如 style="font-size : 8pt ; color : red")。定義已選取的元件的內容(例如字型和顏色)。 這可以用手動方式來完成,或者按一下按鈕,然後從視窗內選取想要的內容。

styleClass

樣式:類別

當呈現這個元素時,所要套用的 CSS 樣式類別清單,各個類別之間是用空格加以區隔。 這個值必須作為產生的標記之 "class" 屬性來傳遞。定義已選取的元件的類別(例如樣式表)。 這可以用手動方式來完成,或者按一下按鈕,然後從視窗內選取想要的「類別」。

tabindex

協助工具>欄標次序索引

指定元件在 JSP 內的定位次序位置。這個值必須是 0 和 32767 之間的數字。

title

協助工具>標題

指定執行時期在瀏覽器中顯示成工具要訣的標題文字。

validator

沒有顯示

要建立實例之驗證器的類別名稱。

value

指定執行時期所顯示的元件起始文字值。 包含要顯示的資訊,其格式為指定值或動態值的指標。

valueChangeListener

沒有顯示

元件值有了改變時所要通知的方法。

相關概念
利用 JavaServer Faces 來建立資料存取 Web 應用程式
相關工作
建立 Faces 應用程式 - 概觀
相關參考
Faces 元件參照
Faces 元件的屬性
勾選框
讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.