tag

#tag.auto_keepfunction

How many tag.place_auto tags on each side of the live price get their line (default 2, 0-6), for the whole script.

tag.auto_keep(n: int)

Example

tag.auto_keep(3)

Since ChartScript 1

#tag.deletefunction

Removes the tag (na is ignored).

tag.delete(id: tag)

Example

state t = tag.new(open, "Open")
if (barstate.islast) {
    t.delete()
}

Since ChartScript 1

#tag.get_placefunction

The placement the script set (tag.place_*).

tag.get_place(id: tag): string

Returns string.

Example

state t = tag.new(open, "Open")
const p = t.get_place()

Since ChartScript 1

#tag.get_pricefunction

The price.

tag.get_price(id: tag): float

Returns float.

Example

state t = tag.new(open, "Open")
const p = t.get_price()

Since ChartScript 1

#tag.get_textfunction

The name.

tag.get_text(id: tag): string

Returns string.

Example

state t = tag.new(open, "Open")
const s = t.get_text()

Since ChartScript 1

#tag.newfunction

A level tag: the name in a filled tag inside the pane against the price axis and the price in the same colour on the axis, in one row with the other tags of the pane (pushed rows keep their price order). A tag off the visible prices is pinned at that edge. The member can change each titled tag's placement, line and colour in the Style tab, and switch all of a script's tags with "Level tags". 64 per script (32 on Beginner); the oldest is removed.

tag.new(price: float, text: string, { place?: string = tag.place_axis, color?: color = na, textcolor?: color = na, show_price?: bool = true, line_from?: int = na, line_to?: string = tag.line_to_tag, line_style?: string = line.style_solid, line_width?: int = 1, line_color?: color = na, tooltip?: string = "", title?: const string = "", size?: size = size.normal, xloc?: simple string = xloc.bar_index }): tag

Returns tag.

Example

state t = tag.new(open, "Day open", { color: color.orange, place: tag.place_chart, tooltip: "The first price of the run", title: "Day open" })

Since ChartScript 1

#tag.set_colorfunction

Sets the colour of the tags and the line.

tag.set_color(id: tag, color: color)

Example

state t = tag.new(open, "Open")
t.set_color(close > open ? color.up : color.down)

Since ChartScript 1

#tag.set_line_colorfunction

Sets the line colour.

tag.set_line_color(id: tag, line_color: color)

Example

state t = tag.new(open, "Open", { place: tag.place_chart })
t.set_line_color(color.gray)

Since ChartScript 1

#tag.set_line_fromfunction

Sets the bar the line starts at (na: the pane's left edge).

tag.set_line_from(id: tag, line_from: int, { xloc?: string = xloc.bar_index })

Example

state t = tag.new(open, "Open", { place: tag.place_chart })
t.set_line_from(bar_index - 20)

Since ChartScript 1

#tag.set_line_stylefunction

Sets the line style (line.style_* or dash.*).

tag.set_line_style(id: tag, line_style: string)

Example

state t = tag.new(open, "Open", { place: tag.place_chart })
t.set_line_style(line.style_dashed)

Since ChartScript 1

#tag.set_line_tofunction

Sets where the line ends (tag.line_to_*).

tag.set_line_to(id: tag, line_to: string)

Example

state t = tag.new(open, "Open", { place: tag.place_chart })
t.set_line_to(tag.line_to_bars)

Since ChartScript 1

#tag.set_line_widthfunction

Sets the line width (1-4 px).

tag.set_line_width(id: tag, line_width: int)

Example

state t = tag.new(open, "Open", { place: tag.place_chart })
t.set_line_width(2)

Since ChartScript 1

#tag.set_placefunction

Sets the placement (tag.place_*); tag.place_off hides the tag and keeps it.

tag.set_place(id: tag, place: string)

Example

state t = tag.new(open, "Open")
t.set_place(tag.place_auto)

Since ChartScript 1

#tag.set_pricefunction

Sets the price (na hides the tag; the same as set_y).

tag.set_price(id: tag, price: float)

Example

state t = tag.new(open, "High")
t.set_price(math.max(t.get_price(), high))

Since ChartScript 1

#tag.set_show_pricefunction

Shows or hides the price tag on the axis.

tag.set_show_price(id: tag, show_price: bool)

Example

state t = tag.new(open, "Open")
t.set_show_price(false)

Since ChartScript 1

#tag.set_textfunction

Sets the name.

tag.set_text(id: tag, text: string)

Example

state t = tag.new(open, "Open")
t.set_text("Open " + str.tostring(open))

Since ChartScript 1

#tag.set_textcolorfunction

Sets the text colour.

tag.set_textcolor(id: tag, textcolor: color)

Example

state t = tag.new(open, "Open")
t.set_textcolor(color.white)

Since ChartScript 1

#tag.set_tooltipfunction

Sets the hover text.

tag.set_tooltip(id: tag, tooltip: string)

Example

state t = tag.new(open, "Open")
t.set_tooltip("The first price of the run")

Since ChartScript 1

#tag.set_yfunction

Sets the price (na hides the tag).

tag.set_y(id: tag, price: float)

Example

state t = tag.new(open, "Last")
t.set_y(close)

Since ChartScript 1

#tag.allvariable

Every tag of the script that still exists, oldest first.

tag.all: array<tag>

Type series array<tag>.

Example

const n = array.size(tag.all)

Since ChartScript 1