可讓使用者輸入文字資料。與「輸入」元件不同的是, 這個元件可讓您指定許多不同類型的文字輸入, 「文字區」可讓使用者輸入許多文字行。輸入控制項通常會連結到某些類型的資料儲存體,例如資料庫或 Bean。 若送出含有這個輸入控制項的頁面時,輸入欄位的內容會儲存在指定位置(例如,資料庫的直欄或 Bean 的內容)。
將輸入 - 文字區元件拖放到頁面上:
頁面中的輸入 - 文字區元件看起來與下面類似:
在執行時期,頁面中的輸入 - 文字區元件看起來與下面類似:
元件的「內容」視圖會顯示您可以用來設定元件的最常用屬性集,而且針對不同的元件,您也會看到新增控制項、動作或其他元件的選項。若要開啟「內容」視圖,請按一下「視窗 > 顯示視圖 > 內容」;然而依預設會開啟該視圖。
「輸入 - 文字區」元件的這些共同屬性顯示在「內容」視圖的 h:inputTextArea、驗證、行為及協助工具標籤中。 如需完整的屬性清單,請參閱所有輸入 - 文字區表格中的屬性。用以驗證輸入的其他配置選項則在 h:inputTextArea>驗證標籤:
配置選項 |
說明 |
---|---|
按一下來建立/編輯自訂驗證程式碼 |
切換至「快速編輯」視圖,以便為各種使用者起始的事件輸入 Script 或程式碼片段。 |
限制 |
限制可輸入到元件中的字元類型(例如,只有數字、只有 ASCII 英文字母等等)將含有 regex 屬性的 hx:validateConstraint 新增至「所有屬性」視圖。 |
在錯誤訊息控制中顯示驗證錯誤訊息 |
插入與選取的元件相關聯的錯誤訊息控制元件。這樣就會在驗證失敗時顯示錯誤訊息。 |
長度上限 |
在伺服器上送出這個元件時,元件可包含的字元數目上限。它會將含有 maximum 屬性的 f:validateLength函數新增至「所有屬性」視圖。 |
長度下限 |
在伺服器上送出這個元件時,元件可包含的字元數目下限。它會將含有 minimum 屬性的 f:validateLength函數新增至「所有屬性」視圖。 |
「所有屬性」視圖會顯示您可以在元件上設定之所有屬性的表格,包括您可以從「內容」視圖來存取的那些屬性。若要切換至「所有屬性」視圖,請按一下「內容」視圖右上角的「所有屬性」圖示 。
屬性名稱 |
顯示在「內容」視圖中的排列依據 |
說明 |
---|---|---|
accesskey |
協助工具>存取鍵 |
指定單一鍵盤按鍵作為存取鍵。在執行時期按下指定的存取鍵時, 就會將焦點移至這個元件。 |
binding |
沒有顯示 |
代表這個元件的 UIComponent,通常是在支持的檔案中。 |
cols |
大小:寬度 |
指定執行時期所顯示的直欄數。 |
converter |
沒有顯示 |
指定值要轉換的資料類型。JavaServer Faces 實作提供一組轉換器實作,供您將元件資料轉換成它的呈現器所不支援的類型。 |
dir |
沒有顯示 |
指定執行時期的元件呈現方向。值可以是:
|
disabled |
行為>停用控制項 |
如果 disabled 設為 true,在執行時期會顯示該元件,但無法使用。如果保留空白,預設值是 false。 |
id |
ID |
指派元件的名稱。應該是 JSP 內的唯一名稱。 |
immediate |
沒有顯示 |
如果是 true,會直接跳到生命週期的呈現階段。 |
lang |
沒有顯示 |
指定元件屬性值和文字內容的基本語言。採用 ISO 標準語言縮寫碼(如 "en" 代表英文、"en-US" 代表美國英文、"fr" 代表法文、"de" 代表德文)。 |
readonly |
行為>控制項是唯讀的 |
指定元件值不能從其起始值進行變更。 |
rendered |
沒有顯示 |
可以設成 true 或 false:
|
required |
驗證>必須輸入值 |
必須指定元件。勾選這個方框時,使用者必須輸入一個值。 |
rows |
大小:高度 |
指定執行時期所顯示的列數。 |
style |
樣式:內容 |
指定元件的 CSS 樣式資訊(如 style="font-size : 8pt ; color : red")。定義已選取的元件的內容(例如字型和顏色)。 這可以用手動方式來完成,或者按一下按鈕,然後從視窗內選取想要的內容。 |
styleClass |
樣式:類別 |
當呈現這個元素時,所要套用的 CSS 樣式類別清單,各個類別之間是用空格加以區隔。 這個值必須作為產生的標記之 "class" 屬性來傳遞。定義已選取的元件的類別(例如樣式表)。 這可以用手動方式來完成,或者按一下按鈕,然後從視窗內選取想要的「類別」。 |
tabindex |
協助工具>欄標次序索引 |
指定元件在 JSP 內的定位次序位置。這個值必須是 0 和 32767 之間的數字。 |
title |
協助工具>標題 |
指定執行時期在瀏覽器中顯示成工具要訣的標題文字。 |
validator |
沒有顯示 |
要建立實例之驗證器的類別名稱。 |
value |
值 |
指定執行時期所顯示的元件起始文字值。 包含要顯示的資訊,其格式為指定值或動態值的指標。 |
valueChangeListener |
沒有顯示 |
元件值有了改變時所要通知的方法。 |