Faces 元件參照

開啟選用區中的「Faces 元件」抽屜之後,您可以將任何元件新增至 Faces JSP。依預設,選用區上的部分元件會隱藏起來。如果要在選用區中顯示隱藏的元件,請在選用區視圖中按一下滑鼠右鍵來選取自訂。 請移除要在選用區上顯示的每個元件之隱藏旁的勾號。

註: 部分子元件不是從選用區來新增的。相反地,它們是從母項元件的「內容」視圖中新增的。 比方說,您將資料表元件新增到頁面之後,您就可以從資料表的「內容」視圖中新增列編輯元件。

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


「內容」視圖

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


「所有屬性」視圖

如果需要「內容」及「所有屬性」視圖中所顯示之所有屬性的按字母順序排列清單及說明,請參閱 Faces 元件的屬性。 如需個別元件的詳細資料,請在 Faces 元件及其說明表格中按一下元件名稱(該表格會列示您可以從選用區新增的所有 Faces 元件)。一開始隱藏起來的元件會在表格中其名稱的旁邊以一個星號 (*) 表示。

表 1. Faces 元件及其說明
Faces 元件名稱 Faces 標示名稱 說明
勾選框 selectBooleanCheckbox 顯示單一勾選框。請參閱新增選項清單至 Faces JSP 檔,以取得這個元件的詳細資訊。
勾選框群組 selectManyCheckbox 顯示多個勾選框。使用者可以勾選多個勾選框。請參閱新增選項清單至 Faces JSP 檔,以取得這個元件的詳細資訊。
組合框 selectOneMenu 顯示使用者從中選取單一項目的下拉組合框。請參閱新增選項清單至 Faces JSP 檔,以取得這個元件的詳細資訊。
指令 - 按鈕 commandExButton 建立可以有文字或影像的按鈕。 按鈕可以執行一個動作。請參閱搭配 Faces JSP 頁面使用導覽規則,以取得動作和導覽規則的相關資訊。
指令 - 超鏈結 commandLink 建立超鏈結,但也能夠執行更新記錄之類的動作。 請參閱新增超鏈結至 Faces JSP 檔中搭配 Faces JSP 頁面使用導覽規則,以取得超鏈結、動作和導覽規則的相關資訊。
資料表 dataTable 建立一份資料表格,其中的列對應於資料記錄,直欄對應於欄位或種類。 特性包括分頁控制、標頭和標底,以及列選項和動作的支援。請參閱新增和配置資料表,以取得這個資料表的詳細資訊。
顯示錯誤 message 插入有條件地顯示的錯誤文字。錯誤與特定元件相關。請參閱管理 JavaServer Faces 應用程式中的錯誤,以取得這個元件的詳細資訊。
顯示錯誤 messages 當頁面中出現錯誤時,插入有條件地顯示的錯誤訊息。 顯示整個頁面的錯誤。 請參閱管理 JavaServer Faces 應用程式中的錯誤,以取得錯誤元件的詳細資訊。
檔案上載 fileupload 顯示用來上載檔案的輸入欄位和相關「瀏覽」按鈕。 請參閱使用檔案上載元件,以取得檔案上載元件的詳細資訊。
表單 form 建立其他元件的主儲存器。必要時會自動新增。
*水平尺規 outputSeparator 建立一條水平線,讓您以視覺化方式,分隔頁面上的資訊。
影像 graphicImageEx 在頁面中顯示影像。也可以顯示取自資料來源的影像。請參閱顯示影像,以取得影像的詳細資訊。
輸入 inputText 可讓您建立下列資料類型的輸入欄位。 當您新增輸入元件至頁面中時,請在輸入元件的「內容」視圖中,選取下列其中一種格式。請參閱新增輸入元件至 Faces JSP 檔,以取得輸入元件的詳細資訊。
inputText
  • 字串 - 單行的簡式文字欄位。這是預設值。
convertNumber
  • 數字 - 可以設定樣式和格式的數字欄位
convertDateTime
  • 日期/時間 - 您可以設定其格式的日期和時間欄位。
convertMask
  • 遮罩 - 選擇性地併入或排除特定值的過濾器。
