Module
Contents
Index 🔎︎

# Formularios y filtru HTML

Pue usar tolos elementos de control y eventos de formulariu en documentu HTML. Esisten numberosos eventos a la fecha (por exemplu, eventos de focu), que nun camudaron. Siguirán esportándose ya importando como ONFOCUS, ONBLUR, y otros pa JavaScript y SDONFOCUS, SDONBLUR, y otros pa LibreOffice Basic.

Pal restu d'acontecimientos, empléguense nomes xenéricos compuestos pola interfaz d'oyente y el nome del métodu del acontecimientu: un acontecimientu que tea rexistráu como XListener::method espórtase como

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

Tenga en cuenta que Xlistener- y los componentes de métodu d'esta opción estremen ente mayúscules y minúscules.

La xestión d'acciones de controles llevar a cabu al traviés de la API de LibreOffice. Si asigna una aición a un campu de control, un oxetu rexístrase internamente como "Listener" ("oyente") pa una aición de control específica. Pa ello, l'oxetu tien d'utilizar una interfaz específica, como la interfaz XfocusListener, pa poder reaccionar a les acciones de focu. Cuando tien llugar l'aición, el campu de control llama a un métodu especial de la interfaz Listener cuando'l campu de control recibe'l focu. De siguío, l'oxetu rexistráu internamente llapada al códigu JavaScript o LibreOffice Basic asignáu a l'aición.

Agora, el filtru HTML utiliza específicamente estes interfaces d'oyente y nomes de métodu, de forma que pue importase y esportar acciones a voluntá. Pue rexistrar una aición de focu al traviés de

<input type=text onfocus="/* code */"

en llugar de por aciu el

<input type=text sdevent-xfocuslistener-focusgained="/* code */"

rexistru. Por ello, les acciones puen rexistrase como se quiera, tamién les ensin ufiertar polos cuadros de llista. Pa definir el llinguaxe de script de les acciones, escriba la llinia siguiente na testera del documentu:

<meta http-equiv="content-script-type" content="...">

Pa CONTENT pue utilizar, por exemplu, "text/x-StarBasic" en LibreOffice Basic o "text/JavaScript" en JavaScript. Si nun indica nada, la opción por defeutu ye JavaScript.

Mientres la esportación, el llinguaxe de script predetermináu va definir en función del primer módulu atopáu na xestión de macros. P'acciones, namái pue utilizase un llinguaxe por documentu.