org.itsnat.core

Interface ItsNatNode

All Superinterfaces:

ItsNatUserData

public interface ItsNatNode
extends ItsNatUserData

Is an interface extending the standard org.w3c.dom.Node objects, for instance to introduce the concept of "internal/remote event mode".

Method Summary

Methods

Modifier and Type	Method and Description
ItsNatDocument	getItsNatDocument() Returns the ItsNat document object containing this DOM node.
boolean	isInternalMode() Returns the current mode of this node, internal or remote.
void	setInternalMode(boolean mode) Sets the current mode of this node, internal or remote.

Methods inherited from interface org.itsnat.core.ItsNatUserData

containsUserValueName, getUserValue, getUserValueNames, removeUserValue, setUserValue

Method Detail

isInternalMode

boolean isInternalMode()

Returns the current mode of this node, internal or remote.

If the internal mode is set to false:

• Any event listener registered/unregistered calling EventTarget.addEventListener(String,EventListener,boolean) or EventTarget.addEventListener(String,EventListener,boolean) is registered as a remote event listener forwarding this call to ItsNatDocument.addEventListener(EventTarget,String,EventListener,boolean), otherwise the event listener is registered internally.
• Events created with DocumentEvent.createEvent(String) are remote events otherwise the event is an internal event of Batik. When a remote event is submitted as parameter to EventTarget.dispatchEvent(Event) this call is redirected to ItsNatDocument.dispatchEvent(EventTarget,Event), otherwise the event is dispatched by the internal event listeners registered. The method EventTarget.dispatchEvent(Event) does not depend on isInternalMode(), it only depends on the event type (remote or internal).
• Methods like HTMLInputElement.focus() generates the appropriated JavaScript to execute this action in the client. Otherwise do nothing.

Unless explicitly defined, the default value is the event mode defined in the Document (this object implements ItsNatNode too), false by default.

In ItsNat the internal event listener registry is almost only useful to monitor DOM changes with mutation event listeners. In this case change to true calling setInternalMode(boolean) before registering an event listener for mutation events, then restore the original mode.

Returns:

true if the current event mode is internal otherwise is remote. False by default.

See Also:

setInternalMode(boolean)

setInternalMode

void setInternalMode(boolean mode)

Sets the current mode of this node, internal or remote.

Parameters:

mode - if true the mode of this node is internal otherwise is remote.

See Also:

isInternalMode()

getItsNatDocument

ItsNatDocument getItsNatDocument()

Returns the ItsNat document object containing this DOM node.

Returns:

the ItsNat document associated.