Faces 屬性參照

這是所有 JSF 元件的全部可能屬性的清單。

設計時的元件

執行時期的元件

屬性

「內容」視圖

在選用區中,某些元件可能會隱藏起來。如果要在選用區中顯示隱藏的元件,請在選用區視圖中按一下滑鼠右鍵來選取自訂。 請移除要在選用區上顯示的每個元件之隱藏旁的勾號。 一開始會隱藏的元件會在元件下面顯示一個星號 (*)。元件的「內容」視圖會顯示您可以用來設定元件的最常用屬性集,而且針對不同的元件,您也會看到新增控制項、動作或其他元件的選項。若要開啟「內容」視圖,請按一下「視窗 > 顯示視圖 > 內容」;然而依預設會開啟該視圖。


「內容」視圖

「所有屬性」視圖

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


「所有屬性」視圖

「內容及所有屬性」視圖

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

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

內容名稱

顯示在「所有屬性」視圖中的排列依據

屬性名稱

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

說明

若為元件

配置選項

沒有顯示

格式類型

格式選項

新增按一下某一列時要執行的動作

可讓您建立在按一下橫列時,所要發生的執行時期動作。

新增一個編輯直欄,以啟動表單來就地編輯行列內容。

可讓您提供執行時期的列內編輯作業。

新增選項直欄至表格中

可讓您新增直欄及與表格內容相關的選項。

新增用來對標頭操作選項的動作

可讓您建立用來操作標頭資訊的動作。

為群組中的每一個勾選框新增一個選項

可讓您指定勾選框群組元件中的方框的名稱、值和次序。您可以新增單一選項或一組選項。

為組合框下拉清單中的每一個項目新增一個選項

可讓您指定元件下拉功能表中的項目的名稱、值和次序。

為群組中的每一個圓鈕新增一個選項

可讓您指定圓鈕群組元件中的按鈕的名稱、值和次序。

為清單框中的項目新增一個選項

可讓您指定清單框元件中的項目的名稱、值和次序。

為值字串中的每一個 {n} 新增一個要替換的參數值

可讓您指定「輸出訊息」參數的名稱和值。 您也可以使用「移除」按鈕來移除項目,並且使用「上移」和「下移」按鈕來變更它們在畫面中的次序。

新增用來控制播放器的參數

指定要使用哪些參數來控制媒體播放器元件。

新增要傳送給動作的參數

指定元件要傳送哪些參數給動作。

為每一個標籤新增一個畫面,以便在控制項中顯示

可讓您指定畫面中的標籤的 ID、標籤和次序 - 已加上標籤的元件。此外,您也可以指定個別的標籤來包含預先定義的完成及取消指令按鈕元件。

新增 Web 樣式分頁器

新增每一個頁碼至標底區域,讓使用者可以按一下想要的頁面。

分類>新增直欄以將表格列分類

分類>移除直欄以將表格列分類

新增含有橫列分類元件的直欄,您可以在其中設定表格排序值,以及新增圖示或文字至直欄。新增好之後,「分類」圖示會變成「移除」。

新增移至分頁器

新增一個元件至標底區域,讓您從下拉清單中選取一個頁面。

新增高階分頁器

新增一個元件至標底區域,這個元件可使用箭頭在頁面之間移動。

新增簡易分頁器

新增一個元件至標底,這個元件會建立一個簡易的下拉功能表,以用來移至下一頁。

新增頁面資訊

新增一個元件至標底區域,這個元件在頁面上顯示統計資料。

新增項目至控制項

可讓您檢視功能表列中的項目,以及超鏈結、指令按鈕、子畫面和分隔字元。您也可以使用「移除」按鈕來移除項目,並且使用「上移」和「下移」按鈕來變更它們在畫面中的次序。

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

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

指派動作給指定的按鍵。

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

背景影像

指定要用來作為背景的影像。 按一下瀏覽按鈕來選擇影像檔或連結資料來源。

按一下來將這個按鈕所執行的動作寫成程式碼

切換至「快速編輯」視圖,以便將指令按鈕要執行的動作程式化。此外,規則可以根據動作和傳回的結果來定義。

按一下來將這個鏈結所執行的動作寫成程式碼

