許多 Faces 元件有相關聯的事件。比方說,「指令 - 按鈕」元件有相關聯的事件,如 onclick 和 onmousedown。 利用已選取的 Faces 元件的「快速編輯」視圖,您可以定義特定事件的動作。
在元件的「快速編輯」視圖的左窗格中選取一個事件之後,您就可以在「快速編輯」視圖的右窗格中輸入 JavaScript™ 程式碼。這個程式碼代表呼叫事件時執行的動作。
下表包括標籤畫面元件和標籤畫面元件中的畫面的事件。事件 | 說明 | 支援的元件 |
---|---|---|
oncancel | 當使用者按一下取消時發動(如果已啟用它的話)。 利用這個事件的事件處理常式,您可以新增任何商業邏輯,例如清除使用者在部分輸入欄位中填寫的值。 事件物件有一個內容,tabpanelForm - 標籤畫面周圍的 HTML 表單(如果有的話)。 | 標籤畫面 |
onenter | 進入標籤畫面中的畫面時發動。 如果事件處理常式傳回 true,則標籤畫面可進入新畫面;否則焦點仍留在上一個畫面。利用這個事件的事件處理常式,您可以執行任何動作,例如驗證使用者輸入的資訊,或準備在此畫面中顯示的資訊。 事件物件有一個內容,tobeEnterPanel - 要進入的畫面的 ID。 | 標籤畫面中的畫面 |
onexit | 結束標籤畫面中的畫面時發動。 這個事件處理常式可傳回三個不同值;畫面 ID,代表將為下一個輸入的畫面,而非預設的下一個畫面。True,代表將顯示預設的下一個畫面。False 或不傳回任何值,代表焦點仍留在現行畫面上。 利用這個事件的事件處理常式,您可以新增任何商業邏輯,例如驗證使用者的輸入以及萬一驗證失敗時拒絕離開畫面,或控制流向下一個畫面。當標籤畫面搭配「下一步」和「上一步」按鈕時,這個事件處理常式可用來建立複雜流程。 事件物件有一個內容,tobeExitPanel - 要進入的畫面的 ID。 | 標籤畫面中的畫面 |
onfinish | 標籤畫面控制項支援 onfinish 事件,當使用者按「完成」時會發動該事件(如果已啟用它的話)。 利用這個事件的事件處理常式,您可以新增任何商業邏輯,例如驗證使用者輸入的資訊及送出表單。 事件物件有一個內容,tabpanelForm - 標籤畫面周圍的 HTML 表單(如果有的話)。 | 標籤畫面 |
oninitialpanelshow | 這個事件是在標籤畫面呈現於頁面之前發動。 這個事件處理常式的回覆值決定哪一個畫面是最初作用中的畫面。如果沒有回覆值,則會顯示第一個畫面。如果使用者想要以第一個畫面以外的某個畫面作為最初顯示的畫面, 則回覆值必須是該畫面的 ID。 | 標籤畫面 |
onpanelenter | 標籤畫面控制項支援 onpanelenter 事件,當使用者進入標籤畫面的任何畫面時會發動該事件。 如果畫面已有其 onenter 事件的事件處理常式,則會在這個事件之前先呼叫該事件。 如果事件處理常式傳回 true,則標籤畫面可進入新畫面;否則焦點仍留在上一個畫面。利用這個事件的事件處理常式,您可以新增一些在進入任何畫面時需要呼叫的共用商業邏輯。 事件物件有一個內容,tobeEnterPanel - 要進入的畫面的 ID。 | 標籤畫面 |
onpanelexit | 標籤畫面控制項支援 onpanelexit 事件,當使用者結束標籤畫面的任何畫面時會發動該事件。 如果畫面已有其 onexit 事件的事件處理常式,則會在這個事件之前先呼叫該事件。 如果事件處理常式傳回 true,則標籤畫面可結束畫面;否則焦點仍留在現行畫面。利用這個事件的事件處理常式,您可以新增一些在結束任何畫面時需要呼叫的共用商業邏輯。 事件物件有一個內容,tobeExitPanel - 要結束的畫面的 ID。 | 標籤畫面 |