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.

Want to use this library?

Copy the following line and paste it in your script.