summaryrefslogtreecommitdiffstats
path: root/helpcontent2/source/text/shared/02/01170700.xhp
blob: 5c988d37c942f43ee0ff9abeec351a9aec1b04c1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
<?xml version="1.0" encoding="UTF-8"?>



<!--
 * This file is part of the LibreOffice project.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * This file incorporates work covered by the following license notice:
 *
 *   Licensed to the Apache Software Foundation (ASF) under one or more
 *   contributor license agreements. See the NOTICE file distributed
 *   with this work for additional information regarding copyright
 *   ownership. The ASF licenses this file to you under the Apache
 *   License, Version 2.0 (the "License"); you may not use this file
 *   except in compliance with the License. You may obtain a copy of
 *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
 -->


		<helpdocument version="1.0">
<meta>
<topic id="textshared0201170700xml" indexer="include" status="PUBLISH">
<title id="tit" xml-lang="en-US">HTML Filters and Forms</title>
<filename>/text/shared/02/01170700.xhp</filename>
</topic>
</meta>
<body>
<bookmark xml-lang="en-US" branch="index" id="bm_id3163829"><bookmark_value>forms; HTML filters</bookmark_value>
</bookmark>
<paragraph role="heading" id="hd_id3163829" xml-lang="en-US" level="1">HTML Filters and Forms</paragraph>
<paragraph role="paragraph" id="par_id3147285" xml-lang="en-US">You can use all control elements and form events in HTML documents. There have been numerous events to date (for example, focus events), which have not been changed. They will continue to be imported and exported as ONFOCUS, ONBLUR, and so on for JavaScript and as SDONFOCUS, SDONBLUR, and so on for $[officename] Basic.</paragraph>
<paragraph role="paragraph" id="par_id3150616" xml-lang="en-US">Generic names that consist of the Listener interface and the method name of the event are used for all other events: An event registered as XListener::method is exported as</paragraph>
<paragraph role="paragraph" id="par_id3147571" xml-lang="en-US">SDEvent-XListener-method = "/* event-code */"</paragraph>
<paragraph role="paragraph" id="par_id3152425" xml-lang="en-US">Note that the XListener- and method components of this option are case sensitive.</paragraph>
<paragraph role="paragraph" id="par_id3153683" xml-lang="en-US">Event handling of controls is performed using the $[officename] API. If you assign an event to a control, an object registers itself internally as a "Listener" for a specific control event. To do this, the object must use a specific interface, for example the XFocusListener Interface, so that it can react to focus events. When the event occurs, the control then invokes a special method of the Listener interface when the control receives the focus. The internally registered object then invokes the JavaScript or $[officename] Basic code, which was assigned to the event.</paragraph>
<paragraph role="paragraph" id="par_id3156410" xml-lang="en-US">The HTML filter now uses precisely these listener interfaces and method names so that it can import and export events as desired. You can register a focus event through</paragraph>
<paragraph role="paragraph" id="par_id3150506" xml-lang="en-US">&lt;INPUT TYPE=text ONFOCUS="/* code */"</paragraph>
<paragraph role="paragraph" id="par_id3154289" xml-lang="en-US">rather than through the</paragraph>
<paragraph role="paragraph" id="par_id3155391" xml-lang="en-US">&lt;INPUT TYPE=text SDEvent-XFocusListener-focusGained="/* code */"</paragraph>
<paragraph role="paragraph" id="par_id3152996" xml-lang="en-US">register. Events can therefore be registered as desired, including those not offered in the list boxes. To define the script language of events, you can write the following line in the document header:</paragraph>
<paragraph role="paragraph" id="par_id3150443" xml-lang="en-US">&lt;META HTTP-EQUIV="content-script-type" CONTENT="..."&gt;</paragraph>
<paragraph role="paragraph" id="par_id3166410" xml-lang="en-US">As CONTENT you can, for example, use "text/x-StarBasic" for $[officename] Basic or a "text/JavaScript" for JavaScript. If no entry is made, JavaScript is assumed.</paragraph>
<paragraph role="paragraph" id="par_id3146797" xml-lang="en-US">During exporting, the default script language will be defined based on the first module found in macro management. For events, only one language can be used per document.</paragraph>
</body>
</helpdocument>