輸入

可讓您建立下列資料類型的輸入欄位:「字串」、「數字」、「日期/時間」及「遮罩」。當您新增輸入元件至頁面中時,請在輸入元件的「內容」視圖中,選取其中一種格式。

設計時的元件

輸入元件拖放到頁面:
輸入元件按鈕

設計時期在頁面中的輸入元件:
設計時期的「輸入」

執行時期的元件

執行時期在頁面中的輸入元件:
在執行時期的「輸入」

「內容及所有屬性」視圖

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

「輸入」元件的這些共同屬性顯示在「內容」視圖的 h:inputText驗證行為協助工具標籤中。如需完整的屬性清單,請參閱所有輸入屬性表格。用以驗證輸入、修改行為和配置輸入格式類型的其他配置選項則在 h:inputText>驗證h:inputText>行為h:inputText 及標籤:

表 1. 輸入配置選項

配置選項

說明

自動前進至下一個欄位

指定是否要啟用自動定位。在輸入指定的字元數目後,自動前進至另一個輸入欄位。若加以勾選,則會將 hx:inputHelperAssist 區段新增至「所有屬性」視圖,並將 autoTab 設為 True。

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

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

限制

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

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

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

格式

指定元件所要操作的資料格式:
  • 字串 - 指定輸出的內容應使用文字字串格式。
  • 數字 - 指定輸出的內容應使用數字格式。
  • 日期/時間 - 指定輸出的內容應使用日期及/或時間格式。
  • 遮罩 - 指定過濾輸出內容時,可選擇併入或排除特定值。
請參閱個別格式類型表格,以取得詳細資料。

長度上限

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

長度下限

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

在瀏覽器中驗證欄位值

在執行時期可使用瀏覽器進行欄位驗證。

表 2. 格式類型配置選項

格式類型

格式選項

字串

h:inputText 標籤:
  • ID
  • 樣式:內容
  • 樣式:類別
  • 大小:寬度
「驗證」標籤:
  • 值是必要的
  • 長度上限
  • 長度下限
  • 限制
  • 按一下來建立/編輯自訂驗證程式碼
  • 在錯誤訊息控制中顯示驗證錯誤訊息
「行為」標籤:
  • 控制項為已停用
  • 控制項是唯讀的
  • 自動前進至下一個欄位
  • 在使用者輸入 X 個字元之後
  • 在瀏覽器中驗證欄位值
  • onBlur 及 onFocus 動作

數字

h:inputText 標籤:
  • ID
  • 樣式:內容
  • 樣式:類別
  • 大小:寬度
  • 類型:十進位
  • 選項
  • 限整數
  • 顯示說明程式按鈕
  • 類型
  • 遞增
  • 顯示提示字元
  • 提示字元
  • 類型:貨幣
  • 選項
  • 貨幣符號
  • 限整數
  • 顯示說明程式按鈕
  • 類型
  • 遞增
  • 顯示提示字元
  • 提示字元
  • 類型:百分比
  • 選項
  • 限整數
  • 顯示說明程式按鈕
  • 類型
  • 遞增
  • 顯示提示字元
  • 提示字元
  • 類型:自訂
  • 選項
  • 型樣
  • 顯示說明程式按鈕
  • 類型
  • 遞增
  • 顯示提示字元
  • 提示字元
「驗證」標籤:
  • 值是必要的
  • 使用簡式驗證
  • 最小值
  • 最大值
  • 使用進階驗證
  • 進階驗證表示式
  • 按一下來建立/編輯驗證程式碼
  • 在錯誤訊息控制中顯示驗證錯誤訊息
「行為」標籤:
  • 控制項為已停用
  • 控制項是唯讀的
  • 自動前進至下一個欄位
  • 在使用者輸入 X 個字元之後
  • 在瀏覽器中驗證欄位值
  • onblur 動作
  • onfocus 動作

日期/時間

h:inputText 標籤:
  • ID
  • 樣式:內容
  • 樣式:類別
  • 大小:寬度
  • 類型:限日期
  • 選項
  • 日期樣式
  • 顯示說明程式按鈕
  • 顯示提示字元
  • 提示字元
  • 類型:限時間
  • 選項
  • 時間樣式
  • 顯示說明程式按鈕
  • 遞增
  • 顯示提示字元
  • 提示字元
  • 類型:日期與時間
  • 選項
  • 日期樣式
  • 時間樣式
  • 顯示提示字元
  • 提示字元
「驗證」標籤:
  • 值是必要的
  • 使用簡式驗證
  • 最小值
  • 最大值
  • 使用進階驗證
  • 進階驗證表示式
  • 按一下來建立/編輯驗證程式碼
  • 依適當情形選擇使用 yyyy/dd/mm 或 hh:mm:ss 或 "now"。
  • 在錯誤訊息控制中顯示驗證錯誤訊息
「行為」標籤:
  • 控制項為已停用
  • 控制項是唯讀的
  • 自動前進至下一個欄位
  • 在瀏覽器中驗證欄位值
  • onblur 動作
  • onfocus 動作

遮罩

h:inputText 標籤:
  • ID
  • 樣式:內容
  • 樣式:類別
  • 大小:寬度
  • 選項
  • 遮罩
  • 顯示提示字元
  • 提示字元
「驗證」標籤:
  • 值是必要的
  • 長度下限
  • 長度上限
  • 按一下來建立/編輯自訂驗證程式碼
  • 在錯誤訊息控制中顯示驗證錯誤訊息
「行為」標籤:
  • 控制項為已停用
  • 控制項是唯讀的
  • 自動前進至下一個欄位
  • 在使用者輸入 X 個字元之後
  • 在瀏覽器中驗證欄位值
  • onblur 動作
  • onfocus 動作

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

表 3. 所有輸入屬性

屬性名稱

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

說明

accesskey

協助工具>存取鍵

指定單一鍵盤按鍵作為存取鍵。在執行時期按下指定的存取鍵時, 就會將焦點移至這個元件。

alt

沒有顯示

指定元件的替代文字。當元素無法正常呈現時,就會顯示;例如:不支援表單的瀏覽器,以及設定為不顯示影像的瀏覽器。

binding

沒有顯示

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

converter

沒有顯示

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

dir

沒有顯示

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

disabled

行為>停用控制項

如果 disabled 設為 true,在執行時期會顯示該元件,但無法使用。如果保留空白,預設值是 false。

id

ID

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

immediate

沒有顯示

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

lang

沒有顯示

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

maxlength

行為>在使用者輸入 X 個字元之後

當使用者在元件中輸入這個數目的字元後,啟用控制屬性。

readonly

行為>控制項是唯讀的

指定元件值不能從其起始值進行變更。

rendered

沒有顯示

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

required

驗證>必須輸入值

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

size

大小:寬度

指定元件的起始寬度,其值會參考字元的個數。

style

樣式:內容

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

styleClass

樣式:類別

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

tabindex

協助工具>欄標次序索引

指定元件在 JSP 內的定位次序位置。這個值必須是 0 和 32767 之間的數字。

title

協助工具>標題

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

validator

沒有顯示

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

value

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

valueChangeListener

沒有顯示

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

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