Faces 元件參照

開啟選用區中的 Faces 元件抽屜之後,您可以在 Faces JSP 頁面中新增任何下列元件。

在選用區中,某些元件可能會隱藏起來。如果要在選用區中顯示隱藏的元件,請用滑鼠右鍵按一下「選用區」視圖來選取自訂。 請移除要在選用區上顯示的每個元件之隱藏旁的勾號。

每個元件都有一些可在該元件的「內容」視圖中設定的屬性。如果您選取 Faces 元件時,該元件的「內容」視圖並未開啟,請選取視窗 > 顯示視圖 > 內容。 如果需要「內容」視圖中所顯示的所有屬性的字母順序清單及其說明,請參閱 Faces 元件的屬性Faces 媒體元件的屬性

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

下表依照英文字母順序列出可從選用區中新增的 Faces 元件。

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

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

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