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.

Versionshinweise:

v2 comment fixes

Versionshinweise:

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.

Versionshinweise:

v4 fixed issue with empty tootip

Versionshinweise:

v5 Avoiding na value for tooltip.

Versionshinweise:

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.

Versionshinweise:

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.

Versionshinweise:

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