此元件建立一個可按下的按鈕,按鈕中包含文字標籤或影像。這個按鈕可用來送出貨重設表單。此外, 您可以為它撰寫程式,以執行伺服器端或用戶端的動作,或者用來導覽另一個頁面。
將指令 - 按鈕元件拖放到頁面上:
設計時頁面上的「指令 - 按鈕」元件:
執行時期頁面上的「指令 - 按鈕」元件:
元件的「內容」視圖會顯示您可以用來設定元件的最常用屬性集,而且針對不同的元件,您也會看到新增控制項、動作或其他元件的選項。若要開啟「內容」視圖,請按一下「視窗 > 顯示視圖 > 內容」;然而依預設會開啟該視圖。
「指令 - 按鈕」元件的這些共同屬性會顯示在「內容」視圖中的 hx:commandExButton、顯示選項、參數及協助工具標籤上。請參閱所有指令 - 按鈕屬性 表格,以取得完整的屬性清單。其他用來新增參數及動作的配置選項位於 hx:commandExButton 及 hx:commandExButton>Parameter 標籤上:
配置選項 |
說明 |
---|---|
新增要傳送給動作的參數 |
指定元件要傳送哪些參數給動作。 |
按一下來將這個按鈕所執行的動作寫成程式碼 |
切換至「快速編輯」視圖,以便將指令按鈕要執行的動作程式化。此外,規則可以根據動作和傳回的結果來定義。 |
「所有屬性」視圖會顯示您可以在元件上設定之所有屬性的表格,包括您可以從「內容」視圖來存取的那些屬性。若要切換至「所有屬性」視圖,請按一下「內容」視圖右上角的「所有屬性」圖示 。
屬性名稱 |
顯示在「內容」視圖中的排列依據 |
說明 |
---|---|---|
accesskey |
協助工具>存取鍵 |
指定單一鍵盤按鍵作為存取鍵。在執行時期按下指定的存取鍵時, 就會將焦點移至這個元件。 |
action |
沒有顯示 |
指定按一下元件時所傳回的值。 這個值會傳給預設 NavigationHandler,NavigationHandler 會比對這個值和應用程式配置檔所定義的一組導覽規則。 |
actionListener |
沒有顯示 |
回應動作的類別名稱。這只和能夠有動作的元件(如按鈕和鏈結)相關。 |
alt |
協助工具>替代文字 |
指定元件的替代文字。當元素無法正常呈現時,就會顯示;例如:不支援表單的瀏覽器,以及設定為不顯示影像的瀏覽器。 |
binding |
沒有顯示 |
代表這個元件的 UIComponent,通常是在支持的檔案中。 |
confirm |
提示文字 |
指定在按下 commandExButton 之後,要求使用者確認時所顯示的文字。如果沒有設定這個屬性值,就不會顯示確認對話框。 |
converter |
沒有顯示 |
指定值要轉換的資料類型。JavaServer Faces 實作提供一組轉換器實作,供您將元件資料轉換成它的呈現器所不支援的類型。 |
dimage |
類型>影像:停用的影像 |
指定在停用元件時要顯示的影像。 |
dir |
沒有顯示 |
指定執行時期的元件呈現方向。值可以是:
|
disabled |
沒有顯示 |
如果 disabled 設為 true,在執行時期會顯示該元件,但無法使用。如果保留空白,預設值是 false。 |
himage |
類型>影像:滑鼠通過時的影像 |
指定當使用者的滑鼠通過元件時要顯示的影像。 |
id |
ID |
指派元件的名稱。應該是 JSP 內的唯一名稱。 |
image |
類型>影像:正常影像 |
指定要在元件中顯示的 URL/URI 影像。 |
immediate |
沒有顯示 |
如果是 true,會直接跳到生命週期的呈現階段。 |
lang |
沒有顯示 |
指定元件屬性值和文字內容的基本語言。採用 ISO 標準語言縮寫碼(如 "en" 代表英文、"en-US" 代表美國英文、"fr" 代表法文、"de" 代表德文)。 |
pimage |
類型>影像:按下時的影像 |
指定當使用者按一下元件時要顯示的影像。 |
readonly |
沒有顯示 |
指定元件值不能從其起始值進行變更。 |
rendered |
沒有顯示 |
可以設成 true 或 false:
|
size |
沒有顯示 |
指定元件的起始寬度。 以像素來提供寬度,但其值參照字元數的文字輸入元件除外。 |
styleClass |
樣式:類別 |
當呈現這個元素時,所要套用的 CSS 樣式類別清單,各個類別之間是用空格加以區隔。 這個值必須作為產生的標記之 "class" 屬性來傳遞。定義已選取的元件的類別(例如樣式表)。 這可以用手動方式來完成,或者按一下按鈕,然後從視窗內選取想要的「類別」。 |
style |
樣式:內容 |
指定元件的 CSS 樣式資訊(如 style="font-size : 8pt ; color : red")。定義已選取的元件的內容(例如字型和顏色)。 這可以用手動方式來完成,或者按一下按鈕,然後從視窗內選取想要的內容。 |
tabindex |
協助工具>欄標次序索引 |
指定元件在 JSP 內的定位次序位置。這個值必須是 0 和 32767 之間的數字。 |
title |
協助工具>標題 |
指定執行時期在瀏覽器中顯示成工具要訣的標題文字。 |
type |
類型 |
指定按鈕類型,可選擇送出 或重設,其分別會送出或重設關聯表單中的資訊。 |
value |
類型>文字:按鈕標籤 |
指定要在指令按鈕中顯示的文字。 |