template::add_event_listener (public)
template::add_event_listener [ -event event ] [ -CSSclass CSSclass ] \ [ -id id ] [ -formfield formfield ] [ -selector selector ] \ [ -usecapture ] [ -preventdefault ] -script script
Defined in packages/acs-templating/tcl/head-procs.tcl
Register an event handler for elements. The affected elements can be specified in different ways, which will be checked in the following order of precedence: id, formfield, selector and CSSclass. Normally one needs to provide only one kind of specification.
- Switches:
- -event
(defaults to"click"
) (optional)- register handler for this type of event
- -CSSclass
(defaults to"acs-listen"
) (optional)- register handler for this CSS class
- -id
(optional)- register handler for this HTML ID
- -formfield
(optional)- register handler for this formfield, specified in a list of two elements in the form
{ form_id field_name }
- -selector
(optional)- register handler for elements identified by this CSS selector. When a CSS selector contains double and single quotes, we won't add any of those around the selector automatically. Instead, the user must specify them explicitly, for instance like this: ... -selector {'[name="o\'hara"]'}. If the selector does not contain any single or double quotes, we can let the user omit them, as for the case of a simple tag name selector: ... -selector "li". Quotes can also be omitted if the selector contains only one kind of them, like ... -selector {[data-property='value']} or ... -selector {[data-property="value"]}
- -usecapture
(boolean) (defaults to"false"
) (optional)- indicating whether event will be dispatched to the registered listener before being dispatched to any EventTarget beneath it in the DOM tree.
- -preventdefault
(boolean) (defaults to"true"
) (optional)- this option can the used prevent default click handling
- -script
(required)- Author:
- Gustaf Neumann
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- templates_and_scripts