指令 - 超鏈結

在頁面上建立一個可按下的超鏈結。它可以用來導覽其他頁面,或為它撰寫程式,來執行用戶端或伺服器端的動作。選取此元件會新增超鏈結元件及相關聯的「輸出」文字(可編輯的個別元件)

設計時的元件

指令 - 超鏈結元件拖放到頁面上:
「指令 - 超鏈結」元件按鈕

頁面中的指令 - 超鏈結元件看起來與下面類似:
設計時的「指令 - 超鏈結」

執行時期的元件

在執行時期,頁面中的指令 - 超鏈結元件看起來與下面類似:
執行時期的「指令 - 超鏈結」

「內容及所有屬性」視圖

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

「指令 - 超鏈結」元件的這些共同屬性會顯示在「內容」視圖中的 h:commandLink參數協助工具標籤上。請參閱所有指令 - 超鏈結屬性 表格,以取得完整的屬性清單。其他用來新增參數及動作的配置選項位於 h:commandLinkh:commandLink>參數標籤上:

配置選項

說明

新增要傳送給動作的參數

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

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

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

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

表 1. 所有勾選框群組屬性

屬性名稱

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

說明

accesskey

協助工具>存取鍵

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

action

沒有顯示

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

actionListener

沒有顯示

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

binding

沒有顯示

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

charset

沒有顯示

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

coords

沒有顯示

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

dir

沒有顯示

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

hreflang

沒有顯示

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

id

ID

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

immediate

沒有顯示

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

lang

沒有顯示

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

rel

沒有顯示

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

rendered

沒有顯示

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

rev

沒有顯示

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

shape

沒有顯示

設定鏈結的形狀:
  • 矩形
  • 圓形
  • 多邊形

styleClass

樣式:類別

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

style

樣式:內容

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

target

沒有顯示

指派在按一下超鏈結時,頁框組內應該載入頁面的目標頁框:
  • 開新視窗
  • 相同頁框
  • 母項頁框
  • 全螢幕

tabindex

協助工具>欄標次序索引

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

title

協助工具>標題

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

type

沒有顯示

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

value

沒有顯示

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

相關概念
利用 JavaServer Faces 來建立資料存取 Web 應用程式
相關工作
建立 Faces 應用程式 - 概觀
相關參考
Faces 元件參照
Faces 元件的屬性
指令 - 按鈕
讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.