切換至「快速編輯」視圖,以便將超鏈結要執行的動作程式化。此外,規則可以根據動作和傳回的結果來定義。

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

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

直欄

指定是否要將標頭及(或)標底併入到資料表。請使用「新增」和「移除」按鈕來新增或移除直欄。請使用「上移」和「下移」按鈕來修改直欄的次序。

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

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

不要將 Cell 內容折行

指定不要將選取的 Cell 的內容折行。

檔案類型

指定元件要使用的檔案類型。可以用靜態的方式定義,或者鏈結到資料儲存體。

檔案名稱

指定元件所要使用之檔案的名稱。可以用靜態的方式定義,或者鏈結到資料儲存體。

格式

指定元件所要操作的資料格式: 請參閱個別格式類型表格,以取得詳細資料。

字串

字串:指定使用者所提供的輸入內容應該使用文字字串的格式。

數字

數字:指定使用者所提供的輸入內容應該使用數字的格式。

日期/時間

日期/時間:指定使用者所提供的輸入內容應該使用日期及(或)時間的格式。

遮罩

遮罩:指定使用者所提供的輸入內容應該以選擇性併入或排除特定值的方式來過濾。

指定元件所要操作的資料格式: 請參閱個別格式類型表格,以取得詳細資料。

格式:字串

字串:指定輸出的內容應使用文字字串格式。

格式:數字

數字:指定輸出的內容應使用數字格式。

格式:日期/時間

日期/時間:指定輸出的內容應使用日期及/或時間格式。

格式:遮罩

遮罩:指定過濾輸出內容時,可選擇併入或排除特定值。

隱藏欄位

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

水平對齊方式

指定畫面應該靠左對齊、置中或靠右對齊。

選項

選項>開啟一個視窗,其中包含可為這個元件設定的自訂屬性的清單。

畫面中的項目次序

可讓您使用「上移」和「下移」按鈕來指定畫面中的元件次序。

選取這個欄位的內容

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

顯示標頭

勾選這個方框會將標頭區域 f:facet(標頭)h:panelBox 插入資料表中,以便之後移入其他元件。

顯示說明程式按鈕

顯示說明程式按鈕>指定元件應該顯示說明程式按鈕給使用者。

顯示標底

勾選這個方框會將標底區域 f:facet(標底)h:panelBox 插入資料表中,以便之後移入其他元件。

顯示提示字元

顯示提示字元>指定為了提示使用者輸入所顯示的符號。

使用簡式驗證

使用簡式驗證>可讓您輸入元件要用來驗證的簡式最小及最大範圍。

使用進階驗證

使用進階驗證>可讓您指定更進階的表示式,以使用 EL 語法來進行驗證。

在瀏覽器中驗證欄位值

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

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

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

「所有屬性」視圖屬性

accept

容許下列檔案類型

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

acceptcharset

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

accesskey

協助工具>存取鍵

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

action

指定按一下元件時所傳回的值。 這個值會傳給預設 NavigationHandler,NavigationHandler 會比對這個值和應用程式配置檔所定義的一組導覽規則。

actionListener

回應動作的類別名稱。這只和能夠有動作的元件(如按鈕和鏈結)相關。

align

對齊方式

指定元件的對齊方式:
指定元件的對齊方式:

對齊方式:水平

指定元件應該靠左對齊、置中或靠右對齊。

alt

協助工具>替代文字

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

archive

用來呈現「媒體元件」的物件 html 標示的相關屬性, 這個屬性可用來指定物件的相關資源所在的保存檔的 URL 清單(URL 之間是用空格加以區隔)。

asis

指定是否要移除無遮罩的輸入資料。預設值是 false。

autoseparate

在每一個項目之間顯示分隔字元

勾選這個方框時,會指定要在動作列中的項目之間顯示分隔線。如果 autoseparate 設為 true,當呈現時,會在所包含的每個元件之間自動插入分隔字元項目。 如果保留空白,預設值就是 false,不會插入分隔字元。

autoStart

自動播放

如果 autostart 設為 true,就會在元件中自動開始播放複合式多媒體檔。勾選這個選項時,會使元件在執行時期自動啟動。

autoTab

自動前進至下一個欄位

在輸入指定的字元數目後,自動前進至另一個輸入欄位。預設值是 False。

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

