Выходы скрипта: line, histogram, bands, markers, levels, table, panel

Что это даёт

Рендерер знает только значения SeriesOutput и никогда не видит скрипта, который их создал. Поэтому встроенные индикаторы и пользовательские скрипты пользуются одними формами и одними правилами нормализации: точка за пределами видимых баров отбрасывается, неконечное значение становится разрывом (value: null), а null, записанный намеренно — например, на прогреве скользящей средней, — сохраняется как поднятое перо, а не как ложный отрезок.

Цель отрисовки выбирается для каждого скрипта. «На графике» накладывается на цену; «Отдельная панель» резервирует панель, высоту которой рендерер фиксирует на 90 px. Поскольку таблицы и карточки — элементы DOM, скрипт для панели, у которого остались только выходы table, пустую панель не резервирует: разделение выходов на канву и DOM происходит до того, как рендерер считает панели.

Формы и их поля

Карточки таблицы и панели

Таблицы и панели рисуются плавающими карточками поверх графика, потому что таблицу нужно читать, выделять и копировать, а канва этого не даёт, и потому что панель высотой 90 px вмещает лишь три строки. Каждая карточка озаглавлена именем скрипта, затем идёт « · » и заголовок выхода, если он задан. Карточки перетаскиваются за шапку; их положение сохраняется по каждому выходу под ключом orderflow.seriesTables.v1 в конце перетаскивания. Без сохранённой позиции карточки раскладываются каскадом от правого верхнего угла (60 px вниз и 12 px внутрь, со смещением 26 px и 14 px на каждую следующую), поэтому две карточки никогда не совпадают точно.

DOM обновляется один раз за кадр анимации, а не в темпе публикации баров 4 Гц, и пустая ячейка печатается как «—», а не как 0. Выравнивание колонки по умолчанию левое; скрипт, которому нужны числа справа, задаёт колонке align: "right".

Как этим пользоваться

Помощники lib строят распространённые формы: lib.line(chronoBars, values, color, width), lib.histogram, lib.markers, lib.levels, lib.table(columns, rows, title) и lib.panel. Массивы, передаваемые помощникам lib, идут в хронологическом порядке, поэтому сначала разверните бары, приходящие от новых к старым. Скрипт может вернуть несколько выходов — например, один bands и один line для VWAP с полосами сигмы.

Отклонённая форма не исчезает бесследно: скрипт помечается в панели индикаторов, и строка под его именем вместо цели отрисовки превращается в «Нераспознанное возвращаемое значение. Индикатор возвращает серию, линии или метки — см. «Индикатор: что возвращать».» Скрипт, чьи выходы ничего не рисуют, помечается как «empty», что отличает «не работает» от «показывать было нечего».

Ограничения и подводные камни

• Толщина меньше 0,5 или больше 12 px ограничивается; неизвестные имена стилей сводятся к solid.
• Точки histogram со значением null или неконечным удаляются целиком — в отличие от линий, где null является разрывом.
• Уровни — это отрезки по ключу price и from; они не фильтруются по времени бара, поэтому метка from старше загруженной истории просто начинается от левого края.
• Таблица длиннее 50 строк обрезается; если количество важно, напишите об обрезке в заголовке сами.