元件事件

一、概述

1. 根據元件響應時間的不同，我們把元件的事件分為九種：初始化後、編輯前、編輯後、編輯結束、點選、狀態改變、值改變、上傳後及節點生成。

1. 各種元件支援的事件型別明細如下所示。

注：填報頁面下沒有標簽元件。

1. FineReport 元件只允許在填報和決策報表（包括參數介面）中使用，所以元件分為填報元件和決策報表元件，由於填報和決策報表的區別，元件事件的觸發時間有所區別，下面分別介紹。

2. 初始化後：決策報表的初始化事件是在元件載入結束後觸發，填報頁面中除了複選框元件、單選按鈕組元件、複選框組元件和查看樹元件是在元件載入結束時觸發初始化事件之外，其他元件均是在填報時，點選元件的編輯按鈕時（單擊儲存格時）觸發；初始化事件範例請查看 批次刪除。

3. 編輯前：元件進入編輯狀態時觸發。

4. 編輯後：元件編輯後觸發，如果編輯後事件中使用了 alert 提示，請改用 toast 提示，否則會影響中文的輸入；編輯後事件範例請查看 動態顯示參數元件。

5. 編輯結束：焦點離開元件時觸發；編輯結束事件範例請查看 給擴充套件儲存格置數。

6. 點選：下拉框、下拉複選框、下拉樹這三個元件的點選事件是在點選下拉項的時候觸發，其他元件是在點選元件的時候觸發；點選事件範例請查看 批量刪除。

7. 狀態改變：狀態改變事件是指元件的值發生改變時觸發，該事件只能適用於複選框、單選按鈕組和複選框組中。狀態改變事件範例請查看 點選單選按鈕彈出對話方塊輸入值。

注：填報中，儲存格元件設定了編輯結束事件，滑鼠焦點點進元件，不做任何改動，再點出元件，這時不會觸發編輯結束事件，但是在參數面板中的決策報表元件卻會觸發編輯結束事件，如果想要在填報儲存格元件的編輯結束事件實現與決策報表元件一樣的效果，不作任何改動，點出元件時，也觸發編輯結束事件，只需要為該元件新增一個初始化事件：

contentPane.setFireStopEditOnChange(false);

注：內建的提交無法在編輯結束後事件中使用，因為內建提交事件會觸發編輯結束後事件，編輯結束後事件會觸發提交事件，造成死迴圈。

1

查看樹。

1. 7.0.5 版本中刪除了查看樹的編輯前、編輯後、編輯結束事件，原來使用者如果設定了編輯後事件，會自動轉為點選事件。

2

檔案元件。

1. 7.0.5 版本中刪除了檔案元件的編輯前、編輯後、編輯結束事件，如果使用者設定了編輯後和編輯結束事件，會自動轉為上傳後事件。

1. 為某個元件事件新增 JS 指令碼，那麼怎麼透過 JS 指令碼引用元件，如何使用元件呢？元件都有什麼方法可用呢？詳細請查看引用元件及元件方法列表 。