開啟選用區中的「Faces 元件」抽屜之後,您可以將任何元件新增至 Faces JSP。依預設,選用區上的部分元件會隱藏起來。如果要在選用區中顯示隱藏的元件,請在選用區視圖中按一下滑鼠右鍵來選取自訂。 請移除要在選用區上顯示的每個元件之隱藏旁的勾號。
元件的「內容」視圖會顯示您可以用來設定元件的最常用屬性集,而且針對不同的元件,您也會看到新增控制項、動作或其他元件的選項。若要開啟「內容」視圖,請按一下「視窗 > 顯示視圖 > 內容」;然而依預設會開啟該視圖。
「所有屬性」視圖會顯示您可以在元件上設定的所有屬性的表格,包括您可以從「內容」視圖來存取的那些屬性。若要切換至「所有屬性」視圖,請按一下「內容」視圖右上角的「所有屬性」圖示 。
如果需要「內容」及「所有屬性」視圖中所顯示之所有屬性的按字母順序排列清單及說明,請參閱 Faces 元件的屬性。 如需個別元件的詳細資料,請在 Faces 元件及其說明表格中按一下元件名稱(該表格會列示您可以從選用區新增的所有 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 |
|
|
畫面 - 功能表列 | panelActionbar | 插入將指令放入功能表列的畫面。 您可以將按鈕、超鏈結和水平尺規拖放到畫面中,或從元件的「內容」視圖內新增它們。 您也可以在功能表列中新增子功能表列。 |
畫面 - 附加標籤 | tabbedPanel | 建立一組重疊的標籤頁。每個頁面都可以包含一組元件。 使用者可以按一下標籤來顯示這個頁面的內容。 請參閱標籤畫面的事件處理常式,以取得標籤畫面所能使用之事件的詳細資訊。 |
圓鈕群組 | selectOneRadio | 顯示一群圓鈕。使用者只能按一個圓鈕。 請參閱新增選項清單至 Faces JSP 檔,以取得這個元件的詳細資訊。 |
Rich Text Area | inputRichText | 插入 Rich Text Editor 元件。如同「輸入 - 文字區」元件,這個元件可以有多行文字。 這個元件和輸入文字區不同,它可以包含不同的字型和大小、表格、鏈結,以及編號清單和項目符號清單。 |
*逐項 | verbatim | 插入逐項標示,供您直接在 Faces JSP 頁面中新增 HTML。 |