backgroundcolor

設定影像視窗的背景顏色。 當片段包括透通區域時,這些區域也會透出背景顏色。

baseURL

指定媒體播放器要在其中作業的基本 URL。 如果需要詳細資訊,請參閱 MSDN Library 中 baseURL 的 Windows® Media 文件。

bgcolor

背景顏色

以 6 位數的十六進位 RGB 值來指定背景顏色,並且以 # 符號作為開頭,或者輸入顏色名稱,例如:黑色、白色、藍色等等。

指定電影本身出現之前的電影矩形顏色。 這個值用標準的六個十六進位字元 RGB 顏色表示法(如 #FFFF00)來表示。

binding

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

border

邊框

指定表格的邊框大小(像素)。

指定影像的邊框大小(像素)。

cancelBubble

指定是否要取消瀏覽器所管理的事件 Bubble:

cellpadding

填補

指定資料格邊框和內容的間隔。 如果這個屬性值是像素長度,四個邊距和內容之間都應該是這個距離。

指定資料格邊框和內容的間隔。 如果這個屬性值是像素長度,四個邊距和內容之間都應該是這個距離。

cellspacing

間距

指定表格內的個別 Cell 之間的空間量(像素)。

指定 Cell 之間要保留的空間量(像素)。

center

指定應不應該呈現在影像視窗中央,並依照原始編碼大小來顯示。

charset

這個超鏈結指示的資源之字元編碼。

codebase

指定用來解析元件中的其他屬性所指定之相對 URI 的基本路徑。

collapsed

指定種類列的起始收合狀態。值可以是 true 或 false。如果保留空白,預設值是 true。

collapsedImage

指定種類收合時所顯示的自訂影像。

color

顏色

以 6 位數的十六進位 RGB 值來指定選定元件的顏色,並且以 # 符號作為開頭,或者輸入顏色名稱,例如:黑色、白色、藍色等等。

columnClasses

直欄類別

指派已定義的 CSS 樣式表樣式給資料表格元件的直欄。CSS 樣式表檔案必須先鏈結到元件的 JSP 才能使用。這可以用手動方式來輸入,或者按一下按鈕,然後從視窗內選取想要的類別。

cols

大小:寬度

指定執行時期所顯示的直欄數。

columns

直欄

指定執行時期所顯示的直欄數。

在表格中新增或移除直欄元件。您可以針對每個直欄來設定標籤、寬度及 ID,並且在表格中移動。

大小:直欄

指定格線中的直欄數。

confirm

提示文字

指定在按下 commandExButton 之後,要求使用者確認時所顯示的文字。如果沒有設定這個屬性值,就不會顯示確認對話框。

console

當指定了相同的主控台名稱給網頁中的多個控制項時,這個參數可用來讓這些控制項管理單一內嵌呈現的播放。比方說,如果相同頁面中有多個「播放」和「停止」按鈕,共用的主控台名稱可讓它們控制相同的片段。

contentClass

關聯於元件的替代 CSS 類別名稱。 從名稱可以判斷它們的使用情況。

controls

將指定的 RealPlayer 控制項內嵌在網頁中。

converter

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

coords

畫面中熱點的位置和形狀(供用戶端影像鏈結圖使用)。

currencyCode

將輸入文字字串轉換成輸入文字號碼格式。

currencySymbol

貨幣符號

指定所要輸入之貨幣的符號。當您指定貨幣數字類型時,這個選項就會啟用。

dateStyle

日期樣式

預先定義的格式化樣式決定如何格式化和剖析日期字串中的日期部分。僅適用於 dateboth 類型。有多種日期格式可供選擇:

decode

用來指定在 scriptCollector 元件的解碼階段所呼叫的方法。

dimage

類型>影像:停用的影像

指定在停用元件時要顯示的影像。

dir

指定執行時期的元件呈現方向。值可以是:

disabled

停用控制項

行為>停用控制項

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

disableCancel

如果設為 true,在執行時期會顯示「取消」按鈕,但無法使用。如果保留空白,預設值是 false。

disabledClass

元件相關聯的替代 CSS 類別名稱。從名稱可以判斷它們的使用情況。

disableFinish

如果設為 true,在執行時期會顯示「完成」按鈕,但無法使用。如果保留空白,預設值是 false。

editStyle

編輯窗格所套用的 CSS 樣式。

editStyleClass

編輯窗格和控制項所套用的 CSS 樣式類別。

enableContextMenu

指定使用者按一下滑鼠右鍵時,是否要顯示快速功能表。預設值是 true。

enabledClass

元件相關聯的替代 CSS 類別名稱。從名稱可以判斷它們的使用情況。

enctype

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

errorAction

指定當用戶端驗證產生錯誤時,所呼叫之預先定義動作或 JavaScript™ 函數所要執行的動作。

errorClass

關聯於元件的替代 CSS 類別名稱。 從名稱可以判斷其使用情況。

指定錯誤的 CSS 類別。當在輸入欄位中按一下有效的按鍵時,樣式會重設為 successClass 樣式。如果未指定 successClass,就會使用 input_text 的 css 類別。 當 errorClass 和 successClass 都沒有指定時,不會重設 css 類別。 您可以指定多個類別,並以逗點區隔,例如:errorClass="class, class2, class3"。

errorStyle

CSS 類別的樣式修飾元。

escape

指定要跳出 HTML 格式化作業 (False) ,或是要以 HTML 來呈現 HTML 標示 (True)。

呈現值中的 HTML。

exclude

要排除的 MIME 類型。

exclude

不容許下列檔案類型

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

expandedImage

指定種類展開時所顯示的自訂影像。

fatalClass

關聯於元件的替代 CSS 類別名稱。 從名稱可以判斷它們的使用情況。

fatalStyle

CSS 類別的樣式修飾元。

first

要顯示的第一列的索引。

footerClass

標底類別

指派已定義的 CSS 樣式表樣式給資料表格元件的直欄標頭。CSS 樣式表檔案必須先鏈結到元件的 JSP 才能使用。這可以用手動方式來輸入,或者按一下按鈕,然後從視窗內選取想要的類別。

for

要加上標籤的 ID

指定要套用說明程式元件的元件。這個值應該是所說明的元件的 ID。

顯示元件的錯誤訊息

指定您要攫取及顯示錯誤訊息的輸入欄位 ID。

frame

指定可看到表格周遭頁框的哪幾邊:

指定可看到格線周遭頁框的哪幾邊。

globalOnly

顯示此頁面產生的所有錯誤訊息

僅顯示與特定元件沒有關聯的錯誤訊息。

指定元件應該顯示哪些錯誤訊息,可選擇頁面產生的所有錯誤訊息 (False),或只顯示尚無關聯之元件的錯誤訊息 (True)。

groupingsUsed

指定格式化的輸出是否將包含分組分隔字元。

headerClass

標頭類別

指派已定義的 CSS 樣式表樣式給資料表格元件的直欄標頭。CSS 樣式表檔案必須先鏈結到元件的 JSP 才能使用。這可以用手動方式來輸入,或者按一下按鈕,然後從視窗內選取想要的類別。

height

大小:高度

指定元件的高度(像素或百分比)。如果要指定百分比,請在值中附加 %。

指定元件的高度(像素)。

hidden

指定是否要在網頁中隱藏播放器。

himage

類型>影像:滑鼠通過時的影像

指定當使用者的滑鼠通過元件時要顯示的影像。

這個按鈕的影像路徑。

hreflang

這個超鏈結所指出之資源的語言碼。

hspace

邊距:水平

指定要在元件左右兩側插入的空間(像素)量。

id

ID

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

imagekey

imageKey 屬性結合 "bundle" 屬性使用,它與 bundle 指定的 key=value 配對集內的某個索引鍵相關,key = value 配對中的 value 是某個影像檔的 URL/URI。

image

類型>影像:正常影像

指定要在元件中顯示的 URL/URI 影像。

imeMode

這個屬性只對 Internet Explorer 有效。指定 IME 模式:

immediate

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

infoClass

關聯於元件的替代 CSS 類別名稱。 從名稱可以判斷它們的使用情況。

infoStyle

CSS 類別的樣式修飾元。

initialPandelld

指定畫面的起始 ID。

inputAssistant

指定是否要啟用用戶端自動格式化作業。預設值是 false(不啟用)。

integerOnly

指定是否只剖析值的整數部分。

僅限整數

指定要將輸入到欄位中的數字限定為整數。

ismap

如果設為 true,影像元件會設定成使用伺服器端影像鏈結圖。 請注意,圖形元件必須包含在超鏈結元件內。

key

指定索引鍵表示式。

label

指定顯示的文字。

lang

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

layout

畫面方向

畫面佈置:方向

指定採用水平或垂直佈置:

方向

方向

指定元件的方向是水平或垂直:

顯示錯誤:佈置

指定要將元件的輸出格式化成為段落或清單樣式:

locale

在格式化或剖析期間使用其預設日期和時間樣式的語言環境。如果沒有指定,就會使用 FacesContext.getViewRoot().getLocale() 傳回的語言環境。

在格式化或剖析期間使用其預設數字樣式的語言環境。 如果沒有指定,就會使用 FacesContext.getViewRoot().getLocale() 傳回的語言環境。

longdesc

指定影像詳細說明的鏈結。這個說明應該補充 alt 屬性所提供的簡短說明。

loop

指定片段的播放應該繼續進行或進入無限迴圈。預設值是 true。

指定電影要無限重複,或在到達最後一個訊框時停止。預設值是 true。

mask

利用遮罩字元來指定輸入遮罩型樣。請用 # 作為數字位置保留區,用 ? 作為字母位置保留區。

遮罩

利用遮罩字元來指定輸出遮罩型樣。請用 # 作為數字位置保留區,用 ? 作為字母位置保留區。

maxFractionDigits

輸出的小數部分將格式化的位數上限。

maxIntegerDigits

輸出的整數部分將格式化的位數上限。

maxlength

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

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

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

指定輸入元件所接受的字元長度上限。

指定檔名及位置的字元長度上限。

menu

指定顯示的功能表類型:

mimeType

類型

當 src 是連結至二進位資料時,用來宣告媒體 MIME 類型。

最小值

長度下限

在伺服器上送出這個元件時,元件可包含的字元數目下限。

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

最大值

長度上限

在伺服器上送出這個元件時,元件可包含的字元數目上限。

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

minFractionDigits

輸出的小數部分將格式化的位數下限。

minIntegerDigits

輸出的整數部分將格式化的位數下限。

name

指定元件的名稱,在 JSP 中該名稱應該是唯一的。

指定新增項目的名稱,例如:資料表中的 header(標頭)。

nestedExpanded

開始時顯示展開的畫面

展開或收合子項 panelActionbar。只有當 panelActionbar 是另一個 panelActionbar 內的巢狀結構時才適用。

nestedImagePosition

影像位置

將影像放在子項 panelActionbar 的標籤前面或後面。只有當 panelActionbar 是另一個 panelActionbar 內的巢狀結構時才適用。

nestedIndent

子項 panelActionbar 之子功能表的縮排量。只有當 panelActionbar 是另一個 panelActionbar 內的巢狀結構時才適用。

nestedTitleText

標籤

子項 panelActionbar 的標籤。只有當 panelActionbar 是另一個 panelActionbar 內的巢狀結構時才適用。

nestedTitleImage

影像

指定影像位於標籤之前或之後。欄位右邊的按鈕可讓您瀏覽或匯入影像。

noscript

請勿使用含此控制項的 JavaScript。

noshade

使用 3-D 陰影來顯示

勾選此選項會以三度空間的陰影來顯示元件。若將 noshade 設為 true,就會以原色來呈現元件。如果保留空白,所使用的瀏覽器就會依其預設方式來顯示標示。

numOfTabs

在顯示 X 個標籤後捲動

畫面所顯示的標籤數。將元件內可以看到的標籤數目限定為在欄位中輸入的值。您可以利用插入的捲動控制項來存取其他標籤。

pattern

型樣

當您選取自訂類型數字欄位時,這個選項就會啟用。這是決定應該如何剖析字串的自訂格式化型樣。

pimage

類型>影像:按下時的影像

指定當使用者按一下元件時要顯示的影像。

playCount

指定片段播放的次數。

playerAttributes

如果要新增其他播放器屬性/參數的清單,清單應該是以逗點區隔的 name=value 配對清單。

pluginsPage

指定下載的播放器程式碼所在的 URL。如果還沒有安裝播放器,就會顯示出來。

pluginUrl

指定用來下載含播放器程式碼之 Java™ 保存檔 (JAR) 的位置。如果還沒有安裝播放器,就會顯示出來。

preRender

用來指定在編碼開始時所要呼叫的方法。scriptCollector 的開始階段,也就是在呼叫該方法之後,就會立即呈現元件。

postRender

用來指定在編碼結束時所要呼叫的方法。scriptCollector 的結束階段,也就是當元件呈現之後,就會立即呼叫該方法。

promptCharacter

底線字元 ( _ ) 是內容的預設字元值。PromptChar 內容只能設成正好一個字元。

提示字元

指定在提示使用者輸入時要顯示的字元。

quality

指定播放品質:

選項:品質

指定元件的圖片品質層次。請注意,品質層次為「高」可能會影響效能。

readonly

控制項是唯讀的

行為>控制項是唯讀的

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

redisplay

如果設為 'true',在執行時期送出密碼欄位所在表單之後,會在相同的指定密碼欄位中重新顯示密碼星號。

regex

限制

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

rel

從現行文件到這個超鏈結指定之錨點的關係。這個屬性值是以空格區隔的鏈結類型清單。

renderButton

將按鈕呈現成鍵盤導覽的協助工具連結鉤。

rendered

可以設成 true 或 false:

required

必須輸入值

驗證>必須輸入值

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

rev

從這個超鏈結指定的錨點反向鏈結到現行文件。這個屬性值是以空格區隔的鏈結類型清單。

rowClasses

橫列類別

在顯示列時所輪流選取的一組類別。這可以用手動方式來定義,或者按一下按鈕,然後從視窗內選取想要的類別。

rows

每一頁的列數

指定執行時期所顯示的列數。

rules

指定表格內的各資料格之間將出現哪些尺規:

salign

指定對齊方式:

scale

指定調整比例:

separatorSize

大小(項目之間的像素)

指定元件內的項目之間的大小(像素)。

指定分隔字元所在的呈現表格資料格之像素寬度。

separatorStyle

樣式

指派已定義的 CSS 樣式表樣式給分隔字元(例如:實線或空格)。CSS 樣式表檔案必須先鏈結到元件的 JSP 才能使用。

shape

設定鏈結的形狀:

showFinishCancelButton

顯示完成取消按鈕。

showBackNextButton

顯示下一步上一步按鈕。

勾選這個方框時,會插入一對按鈕,以便在元件內的不同標籤之間循環。

指定在畫面之間導覽時,是否顯示上一頁下一頁按鈕。

showDetail

指定是否要顯示錯誤的詳細部分。

showSummary

指定是否要顯示訊息摘要。

showTabs

隱藏標籤

勾選這個方框時,可指定要讓使用者看不到元件中的標籤。

每次只顯示這麼多標籤,同時顯示用來進入未顯示的標籤的捲動按鈕。

shuffle

指定應不應該依隨機次序來播放呈現中所有未播放的片段。 這個參數可用於多片段的 RAM 檔(.ram 或 .rpm)或只含有一系列片段的 SMIL 檔

size

大小:高度

指定元件的高度(可以是行數、像素或畫面的百分比)。

大小:寬度

指定元件的起始寬度。 以像素來提供寬度,但其值參照字元數的文字輸入元件除外。

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

slantActiveLeft

當標籤成為所選取的標籤時,標籤左上方「切下」的寬度。

slantActiveRight

當標籤成為所選標籤時,標籤左上方切下的寬度

slantInactiveLeft

當標籤不是所選取的標籤時,標籤左上方「切下」的寬度。

slantInactiveRight

當標籤不是所選取的標籤時,標籤右上方「切下」的寬度。

標籤邊框曲線(像素)

標籤相關一端(左邊或右邊)的「切下」寬度。您可以設定作用中和非作用中標籤的寬度。

srcFirst

代表第一個按鈕的影像之 URL。

srcLast

代表最後一個按鈕的影像之 URL。

srcNext

代表下一個按鈕的影像之 URL。

srcPrevious

代表上一個按鈕的影像之 URL。

srcSelected

當選取時所顯示的影像之 URL。

srcUnselected

當未選取時所顯示的影像之 URL。

src

檔案

要播放的媒體檔。指定元件要使用的檔案。

standby

指定在載入元件的實作和資料時,瀏覽器所能呈現的訊息。

stretchToFit

指定是否要維護所要播放之影像的原始長寬比。預設值是 false。

style

樣式:內容

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

styleClass

樣式:類別

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

successAction

指定當用戶端驗證成功時,所呼叫之預先定義動作或 JavaScript 函數所要執行的動作。

successClass

指定用戶端驗證成功的 CSS 類別。可以指定多個類別。

summary

指定在非視覺化媒體中呈現的使用者代理程式的摘要明細字串。

swRemote

控制所有 Shockmachine 功能,並且有個別子參數。如需詳細資料,請參閱 Macromedia Director Support Center 中的 Shockmachine 參數。

swStretchHAlign

指定 swStretchStyle 設成 meetstage 時的水平對齊:

swStretchStyle

指定 Shockwave 媒體所用的拉伸樣式:

swStretchVAlign

指定 swStretchStyle 設成 meetstage 時的垂直對齊:

tabindex

協助工具>欄標次序索引

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

tabindexStartAt

指定種類的 tabindex 內容起始號碼。預設值是 0。

target

指派在按一下超鏈結時,頁框組內應該載入頁面的目標頁框:

依標示 ID 來指定動作目標。當沒有指定目標但設定了動作時,預設目標是事件來源物件。

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

targetAction

指定預先定義的動作。

textStyleClass

文字欄位所套用的 CSS 類別。當在 CSS 中使用 ELEMENT.className 表示法時,這接受在 input type=submit 和 input type=text 之間的區別。

timeStyle

時間樣式

預先定義的格式化樣式決定如何格式化和剖析日期字串中的時間部分。只有在類型是 "time" 或 "both" 時,這個屬性才能運作。選取「日期/時間」時,就會出現這個選項。有多種時間格式可供選擇:

timeZone

用來解譯日期字串中之任何時間資訊的時區

title

協助工具>標題

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

tooltip

指定訊息的詳細資料部分應不應該顯示成工具要訣。

type

類型

指定按鈕類型,可選擇送出重設,其分別會送出或重設關聯表單中的資訊。

指定元件應該使用來自資料庫的項目

指定元件所要使用的數字類型。

指定是否要在輸出欄位中顯示日期、時間或二者都顯示。

uiMode

指定內嵌之 Windows Media Player 的外觀。

url

指定元件應使用的 URL。

useButtons

呈現文字按鈕,而不是影像。

usemap

指定元件要用的影像鏈結圖。 影像鏈結圖由 MAP 元素來定義。 usemap 值必須符合相關 MAP 元素的 name 屬性值。

validation

指定是否要啟用用戶端驗證。預設值是 true(啟用)。

validator

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

valign

對齊方式:垂直

指定資料在資料格內的垂直位置:

value

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

檔案

指定元件要使用的檔案。

類型>文字:按鈕標籤

指定要在指令按鈕中顯示的文字。

URL

指定元件所鏈結的頁面。如果是在頁面上建立鏈結,就可以用手動方式來指定, 或者可以按一下按鈕,然後從視窗內選取頁面。

valueChangeListener

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

var

使用值屬性來指定可用資料的參照變數名稱。

variableTabLength

指定標籤長度是否隨著名稱而不同。

variableTableLength

標籤的佈置:使用統一的寬度來顯示標籤

指定要使用相同的寬度來顯示元件內的所有標籤。

volume

指定音量,以一百個分貝為單位,範圍是 -10,000 至 0 之間。預設值是 -600。

vspace

邊距:垂直

指定要在元件上下兩端插入的空間量(像素)。

warnClass

關聯於元件的替代 CSS 類別名稱。 從名稱可以判斷它們的使用情況。

warnStyle

CSS 類別的樣式修飾元。

width

寬度

大小:寬度

指定元件的寬度(像素或百分比)。如果要指定使用百分比,請在值中附加 %。

wmode

指定 Flash 電影在瀏覽器中的透通性、分層及定位等視窗模式內容。
讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.