Electrified

LabelHelper

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).
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.

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.

Want to use this library?

Copy the following line and paste it in your script.