Module
Contents
Index 🔎︎

# HTML篩選器與表單

您可以在 HTML 文件中使用所有的控制項元素和表單事件。迄今為止，有很多事件 (例如焦點事件) 尚未變更。對於 JavaScript 而言，這些事件仍能以 ONFOCUS、ONBLUR 等匯入和匯出，而對於 LibreOffice Basic，則仍能以 SDONFOCUS、SDONBLUR 等匯入和匯出。

從事件的 Listener 界面和方式名稱所組成的名稱會用於所有其它事件：作為 XListener::method 登錄的事件會當作

SDEvent-XListener-method = "/* event-code */"

請注意，此選項的 XListener- 和方法元件都區分大小寫。

控制項的事件處理透過 LibreOffice API 來執行。如果您為控制項指定了事件，則物件會在內部將自己以特定控制項事件「偵聽者」的身份註冊。若要如此，該物件必須使用特定介面，例如 XFocusListener 介面，以便對焦點事件做出反應。當事件發生時，控制項會在獲得焦點時啟動偵聽者介面的特殊方法。然後，內部註冊的物件會呼叫指定到該事件的 JavaScript 或 LibreOffice Basic 程式碼。

此時，HTML 篩選會精確地使用這些偵聽者介面和方法名稱，依需要來匯入和匯出事件。在註冊焦點事件時，您可以透過

<INPUT TYPE=text ONFOCUS="/* code */"

而不是透過

<INPUT TYPE=text SDEvent-XFocusListener-focusGained="/* code */"

註冊。如此便可依需要來註冊事件 (其中包括清單方塊中未提供的事件) 了。若要定義事件的程式檔語言，請在文件頁首處寫入以下行：

<META HTTP-EQUIV="content-script-type" CONTENT="...">

針對 CONTENT，您可以另外使用 LibreOffice BASIC 的「text/x-StarBasic」或 JavaScript 的「text/JavaScript」。如果未加指定，則會由 JavaScript 輸出。

在匯出中，將依據在巨集管理中找到的第一個模組來定義預設程式檔語言。對於事件，每個文件僅能使用一種語言。