API Reference
Namespaces
Classes
Events
Global
Externals

Class: PinnedTooltip

CIQ.Marker. PinnedTooltip


new PinnedTooltip(params)

Pinned tooltip HTML marker class. Do not call this constructor directly. Instead, use the CIQ.Marker.PinnedTooltip.create function to call this.

Requires "js/extras/pinnedMarkers.js", which is included in the ChartIQ Extras Package.

Parameters:
Name Type Description
params Object

Parameters to describe the marker

Version:
  • ChartIQ Extras Package
Since:
  • 9.1.0

Members


<static> enable :boolean|Object

Controls whether the tooltip can be pinned. Use an object to enable pinned tooltips based on plot type (series or study). Use a boolean to enable them unconditionally. (See examples.)

NOTE: currently only series plot is supported.

Requires "js/extras/pinnedMarkers.js"

Type:
  • boolean | Object
Version:
  • ChartIQ Extras Package
Since:
  • 9.1.2

Examples

Universally allowed

CIQ.Marker.PinnedTooltip.enable = true;

Universally disallowed

CIQ.Marker.PinnedTooltip.enable = false;

Allowed for series plots only

CIQ.Marker.PinnedTooltip.enable = {
	series: true
};

<static> includeAllSeries :boolean

Controls whether the other series appearing on the panel, besides the one clicked on, are included in the tooltip.

Requires "js/extras/pinnedMarkers.js"

Type:
  • boolean
Version:
  • ChartIQ Extras Package
Since:
  • 9.1.0


<static> layout :string

Layout of tooltip.

  • columns: Each series appears in a column on the tooltip, with the fields appearing one per row.
  • rows: Each field appears as a column on the tooltip, with the series appearing one per row.

Requires "js/extras/pinnedMarkers.js"

Type:
  • string
Version:
  • ChartIQ Extras Package
Since:
  • 9.1.0

Examples

Columns

|-----------------------------|
|          IBM     GE    MSFT |
| Close      3      4       5 |
| Open       4      5       6 |
| High       6      7       8 |
| Low        1      2       3 |
|-----------------------------|

Rows

|------------------------------------|
|        Close   Open    High    Low |
| IBM        3      4       6      1 |
| GE         4      5       7      2 |
| MSFT       5      6       8      3 |
|------------------------------------|

Methods


<static> create(params)

Creates a tooltip in the form of a marker when a tap occurs on a plot which is highlighted. The tooltip can contain all the data relevant to the curve (Close, Open, High, Low) and persists in session storage. It will contain data for all series found on the panel.

Requires "js/extras/pinnedMarkers.js"

Parameters:
Name Type Description
params Object
Properties
Name Type Argument Description
stx CIQ.ChartEngine

Chart engine instance.

field string <optional>

Plot field name. This is the id of the series the marker is attached to. Leave blank for main series.

record Object

Data segment record for the marker's position.

panel CIQ.ChartEngine.Panel <optional>

Panel on which marker is found. Defaults to chart panel.

x Date

Date where marker is to be oriented.

y number

Value where marker is to be oriented.

candleOffset number <optional>

Multiple of candles left or right of the x value

Version:
  • ChartIQ Extras Package
Since:
  • 9.1.0

Returns:

Tooltip marker if created, otherwise undefined

Type
CIQ.Marker.PinnedTooltip