表單

建立適用於其他元件的主儲存器,並於需要時自動新增。

設計時的元件

表單元件拖放到頁面上:
「表單」元件按鈕

頁面中的表單元件看起來與下面類似:
設計時的「表單」

執行時期的元件

表單元件沒有可見的執行時期呈現方式。

「內容及所有屬性」視圖

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

「表單」元件的這些共同屬性顯示在「內容」視圖的 h:form鍵盤輔助隱藏欄位標籤中。 如需完整的屬性清單,請參閱所有表單屬性表格。適用於顯示及協助工具的其他配置選項則在 h:form>鍵盤輔助h:form>隱藏欄位標籤:

表 1. 表單配置選項

配置選項

說明

指派動作給指定的按鍵。

指定表單元件內的動作的按鍵、動作和目標。按鍵和動作是從下拉清單來選擇。目標是從表單內的輸入欄位所含的下拉清單中選擇。在表單中按下按鍵時, 就會執行動作。

隱藏欄位

顯示表單中所有現行的「輸入 - 隱藏」元件, 並可讓您新增、移除和修改隱藏欄位。

選取這個欄位的內容

指定所選擇要取得焦點的欄位一開始也必須選取其內容。

頁面一開始顯示就設定焦點

指定在顯示頁面時,一開始就會取得焦點的欄位。可以指定頁面中的第一個欄位特定欄位(以欄位 ID 來識別)。

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

表 2. 所有表單屬性

屬性名稱

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

說明

accept

沒有顯示

指定元件將容許的檔案類型,並以逗點區隔。

acceptcharset

沒有顯示

回應用戶端的預期字集。標準的 HTML 屬性。請參閱 HTML 表單標示: 這個屬性指定處理這份表單的伺服器所接受的輸入資料的字元編碼清單。這個值是以空格及(或)逗點隔開的字集值的清單。用戶端必須將這份清單解譯成一份互斥或清單,也就是說,伺服器能夠接受每個實體收到的任何字元編碼。

binding

沒有顯示

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

dir

沒有顯示

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

enctype

沒有顯示

指定送出表單時所用的內容類型。

id

ID

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

lang

沒有顯示

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

rendered

沒有顯示

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

style

樣式:內容

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

styleClass

樣式:類別

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

target

沒有顯示

指派在按一下元件時,頁框組內應該載入頁面的目標頁框。

title

沒有顯示

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

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