Get started
PINE LIBRARY

LabelHelper

By Electrified
Updated
Library "LabelHelper"
Utility for managing active labels on the chart.

add(level, txt, labelColor, textColor) For displaying a lable at the last bar.
  Parameters:
    level: The value to display the label at.
    txt: The text to show on the label.
    labelColor: The color of the label.
    textColor: The text color of the label.
  Returns: The label being managed.
Release Notes
v2 comment fixes
Release Notes
v3 Added tooltip option.

Updated:
add(level, txt, labelColor, textColor, tooltip) For displaying a label at the last bar.
  Parameters:
    level: The value to display the label at.
    txt: The text to show on the label.
    labelColor: The color of the label.
    textColor: The text color of the label.
    tooltip: The optional tooltip of the label.
  Returns: The label being managed.
Release Notes
v4 fixed issue with empty tootip
Release Notes
v5 Avoiding na value for tooltip.
Release Notes
v6 Added allowance for a bar offset.

Updated:
add(level, txt, labelColor, textColor, offset, tooltip) For displaying a label at the last bar.
  Parameters:
    level: The value to display the label at.
    txt: The text to show on the label.
    labelColor: The color of the label.
    textColor: The text color of the label.
    offset: A positive value will push label to the right and a negative to the left.
    tooltip: The optional tooltip of the label.
  Returns: The label being managed.
Release Notes
v7 Much improved API with higher reliability and flexibility.

Added:
refreshXPos(lbl, offset) Refreshes the x position of label.
  Parameters:
    lbl: The label to update.
    offset: A positive value will push label one bar to the right and a negative value to the left.
  Returns: The time value that was used.

create(level, txt, labelColor, textColor, size, textAlign, offset, tooltip) For creating a label at the last bar.
  Parameters:
    level: The value to display the label at.
    txt: The text to show on the label.
    labelColor: The background color of the label.
    textColor: The text color of the label.
    size: The size of the text. Default is large.
    textAlign: The alignment of the text. Default is left.
    offset: A positive value will push label to the right and a negative to the left.
    tooltip: The optional tooltip of the label.
  Returns: The label that was created.

Updated:
add(level, txt, labelColor, textColor, size, textAlign, offset, tooltip) For displaying a label at the last bar.
  Parameters:
    level: The value to display the label at.
    txt: The text to show on the label.
    labelColor: The background color of the label.
    textColor: The text color of the label.
    size: The size of the text. Default is large.
    textAlign: The alignment of the text. Default is left.
    offset: A positive value will push label to the right and a negative to the left.
    tooltip: The optional tooltip of the label.
  Returns: The label being managed.
Release Notes
v8 Deprecated .add(…) in favor of .manage(…): allows for tracking reference to a label outside the function.
.add(…) could leave a hanging label especially when values changed.

Added:
manage(src, txt, labelColor, textColor, size, textAlign, offset, tooltip) For displaying a label at the last bar.
  Parameters:
    src: The existing label to manage.
    txt: The text to show on the label.
    labelColor: The background color of the label.
    textColor: The text color of the label.
    size: The size of the text. Default is large.
    textAlign: The alignment of the text. Default is left.
    offset: A positive value will push label to the right and a negative to the left.
    tooltip: The optional tooltip of the label.
  Returns: The active label (or 'na' if no text was provided).
BARdisplaylabellast

Pine library

In true TradingView spirit, the author has published this Pine code as an open-source library so that other Pine programmers from our community can reuse it. Cheers to the author! You may use this library privately or in other open-source publications, but reuse of this code in a publication is governed by House rules.

Electrified

Disclaimer

The information and publications are not meant to be, and do not constitute, financial, investment, trading, or other types of advice or recommendations supplied or endorsed by TradingView. Read more in the Terms of Use.