Skip to content

IComparisonControlSettings

Type interface

Sources

IComparisonControlSettings is an interface: it describes a shape of data and is not imported on its own.

Inheritance

IComparisonControlSettings extends IDropdownListControlSettings.

IComparisonControlSettings is not extended by any other symbol.

Properties

items

Type Array

25 inherited items
active

Type undefined | false | trueDefault falseInherited from IStockControlSettings

Turns the control on; its button shows as active.

align

Type "left" | "right"Default "left"Inherited from IStockControlSettings

Side of the toolbar the control is placed on.

animations

Type ArrayInherited from IEntitySettingsSince 5.20.8

Animations the element plays on its own, described as data - so they can be set from a JSON config and saved with it.

Each one animates a setting of the element (or, with target: "dataItem", a value of its data item - a map point's positionOnLine, say). They start when the setting is applied, restart when it changes, and stop when the element is disposed. A saved config keeps what was configured, never a value caught half way through an animation.

sprite.set("animations", [
  { key: "rotation", to: 360, duration: 4000, loops: 0 },
  { key: "scale", from: 1, to: 1.3, duration: 800, loops: 0, yoyo: true, easing: "sine" }
]);
currentItem

Type string | IDropdownListItemInherited from IDropdownListControlSettings

Item (or its ID) shown as selected when the control is created. It is not updated when another item is picked.

description

Type undefined | stringInherited from IStockControlSettings

What the control does, shown as the button's tooltip. Falls back to name.

exclude

Type string[]Inherited from IDropdownListControlSettingsSince 5.7.0

IDs of items to leave out of the list.

fixedLabel

Type undefined | false | trueInherited from IDropdownListControlSettings

Keeps the button's label and icon when an item is picked, instead of showing that item.

forceHidden

Type undefined | false | trueDefault falseInherited from IStockControlSettingsSince 5.8.5

Keeps the control hidden, even when show() is called.

icon

Type HTMLElement | SVGElement | "none"Inherited from IStockControlSettings

Icon element of the button, or "none" for no icon. Each control has its own default icon.

id

Type undefined | stringInherited from IEntitySettings

A unique ID for looking the element up in root.entitiesById. Setting an ID that another element already has throws an error.

ignoreThemes

Type undefined | false | trueDefault falseInherited from IEntitySettingsSince 5.15.6

Ignores themes: no theme rule applies to the element, not even one of the default theme.

maxSearchItems

Type undefined | numberInherited from IDropdownListControlSettings

Most results of searchCallback to show; the rest are cut off with a note.

name

Type undefined | stringInherited from IStockControlSettings

Label text of the control's button.

scrollable

Type undefined | false | trueInherited from IDropdownListControlSettings

Limits the list's height to the chart's height minus 100 pixels, scrolling the rest.

searchable

Type undefined | false | trueInherited from IDropdownListControlSettings

Shows a search field above the list. Typing filters the items or, with searchCallback, replaces them with its results.

searchCallback

Type undefined | (query: string) => IDropdownListItem[]Inherited from IDropdownListControlSettings

Returns the items to show for a search query.

stateAnimationDuration

Type undefined | numberDefault 0Inherited from IEntitySettings

How long, in milliseconds, a switch from one state to another animates.

0 switches at once.

stateAnimationEasing

Type $ease.EasingDefault out(cubic)Inherited from IEntitySettings

Easing of the animated switch from one state to another.

stockChart

Type StockChartInherited from IStockControlSettings

The StockChart the control acts on.

themes

Type ArrayInherited from IEntitySettings

Themes applied to the element and everything inside it.

themeTags

Type ArrayInherited from IEntitySettings

Tags that theme rules can target. They also count for the element's children, so a rule can match a child by a tag of its parent.

More info: Themes

themeTagsSelf

Type ArrayInherited from IEntitySettings

Tags that theme rules can target, like themeTags, but only for this element, not its children.

More info: Themes

togglable

Type undefined | false | trueDefault trueInherited from IStockControlSettings

A click on the button toggles active.

userData

Type anyInherited from IEntitySettings

Any data of your own to keep with the element.

visible

Type undefined | false | trueDefault trueInherited from IStockControlSettings

Shows the control's button; false hides it.