API / geotoolkit / controls / tools / DOMSupport / DOMSupport
tools.DOMSupport.DOMSupport
DOMSupport tool is created on a plot (unique), makes one-time selection and if necessarily fires Events (hover/leave/enter/click/etc.)
↳
DOMSupport
Constructors
Methods
Css Properties
| Name | Type | Description |
|---|---|---|
autodisabled | boolean | True if selection automatically disabled on selection changed |
circularmode | CircularMode | Tool circular selection mode |
enabled | boolean | Enabled state |
fillstyle | string | Rubber band selection fillstyle |
fillstyle | FillStyle | Rubber band selection fillstyle |
fillstyle-color | string | Color in CSS form |
fillstyle-evenoddmode | boolean | Even-odd fill mode |
fillstyle-fillpattern | Pattern | Pattern |
fillstyle-fillpattern-containername | string | An optional container name, which creates an image pattern. This parameter is used for serialization if you want to save are reference to pattern instead of the pattern itself |
fillstyle-fillpattern-patternname | string | Name of this pattern for indexing |
fillstyle-fillpattern-scalable | boolean | Flag that sets scalability of the pattern coordinates, or relative to the shape it is filling (It is not supported) |
fillstyle-foreground | string | Foreground color |
fillstyle-pattern | Pattern | Pattern |
layer | CompositeNode | Manipulator layer |
layer-clipping | boolean | Enable clipping, this does not consider the clipstyle, it is related to bounds-clipping |
layer-clipstyle | ClipStyle | Clipping style |
layer-clipstyle-evenodd | boolean | True if evenodd mode is on ('nonzero' mode otherwise) |
layer-clipstyle-geometry | GraphicsPath | Clipping geometry |
layer-clipstyle-geometry-bounds | Rect | Bounds |
layer-clipstyle-geometry-bounds-height | number | Height |
layer-clipstyle-geometry-bounds-readonly | boolean | Readonly |
layer-clipstyle-geometry-bounds-width | number | Width |
layer-clipstyle-geometry-bounds-x | number | Left |
layer-clipstyle-geometry-bounds-y | number | Top |
layer-clipstyle | GraphicsPath | Clipping style |
layer-cssclass | string | The css class name of this node |
layer-csscursor | string | CSS cursor associated with node |
layer-cssstyle | string | CSS style to be applied to inserted elements |
layer-id | string | number | Id of the node, its a unique identifier |
layer-infinity | boolean | Mode to render outside the model limits |
layer-localtransform | Transformation | Local transformation |
layer-localtransform-dx | number | X axis translation |
layer-localtransform-dy | number | Y axis translation |
layer-localtransform-xx | number | X scale |
layer-localtransform-xy | number | Xy skew |
layer-localtransform-yx | number | Yx skew |
layer-localtransform-yy | number | Y scale |
layer-margins | number | string | It has properties for specifying the margins for each side |
layer-name | string | Name of the node. It is often used for debugging purposes or to simplify queries |
layer-opacity | number | Node opacity (from 0 to 1). If it is undefined or null it inherits property from the parent. It changes globalAlpha on the rendering context |
layer-opacityblendmode | BlendMode | Node opacity mode to blend it |
layer-scalescrollstrategy | ScaleScrollStrategy | Scale scroll strategy |
layer-scalescrollstrategy-enabled | boolean | Enable flag |
layer-selectable | boolean | Selectable node, a boolean to determine if selection should consider this node |
layer-tag | any | Custom information associated with node. It is a user object which can be used by client code to store information or attach an application object to the shape |
layer-transform | string | Additional CSS transformation applied to node or 'none' |
layer-transform | Transformation | Additional CSS transformation applied to node or 'none' |
layer-visible | boolean | Visibility of the node, a boolean to determine if the node should be rendered or not |
layer-z-index | number | Define node z-index |
linestyle | string | Rubber band selection linestyle |
linestyle | LineStyle | Rubber band selection linestyle |
linestyle-color | string | Color in CSS form |
linestyle-fill | string | Optional fill style to be used to fill lines generated with this style |
linestyle-fill | FillStyle | Optional fill style to be used to fill lines generated with this style |
linestyle-linecap | CapStyle | The line cap style |
linestyle-linedashoffset | number | Line dash offset of dashed line |
linestyle-linejoin | JoinStyle | The line join style |
linestyle-pixelsnapmode | boolean | Pixel Snap Mode, default( |
linestyle-scalable | boolean | True if width should depend on transformation |
linestyle-unit | string | Optional unit for the width |
linestyle-width | number | string | The line thickness |
mode | RubberBandRenderMode | Rubber mode |
mode | SelectionMode | Selection mode |
mouseradius | number | Device radius for mouse events |
name | string | Name of the tool used like cross-hair etc |
pointermode | PointerMode | Tool pointer selection mode |
rootnode | Node | A root node to start selection |
rootnode-cssclass | string | The css class name of this node |
rootnode-id | string | number | Id of the node, its a unique identifier |
rootnode-name | string | Name of the node. It is often used for debugging purposes or to simplify queries |
rootnode-selectable | boolean | Selectable node, a boolean to determine if selection should consider this node |
rootnode-tag | any | Custom information associated with node. It is a user object which can be used by client code to store information or attach an application object to the shape |
rootnode-visible | boolean | Visibility of the node, a boolean to determine if the node should be rendered or not |
rootnode-z-index | number | Define node z-index |
rubberbandmode | RubberBandMode | Tool rubberband selection mode |
rubberbandshapemode | RubberBandShapeMode | Shape mode for the rubberband selection area |
selectionmode | SelectionMode | Selection mode |
textstyle | string | Rubber band selection distance textstyle |
textstyle | TextStyle | Rubber band selection distance textstyle |
textstyle-alignment | AlignmentStyle | Alignment |
textstyle-autosize | boolean | Auto font size on high definition display |
textstyle-background | string | Background style |
textstyle-background | FillStyle | Background style |
textstyle-baseline | BaseLineStyle | Base line |
textstyle-color | string | Color in CSS form |
textstyle-fill | FillStyle | Text fill style |
textstyle-font | string | Font see |
textstyle-fonturl | string | The place from which the font will be loaded, if null - uses system fonts. It can be base64 with url keyword |
textstyle-lineheight | string | number | Line height |
textstyle-multiline | boolean | Allow multi-line text |
textstyle-outline | string | Outline style |
textstyle-outline | LineStyle | Outline style |
textstyle-overflowwrap | OverflowWrapStyle | Overflow wrap |
textstyle-strikethrough | string | Strikethrough style |
textstyle-strikethrough | LineStyle | Strikethrough style |
textstyle-textoverflow | TextOverflowStyle | Text overflow |
textstyle-underline | string | Underline style |
textstyle-underline | LineStyle | Underline style |
textstyle-underlineoffset | string | number | Underline offset distance |
textstyle-whitespace | WhiteSpaceStyle | White space |
textstyle-wordbreak | WordBreakStyle | Word break |
touchradius | number | Device radius for touch events |
Methods
▸ addListener(eventName, listener): DOMSupport
add event listener. The listener receives the message when the system event happens.
Deprecated
since 4.0 use .on() instead. Note that 3 args callback should be used in subscription via .on(): (eventType, source, args)
| Name | Type | Description |
|---|---|---|
eventName | string | event name or unique event identifier |
listener | Function | the event listener |
▸ captureMouseUp(): void
listen to window mouse events in order to catch a mouse up action outside of the tool container DOM element. useful for example when you pan and release click outside of DOM element.
void
▸ dispose(): void
Dispose tool.
void
▸ fireEvent(eventName, eventArgs?): void
This method is Protected. Fire an Event.
Deprecated
since 4.0 use .notify() instead. Note that 3 args callback should be used in subscription via .on()
| Name | Type | Description |
|---|---|---|
eventName | string | event name |
Optional eventArgs | any | contains info of the event |
void
▸ getCircularMode(): CircularMode
Gets tool's circular selection mode
▸ getClassName(): string
string
▸ Protected getContainerModelLimits(): Rect
Return container model limits in which rubber band is drawn. By default it returns manipulator layer visible model limits
area of model limits
Selection.getContainerModelLimits
▸ getDblClickMouseButtons(): MouseButtons
Gets mouse buttons set for double click
this
▸ getEndPoint(): Point
Return end point of selection
▸ Protected getEventRadius(eventArgs): number
Returns device radius for the provided event
| Name | Type | Description |
|---|---|---|
eventArgs | EventArgs | contains info of the event |
number
▸ getFillStyle(): FillStyle
Returns fill style
fill style
▸ getLineStyle(): LineStyle
Returns line style
line style
▸ getManipulatorLayer(): CompositeNode<Node>
return manipulator layer
layer
▸ getMouseButtons(): MouseButtons
Gets mouse buttons set for selection
this
▸ getMouseRadius(): number
Returns current device radius for mouse events
number
▸ getName(): string
return tool name if any
string
name of the tool
▸ getNodeFilter(): NodeFilterCallback
Returns filter handler
filter
▸ getParentTool(): AbstractCompositeTool
Gets parent tool
parent tool
▸ getPointerMode(): PointerMode
Gets tool pointer selection mode
▸ getProperties(): OptionsOut
Returns properties
properties
▸ getProperty(name): any
Gets dynamic property by name. These properties can be used as a property bags
| Name | Type | Description |
|---|---|---|
name | string | property name |
any
▸ getPropertyKeys(): string[]
Returns known properties keys
string[]
▸ getRoot(): AbstractCompositeTool
Gets root tool
parent tool
▸ getRootNode(): Node
Return the root node to start selection. If it is not specified then root node is used
root node
▸ getRubberBandMode(): RubberBandMode
Gets tool's rubberband selection mode
▸ getRubberBandRenderMode(): RubberBandRenderMode
Return the way the rectangle is displayed
Selection.getRubberBandRenderMode
▸ getRubberBandShapeMode(): RubberBandShapeMode
Gets tool's rubberband shape
Selection.getRubberBandShapeMode
▸ getSelection(): (Node | SelectedItem<any>)[]
gets the currently selected items
(Node | SelectedItem<any>)[]
▸ getSelectionMode(): SelectionMode
Returns tool selection mode
▸ getStartPoint(): Point
Return start point of selection
▸ getTextStyle(): TextStyle
Returns text style
text style
▸ getTouchRadius(): number
Returns current device radius for touch events
number
▸ hasEventListener(type, callback?): boolean
Check if a list of event listeners for this type contains this listener
| Name | Type | Description |
|---|---|---|
type | string | type of event or property |
Optional callback | Function | to be called, if null, check if any callback is registered |
boolean
▸ isActive(): boolean
return active state
boolean
▸ isAutoDisabled(): boolean
Get auto-disabled mode
boolean
does the selection automatically disable itself on selection changed
▸ isDisposed(): boolean
Returns whether this object has been disposed
boolean
▸ Protected isDoubleClick(point, eventArgs?): boolean
returns true if double clicked
| Name | Type | Description |
|---|---|---|
point | Point | Click point |
Optional eventArgs | EventArgs | optional event args to verify double click |
boolean
▸ isEnabled(): boolean
returns enable state
boolean
state
▸ isSilent(): boolean
Return true if the event dispatcher doesn't notify any events
boolean
▸ isTouchEvent(eventArgs): boolean
return true if the event is a touch event and false otherwise.
| Name | Type | Description |
|---|---|---|
eventArgs | Event | EventArgs | contains info of the event |
boolean
▸ notify<E>(type, source, args?): DOMSupport
Notify listeners
| Name | Type |
|---|---|
E | extends string |
| Name | Type | Description |
|---|---|---|
type | E | event types |
source | Selection | of the event |
Optional args | EventMap[E] | arguments of the event |
this
▸ off<E>(type?, callback?): DOMSupport
Detach listener on event. Calling .off() with no arguments removes all attached listeners. Calling .off(type) with no callback removes all attached listeners for specific type.
| Name | Type |
|---|---|
E | extends string |
| Name | Type | Description |
|---|---|---|
Optional type | E | type of the event |
Optional callback | (eventType: E, sender: DOMSupport, args: EventMap[E]) => void | function to be called |
this
▸ on<E>(type, callback): DOMSupport
Attach listener on event that will be called whenever the specified event is delivered to the target
If the callback function is already in the list of event listeners for this target, the function is not added a second time.
If a particular anonymous function is in the list of event listeners registered for a certain target, and then later in the code, an identical anonymous function is given in an "on" call, the second function will also be added to the list of event listeners for that target.
TypeScript hint: in case of creating derived tool with own events, EventMap should be extended and .on() and .notify() methods redeclared, see sample.Example
// Using in derived tool
import type {EventMap as EventMapBase} from '@int/geotoolkit/controls/tools/AbstractTool';
export type EventMap = EventMapBase & {
[MyToolEvents.onValueChanged]: MyToolEventArgs
}
export enum MyToolEvents {
onValueChanged = 'onValueChanged'
}
export class MyTool extends AbstractTool {
public declare on: <E extends keyof EventMap>(type: E, callback: (eventType: E, sender: this, args: EventMap[E]) => void) => this;
protected declare notify: <E extends keyof EventMap>(type: E, source: AbstractTool, args?: EventMap[E]) => this;
public declare off: <E extends keyof EventMap>(type: E, callback?: (eventType: E, sender: this, args: EventMap[E]) => void) => this;
// ...
}| Name | Type |
|---|---|
E | extends string |
| Name | Type | Description |
|---|---|---|
type | E | type of event or property |
callback | (eventType: E, sender: DOMSupport, args: EventMap[E]) => void | to be called |
▸ Protected onActiveStateChanged(): void
Fires
void
Selection.onActiveStateChanged
▸ Protected onContextMenu(eventArgs): void
on context-menu handler
| Name | Type | Description |
|---|---|---|
eventArgs | EventArgs | contains info about the event arguments |
void
▸ Protected onDoubleClick(eventArgs): void
Double click handler Detects if double click happens on scrollbar and prevents propagation
| Name | Type | Description |
|---|---|---|
eventArgs | EventArgs | event arguments |
void
▸ Protected onEnabledStateChanged(): void
Fires
void
Selection.onEnabledStateChanged
▸ Protected onMouseDown(eventArgs): void
mouse down function of selection tool
| Name | Type | Description |
|---|---|---|
eventArgs | EventArgs | contains info about the event arguments |
void
▸ Protected onMouseMove(eventArgs): void
mouse move function
| Name | Type | Description |
|---|---|---|
eventArgs | EventArgs | contains info about the event arguments |
void
▸ Protected onMouseUp(eventArgs): void
mouse up function of selection tool
| Name | Type | Description |
|---|---|---|
eventArgs | EventArgs | contains info about the event arguments |
void
▸ pageToCanvas(eventArgs, externalPlot?): Object
return position relative to the canvas
| Name | Type | Description |
|---|---|---|
eventArgs | Event | EventArgs | parentElement the parent HTML element |
Optional externalPlot | Plot | plot |
Object
| Name | Type |
|---|---|
x | number |
y | number |
▸ pointToModel(model, eventArgs): Point
converts device coordinates to inner coordinates of node
| Name | Type | Description |
|---|---|---|
model | Node | the model |
eventArgs | Point | EventArgs | arguments of the event OR point in device (plot) coordinates. |
▸ removeListener(eventName, listener?): DOMSupport
remove event listener. The listener reveives the message when the system event happens.
Deprecated
since 4.0 use .off() instead.
| Name | Type | Description |
|---|---|---|
eventName | string | event name |
Optional listener | Function | Function[] | the event listener, if null, remove all listeners for the event |
▸ setActive(active): DOMSupport
set active state
Fires
| Name | Type | Description |
|---|---|---|
active | boolean | set active state |
▸ setAutoDisabled(mode): DOMSupport
Set auto-disabled mode
| Name | Type | Description |
|---|---|---|
mode | boolean | does the selection automatically disable itself on selection changed |
this
▸ setCircularMode(mode): DOMSupport
Sets tool's circular selection mode
| Name | Type | Description |
|---|---|---|
mode | CircularMode | new circular selection mode |
this
▸ setDblClickMouseButtons(button): DOMSupport
Sets mouse buttons for double click
| Name | Type | Description |
|---|---|---|
button | MouseButtons | mouse button |
this
▸ setEnabled(enabled): DOMSupport
set enable state
Fires
Fires
| Name | Type | Description |
|---|---|---|
enabled | boolean | sets the enabled state |
this
▸ setFillStyle(fillStyle, merge?): DOMSupport
Sets fill style
| Name | Type | Description |
|---|---|---|
fillStyle | Type | a new fill style |
Optional merge | boolean | true if you want to merge fillStyle with existing attribute, false by default |
this this
▸ setLineStyle(lineStyle, merge?): DOMSupport
Sets line style
| Name | Type | Description |
|---|---|---|
lineStyle | Type | line style or options |
Optional merge | boolean | true if you want to merge lineStyle with existing attribute, false by default |
this
▸ setMeasureCallback(measureCallback): DOMSupport
Sets measure callback
| Name | Type | Description |
|---|---|---|
measureCallback | MeasureCallback | measure callback |
▸ setMouseButtons(button): DOMSupport
Sets mouse buttons for selection
| Name | Type | Description |
|---|---|---|
button | MouseButtons | mouse button |
this
▸ setMouseRadius(radius): DOMSupport
Sets device radius for mouse events
| Name | Type | Description |
|---|---|---|
radius | number | radius for mouse events |
this
▸ setName(name): DOMSupport
set tool name
| Name | Type | Description |
|---|---|---|
name | string | the tool name |
▸ setNodeFilter(filter): DOMSupport
Sets filter handler
| Name | Type | Description |
|---|---|---|
filter | NodeFilterCallback | This allows to filter selected nodes. |
▸ setOptions(options?): DOMSupport
Sets selection options
| Name | Type | Description |
|---|---|---|
Optional options | Options | options |
this
▸ setPointerMode(mode): DOMSupport
Sets tool pointer selection mode
| Name | Type | Description |
|---|---|---|
mode | PointerMode | tool pointer selection mode |
this
▸ setProperties(properties): DOMSupport
Sets all the properties pertaining to this object
| Name | Type | Description |
|---|---|---|
properties | Options | An object containing the properties to set |
this
▸ setProperty(name, value): DOMSupport
Sets dynamic property by name
| Name | Type | Description |
|---|---|---|
name | string | property name |
value | any | property value |
this
▸ setRootNode(root): DOMSupport
Specify a root node to start selection. If it is not specified then root node is used
| Name | Type | Description |
|---|---|---|
root | Node | root node |
this
▸ setRubberBandMode(mode): DOMSupport
Sets tool rubberband selection mode
| Name | Type | Description |
|---|---|---|
mode | RubberBandMode | tool rubberband selection mode |
this
▸ setRubberBandRenderMode(mode): DOMSupport
Set the way the rectangle has to be displayed
| Name | Type | Description |
|---|---|---|
mode | RubberBandRenderMode | the way the rectangle has to be displayed |
Selection.setRubberBandRenderMode
▸ setRubberBandShapeMode(mode): DOMSupport
Sets tool's rubberband shape mode
| Name | Type | Description |
|---|---|---|
mode | RubberBandShapeMode | shape mode for the rubberband selection area |
this
Selection.setRubberBandShapeMode
▸ setSelection(selection): DOMSupport
sets the currently selected items
| Name | Type | Description |
|---|---|---|
selection | (Node | SelectedItem<any>)[] | selection |
this
▸ setSelectionMode(mode): DOMSupport
Sets tool selection mode
| Name | Type | Description |
|---|---|---|
mode | SelectionMode | tool selection mode |
this
▸ setSelectorCallback(selectorCallback): DOMSupport
Sets selector callback
| Name | Type | Description |
|---|---|---|
selectorCallback | SelectorCallback | selector callback |
▸ setSilent(bool): DOMSupport
Set silent mode
| Name | Type | Description |
|---|---|---|
bool | boolean | flag to enable silent mode |
this
▸ setSlotEnabled(eventName, value, target?): DOMSupport
Sets slot enabled
| Name | Type | Description |
|---|---|---|
eventName | string | eventName |
value | boolean | value |
Optional target | EventTarget | target |
▸ setSlots(slots?, merge?): DOMSupport
Sets new slots.
Example
const slots = {
'pointerdown': (event: EventArgs) => {
// event is an instance of @int/geotoolkit/controls/tools/EventArgs
...
}
};
tool.setSlots(slots);| Name | Type | Description |
|---|---|---|
Optional slots | Record<string, Slot | Slot[] | (eventArgs: EventArgs) => void> | type of system events |
Optional merge | boolean | set to true if you want to merge with existing slots |
this
▸ setTextStyle(textStyle, merge?): DOMSupport
Sets measurement label text style
| Name | Type | Description |
|---|---|---|
textStyle | Type | a new shape text style |
Optional merge | boolean | true if you want to merge textStyle with existing attribute, false by default |
this
▸ setTouchRadius(radius): DOMSupport
Sets device radius for touch events
| Name | Type | Description |
|---|---|---|
radius | number | radius for touch events |
this
▸ Protected start(eventArgs?): DOMSupport
start
| Name | Type | Description |
|---|---|---|
Optional eventArgs | EventArgs | event args |
▸ Protected stop(): DOMSupport
stop
▸ toggle(): DOMSupport
switch enable state to opposite state
▸ Static canvasToClient(plotPoint, plot): Point
Convert plot coordinates to global coordinates
▸ Static clientToCanvas(nativeEvent, plot): Point
Convert global coordinates to plot coordinates
| Name | Type | Description |
|---|---|---|
nativeEvent | Event | native browser event |
plot | Plot | plot with canvas |
▸ Static getClassName(): string
string
▸ Static getExclusiveTool(plot): AbstractTool
return exclusive tool associated with plot
| Name | Type | Description |
|---|---|---|
plot | Plot | plot |
tool
▸ Static getNativeEventName(eventName): string[]
Returns native event name
| Name | Type | Description |
|---|---|---|
eventName | string | W3C Pointer Events Recommendation name |
string[]
▸ Static isTouchEvent(eventArgs): eventArgs is TouchEvent
return true if the event is a touch event and false otherwise.
| Name | Type | Description |
|---|---|---|
eventArgs | Event | EventArgs | contains info of the event |
eventArgs is TouchEvent
▸ Static lock(plot, tool): void
Set exclusive tool for plot
| Name | Type | Description |
|---|---|---|
plot | Plot | plot |
tool | AbstractTool | tool |
void
▸ Static setDefaultMouseRadius(radius): void
Sets default device radius for mouse events
| Name | Type | Description |
|---|---|---|
radius | number | radius for mouse events |
void
Selection.setDefaultMouseRadius
▸ Static setDefaultTouchRadius(radius): void
Sets default device radius for touch events
| Name | Type | Description |
|---|---|---|
radius | number | radius for touch events |
void
Selection.setDefaultTouchRadius
▸ Static unlock(value): void
Remove exclusive tool from plot
| Name | Type | Description |
|---|---|---|
value | AbstractTool | Plot | value |
void