輸入 - 隱藏

在頁面上建立一個隱藏欄位。隱藏欄位可以包含資料,但是使用者看不見這個欄位。這個欄位通常是用於在頁面之間傳送資訊, 以及用來保留系統資訊。

設計時的元件

輸入 - 隱藏元件拖放到頁面上:
「輸入 - 隱藏」元件按鈕

頁面中的輸入 - 隱藏元件看起來與下面類似:
設計時的「輸入 - 隱藏」

執行時期的元件

輸入 - 隱藏元件在執行時期沒有視覺化的呈現方式。

「內容及所有屬性」視圖

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

「輸入 - 隱藏」元件的這些共同屬性顯示在「內容」視圖的 h:inputHidden驗證標籤中。 如需完整的屬性清單,請參閱所有輸入 - 隱藏屬性表格。用以驗證輸入的其他配置選項則在 h:inputHidden>驗證標籤:

表 1. 輸入 - 隱藏配置選項

配置選項

說明

按一下來建立/編輯自訂驗證程式碼

切換至「快速編輯」視圖,以便為各種使用者起始的事件輸入 Script 或程式碼片段。

限制

限制可輸入到元件中的字元類型(例如,只有數字、只有 ASCII 英文字母等等)將含有 regex 屬性的 hx:validateConstraint 新增至「所有屬性」視圖。

在錯誤訊息控制中顯示驗證錯誤訊息

插入與選取的元件相關聯的錯誤訊息控制元件。這樣就會在驗證失敗時顯示錯誤訊息。

長度上限

在伺服器上送出這個元件時,元件可包含的字元數目上限。它會將含有 maximum 屬性的 f:validateLength函數新增至「所有屬性」視圖。

長度下限

在伺服器上送出這個元件時,元件可包含的字元數目下限。它會將含有 minimum 屬性的 f:validateLength函數新增至「所有屬性」視圖。

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

表 2. 所有輸入 - 隱藏屬性

屬性名稱

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

說明

binding

沒有顯示

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

converter

沒有顯示

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

id

ID

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

immediate

沒有顯示

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

rendered

沒有顯示

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

required

驗證>必須輸入值

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

validator

沒有顯示

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

value

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

valueChangeListener

沒有顯示

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

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