RangeSelector

Type class

A base class for axis-specific range selectors.

Sources

This information about RangeSelector is provided for reference only and is not available through exported packages and thus should not be imported or used on its own.

Inheritance

RangeSelector extends Validatable.

RangeSelector is extended by DateAxisRangeSelector.

Properties

#axis

Type this["_axis"]

A target axis to use range selector for.

#classPrefix

Type stringDefault "amexport"

Class name prefix.

#container

Type $type.Optional <HTMLElement>

An HTML container to place the control in.

A container must be an HTML element, because the control itself is HTML, and cannot be placed into SVG.

#defaultStyles

Type booleanDefault true

Indicates whether RangeSelector should load external CSS to style itself.

If set to false, the elements will not be styled, and will rely on some external CSS.

#language

Type Language

A Language instance.

#position

Type "top" | "bottom" | "left" | "right"Default "left"

Position of the selector.

Available options: "top", "bottom", "left" (default), and "right".

NOTE: since the control is always placed in the external container, this setting does actually affect where the control is placed but rather default CSS that affects how specific elements are arranged.

For example, when setting position to "top" or "bottom", the control will be arranged in a horizontal fashion.

Similarly, for "left" and "right" the control will arrange itself vertically, which is more suitable for narrow containers.

#tabindex

Type number

A tab index for the menu.

Tab index will influence the order in which elements on the chart and the whole page are selected when pressing TAB key.

5 inherited items

#clonedFrom

Type $type.Optional <this>Inherited from BaseObject

Reference to the original object this object was cloned from. We need to keep this so we can disassociate it from source object when this object is disposed.

#config

Type objectInherited from BaseObject

Use this property to set JSON-based config. When set, triggers processing routine, which will go through all properties, and try to apply values, create instances, etc.

Use this with caution, as it is a time-consuming process. It's used for initialchart setup only, not routine operations.

#events

Type EventDispatcher <AMEvent <this, IBaseObjectEvents>>Inherited from BaseObjectEvents

An EventDispatcher instance

#id

Type $type.Optional <string>Inherited from BaseObject

Sets the user-defined id of the element.

#uid

Type stringInherited from BaseObject

Returns object's internal unique ID.

Methods

#constructor()

Returns RangeSelector

Constructor

#dispose()

Returns void

Destroys the control and all its elements.

6 inherited items

#clone(cloneId?: string)

Returns thisInherited from BaseObject

Makes a copy of this object and returns the clone. Try to avoid cloning complex objects like chart, create new instances if you need them.

#copyFrom(source: this)

Returns voidInherited from BaseObjectEvents

Copies all parameters from another Sprite.

#dispatch(eventType: Key,
data?: any)

Returns voidInherited from BaseObjectEvents

Dispatches an event using own event dispatcher. Will automatically populate event data object with event type and target (this element).

It also checks if there are any handlers registered for this sepecific event.

#dispatchImmediately(eventType: Key,
data?: any)

Returns voidInherited from BaseObjectEvents

Works like dispatch, except event is triggered immediately, without waiting for the next frame cycle.

#getCurrentThemes()

Returns ITheme[]Inherited from BaseObject

Returns a list of themes that should be applied to this element. It could either be a list of themes set explicitly on this element, or system-wide.

#isDisposed()

Returns booleanInherited from BaseObject

Returns if this object has been already been disposed.

Events

#drawn

Param { type: "drawn", target: RangeSelector }

Invoked when control is drawn.

#positionset

Param { type: "positionset", target: RangeSelector, position: "top" | "bottom" | "left" | "right", prevPosition: "top" | "bottom" | "left" | "right" }

Invoked when position of the control changes.