ZoomCharts Documentation
Version: 1.21.20 (2026-09-08)
Switch to Version 2.0 (BETA)

FacetChart.settings.comments.panelLevels

This section is defined by the type LinearChartSettingsCommentsPanelLevels.

Optional "Comments by Level" band below the titlebar (when both are enabled). Lists dataset levels plus an All pseudo-level for navigating and aggregating comments across levels.

Properties

allLabel: string
Default value: "All"

Label for the All pseudo-level row.

countSuffix: string
Default value: " comments"

Text after the per-level count (e.g. " comments" → "3 comments"). Empty/null shows only the number.

enabled: boolean
Default value: false
maxHeight: number
Default value: null

Max height of the levels band in pixels (title + rows + separator). Null/undefined = no absolute pixel ceiling. When content exceeds the effective cap (see also {@link maxHeightFraction}), the title stays fixed and the rows scroll with arrows.

maxHeightFraction: number
Default value: 0.5

Max share of the comments panel below the titlebar that the levels band may occupy (0..1). Combined with {@link maxHeight} when both are set: the stricter (smaller) limit wins. Default 0.5 so levels cannot dominate the panel on short charts, while still growing with resize until an absolute {@link maxHeight} (if any) is reached. Null/undefined disables the relative cap.

nameMinWidth: number
Default value: 48

Minimum width reserved for the level name after the count label is placed on the right.

padding: number
Default value: 6

Outer padding of the levels band content.

rowMargin: number
Default value: 2

Margin around each level row (outside the selected background).

rowPadding: number
Default value: 4

Padding inside each level row (inside the selected background).

selectedBackground: BaseSettingsBackgroundStyle
View section details

Background of the selected row (padding box; excludes row margin).

selectedBorderRadius: number
Default value: 6
separatorColor: string
Default value: "#e5e7eb"
separatorWidth: number
Default value: 1
title: string
Default value: "COMMENTS BY LEVEL"

Optional header above the level rows. Empty/null hides the title.

X