*輸入 - 隱藏 inputHidden 插入隱藏的輸入元件。開發人員通常利用這個元件,在頁面或頁面控制項之間傳遞資料。
輸入 - 密碼 inputSecret 插入使用者輸入密碼的輸入欄位。
輸入文字區 inputTextarea 插入顯示多行文字的輸入元件。
標籤 outputLabel 插入協助工具輸出標籤。請參閱新增協助工具的標籤元件,以取得標籤元件的詳細資訊。
鏈結 outputLinkEx 建立超鏈結來指向您指定的 URL。
清單框 - 多選 selectManyListbox 插入使用者可在其中選取多個項目的清單框。請參閱新增選項清單至 Faces JSP 檔,以取得這個元件的詳細資訊。
清單框 - 單選 selectOneListbox 插入使用者可在其中選取單一項目的清單框。請參閱新增選項清單至 Faces JSP 檔,以取得這個元件的詳細資訊。
媒體播放器   在頁面中建立一個媒體元件,使各種媒體檔都能夠在網頁中播放。 請參閱新增媒體元件,以取得媒體元件的詳細資訊。您可以從下列媒體元件中選取:
playerGenericPlayer
playerFlash
playerMediaPlayer
playerShockwave
playerRealPlayer
輸出 outputText 建立使用者無法修改的輸出文字。 這個文字可以是靜態的,或連結於資料來源。輸出元件可以顯示資料來源的資料,並且可以顯示大部分其他 Faces 元件內的靜態文字(比方說,作為輸入欄位的標籤)。

當您新增輸出元件時,請在輸出元件的「內容」視圖中,選擇下列其中一種格式:

outputText
  • 字串 - 簡式文字欄位。這是預設格式。
convertNumber
  • 數字 - 可以設定樣式和格式的數字欄位
convertDateTime
  • 日期/時間 - 您可以設定其格式的日期和時間欄位。
convertMask
  • 遮罩 - 選擇性地併入或排除特定值的過濾器。
輸出 - 格式化文字 outputFormat 將格式化的訊息輸出至頁面中。訊息可以是靜態文字和資料儲存體所提供的動態資料的組合。
畫面 - 群組框   建立一個儲存器,供您將其他元件組合在其中。畫面的一個用法是放在資料表的直欄中。當您將畫面拖曳至直欄中,您可以控制多個元件在直欄中的組織方式。這個元件有下列選項:
panelBox
  • *清單 - 將元件組織成垂直的或水平清單。
panelGrid
  • *格線 - 將元件組織在格線中。 您可以指定格線中的直欄數。
panelLayout
jspPanel
  • *畫面 - JSP - 插入一個畫面,其中可包含任何其他 HTML、JSP 或 Faces 元件。 大部分 Faces 元件都可以包含其他 Faces 標示,但不能包含 HTML 標示。 不過,這個 jspPanel 元件可以包含 Faces 和 HTML 標示。 比方說,您通常不能在 Faces 資料表的直欄內建立 HTML 表格。 不過,如果您將這個元件拖曳至直欄中,您就可以在其中建立 HTML 表格。 另外,HTML 表格也可以包含 Faces 標示。
畫面 - 功能表列 panelActionbar 插入將指令放入功能表列的畫面。 您可以將按鈕、超鏈結和水平尺規拖放到畫面中,或從元件的「內容」視圖內新增它們。 您也可以在功能表列中新增子功能表列。
畫面 - 附加標籤 tabbedPanel 建立一組重疊的標籤頁。每個頁面都可以包含一組元件。 使用者可以按一下標籤來顯示這個頁面的內容。 請參閱標籤畫面的事件處理常式,以取得標籤畫面所能使用之事件的詳細資訊。
圓鈕群組 selectOneRadio 顯示一群圓鈕。使用者只能按一個圓鈕。 請參閱新增選項清單至 Faces JSP 檔,以取得這個元件的詳細資訊。
Rich Text Area inputRichText 插入 Rich Text Editor 元件。如同「輸入 - 文字區」元件,這個元件可以有多行文字。 這個元件和輸入文字區不同,它可以包含不同的字型和大小、表格、鏈結,以及編號清單和項目符號清單。
*逐項 verbatim 插入逐項標示,供您直接在 Faces JSP 頁面中新增 HTML。
相關概念
JavaServer Faces
Faces 元件
相關工作
使用 Faces 元件
相關參考
Faces 元件的屬性
讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.