折线图选项

导入

import type { LineChartOptions } from "@sixtyfold/line";

使用上方所示的公开入口。仅类型导入不会保留在应用 JavaScript 中。

`BandOptions`

范围/带状特定的视觉选项

导入 @sixtyfold/line接口

interface BandOptions

成员	定义	描述
`borderColor?`	`string \| undefined`	上下边界的共享边框颜色（当启用边框时默认为序列颜色）
`borderStyle?`	`BandBorderStyle \| undefined` = `solid`	边框线样式
`borderWidth?`	`number \| undefined`	边框宽度（像素）。设置为 0 可禁用边框。
`fill?`	`number \| boolean \| undefined`	填充带状区域。- false：不填充带状区域 - true：使用序列颜色以默认不透明度填充 - 数字（0–1）：使用序列颜色以指定不透明度填充
`fillColor?`	`string \| SeriesGradient \| undefined`	带状区域填充颜色——实心颜色字符串或渐变对象。如指定则覆盖填充不透明度
`lowerBorderColor?`	`string \| undefined`	覆盖下边界的颜色
`upperBorderColor?`	`string \| undefined`	覆盖上边界颜色

`BarOptions`

条形/柱形特定的视觉选项

导入 @sixtyfold/line接口

interface BarOptions

成员	定义	描述
`baseline?`	`number \| undefined` = `0`	条形从此数据值增长
`borderColor?`	`string \| undefined`	共享条形边框颜色（启用边框时默认使用序列颜色）
`borderStyle?`	`BarBorderStyle \| undefined` = `solid`	边框线样式
`borderWidth?`	`number \| undefined`	边框宽度（像素）。设为 0 以禁用边框。
`fill?`	`number \| boolean \| undefined`	填充柱状。- false：不填充柱状 - true：以系列颜色按默认不透明度填充 - 数值（0-1）：以指定不透明度用系列颜色填充
`fillColor?`	`string \| SeriesGradient \| undefined`	柱状填充颜色 — 实心颜色字符串或渐变对象。若指定则覆盖填充不透明度
`maxWidth?`	`number \| undefined` = `24`	最大柱宽（像素）
`minWidth?`	`number \| undefined` = `1`	最小柱宽（像素）
`widthRatio?`	`number \| undefined` = `0.7`	每个柱子使用的可用样本间距的比例

`LegendLabelFontOptions`

图例标签字体的选项。

导入 @sixtyfold/line接口

interface LegendLabelFontOptions

成员	定义	描述
`color?`	`string \| undefined` = `#cfd6e6`	字体颜色
`family?`	`string \| undefined` = `DEFAULT_CHART_FONT_FAMILY`	字体系列
`size?`	`number \| undefined` = `12`	字体大小（像素）
`style?`	`"normal" \| "italic" \| "oblique" \| undefined` = `normal`	字体样式
`weight?`	`string \| number \| undefined` = `normal`	字体粗细
`width?`	`number \| undefined` = `auto`	最大标签文本宽度（像素）

`LegendOptions`

内置 Canvas2D 图例的放置、布局、排版、色块与交互。

导入 @sixtyfold/line接口

interface LegendOptions

Member	Definition	Description
`align?`	`LegendAlign \| undefined` = `center`	图例区域中的对齐
`allowHideAll?`	`boolean \| undefined` = `false`	允许隐藏所有系列
`inactiveOpacity?`	`number \| undefined` = `0.45`	隐藏系列图例项的不透明度
`interactive?`	`boolean \| undefined` = `false`	启用点击切换交互
`itemGap?`	`number \| undefined` = `12`	项目间距（像素）
`labelFont?`	`LegendLabelFontOptions \| undefined`	图例标签字体样式
`layout?`	`LegendLayout \| undefined` = `column`	项目布局
`padding?`	`{ top?: number; right?: number; bottom?: number; left?: number; } \| undefined` = `8`	图例区域内的内边距，单位为像素
`position?`	`LegendPosition \| undefined` = `right`	图例在图表区域的显示位置
`swatch?`	`LegendSwatchOptions \| undefined`	样本块样式选项
`swatchGap?`	`number \| undefined` = `6`	标本块与标签之间的间距，单位为像素
`visible?`	`boolean \| undefined`	显示图例。提供 `legend` 时默认启用；省略 `legend` 时禁用。

`LegendSwatchOptions`

图例样本的选项。

导入 @sixtyfold/line接口

interface LegendSwatchOptions

成员	定义	说明
`borderColor?`	`string \| undefined` = `transparent`	色块边框颜色
`borderWidth?`	`number \| undefined` = `0`	色块边框宽度（像素）
`shape?`	`LegendSwatchShape \| undefined` = `circle`	色块形状
`size?`	`number \| undefined` = `10`	色块尺寸（像素）

`LineAppearanceOptions`

折线图外观 — 基础外观 + 图例 + 标记

导入 @sixtyfold/line接口

interface LineAppearanceOptions extends BaseAppearanceOptions

成员	定义	描述
`axis?`	`AxisAppearanceOptions \| undefined`	轴的运行时外观选项。
`chartBackground?`	`BackgroundOptions \| undefined`	图表背景的运行时外观选项。
`crosshairStyle?`	`CrosshairOptions \| undefined`	十字准线样式的运行时外观选项。
`grid?`	`GridOptions \| undefined`	网格的运行时外观选项。
`labels?`	`ChartLabels \| undefined`	标签的运行时外观选项。
`legend?`	`LegendOptions \| undefined`	图例的运行时外观选项。
`marker?`	`MarkerOptions \| undefined`	标记的运行时外观选项。
`overlay?`	`OverlayOptions \| undefined`	覆盖层的运行时外观选项。
`padding?`	`PaddingOptions \| undefined`	内边距的运行时外观选项。
`rangeSelector?`	`RangeSelectorAppearanceOptions \| undefined`	范围选择器的运行时外观选项。
`selection?`	`SelectionOptions \| undefined`	选区的运行时外观选项。
`textDirection?`	`TextDirection \| undefined`	文本方向的运行时外观选项。
`tooltip?`	`TooltipOptions \| undefined`	工具提示的运行时外观选项。

`LineChartOptions`

折线图的构造、交互、外观、序列和细节层级（LOD）选项。

导入 @sixtyfold/line接口

interface LineChartOptions

成员	定义	描述
`animated?`	`boolean \| undefined`	动画数据显现与视口/坐标轴过渡。若省略，则启用动画，除非浏览器报告 `prefers-reduced-motion: reduce`。
`axis?`	`AxisOptions \| undefined`	轴定制（线条颜色与标签颜色）
`chartBackground?`	`BackgroundOptions \| undefined` = `#16213e`	图表背景（覆盖整个画布包括预览区域）。可以是纯色字符串、渐变定义或图像。
`crosshairStyle?`	`CrosshairOptions \| undefined`	十字准线样式（垂直和水平指引线）
`grid?`	`GridOptions \| undefined`	主图网格线定制
`interactive?`	`boolean \| undefined` = `true`	启用用户交互（平移/缩放/捏合）。为 false 时，图表为只读，但仍在悬停时显示十字线/提示。
`interpolation?`	`"none" \| "linear" \| "spline" \| undefined` = `linear`	数据点之间数值的插值模式 - “none”：不插值，贴近最近的数据点 - “linear”：相邻点间线性插值 - “spline”：使用 Catmull-Rom 样条进行平滑曲线插值
`keepAliveInterval?`	`number \| undefined` = `0 (disabled)`	保持活动间隔（秒），以防 Safari 释放 GPU 资源。Safari 会积极清理“未使用”的画布，导致图表变空白。
`keyboardActivation?`	`"focus" \| "hover" \| undefined`	键盘控制何时生效。- “focus”（默认）：图表必须具有 DOM 焦点 - “hover”：鼠标指针下的图表接收键盘导航
`keyboardAnnouncements?`	`false \| KeyboardAnnouncementMessages \| undefined`	为辅助技术本地化键盘操作提示，或将 `false` 设为以禁用它们。省略的消息使用简明的英文默认值。
`keyboardPanSpeed?`	`number \| undefined` = `0.1 (10%)`	键盘平移速度（箭头键）。每次按键平移的可见范围比例。1（10%）
`keyboardZoomSpeed?`	`number \| undefined` = `0.1 (10% per keypress)`	键盘缩放速度（+/- 键）。值越大＝缩放越快。1（每次按键10%）
`labels?`	`ChartLabels \| undefined`	图表周围的文本标签（标题、坐标轴标签）
`legend?`	`LegendOptions \| undefined`	系列图例选项
`lod?`	`LineLODOptions \| undefined`	细节层级呈现策略。
`marker?`	`MarkerOptions \| undefined`	悬停点的默认标记样式（可按系列覆盖）
`minViewportRange?`	`number \| undefined`	最小可交互 X 视口跨度，以图表 X 值相同的单位表示。无效或非正值将保留图表类型默认值。此构建选项不属于可变外观。
`overlay?`	`OverlayOptions \| undefined`	在图表内容上方呈现的声明式覆盖原语
`padding?`	`PaddingOptions \| undefined` = `{ top: 20, right: 80, bottom: 40, left: 80 }`	自定义像素填充
`rangeSelector?`	`RangeSelectorOptions \| undefined`	范围选择器（预览图表）配置
`rendererInitializationTimeout?`	`number \| undefined` = `15000`	渲染器启动允许的最长时间（以毫秒为单位）。看门狗在图表构造期间启动，因此它也保护未等待 `BaseChart.initialize` 的应用。设置为 `0` 以禁用它。
`renderMode?`	`"auto" \| "worker" \| "main" \| undefined`	选择渲染模式。`auto` 优先使用 Worker + OffscreenCanvas；`worker` 强制使用 worker，并在不支持时回退到主线程；`main` 在浏览器主线程中渲染且需要 DOM。
`selection?`	`SelectionOptions \| undefined`	选择范围（拖拽缩放）样式
`series?`	`SeriesOptions[] \| undefined`	每系列配置（颜色、填充、渐变）
`textDirection?`	`TextDirection \| undefined` = `inherit`	用于 Canvas2D 文本的方向。使用 “auto” 从每个字符串的第一个强字符推断，或用 “rtl”/“ltr” 强制全图方向。
`tooltip?`	`TooltipOptions \| undefined`	提示（十字准线信息框）样式
`wheelZoomDirection?`	`"up-in" \| "up-out" \| undefined`	鼠标滚轮缩放方向。- “up-in”（默认）：向上/后滚为放大，向下/前滚为缩小 - “up-out”：向上/后滚为缩小，向下/前滚为放大
`wheelZoomSpeed?`	`number \| undefined` = `0.1 (10% per wheel tick)`	鼠标滚轮缩放速度。值越大 = 缩放越快。1（每次滚轮刻度 10%）
`yDomain?`	`YDomainOptions \| undefined`	钉住渲染的 Y 域的一侧或两侧。省略的边在可见数据范围内继续自动缩放。同时提供两个有限边可在缩放、LOD 选择和流式更新时保持 Y 视口稳定。该选项默认禁用，属于构造配置而非可变外观。

`LineChartStatsOptions`

控制线路遥测发布的频率。

导入 @sixtyfold/line接口

interface LineChartStatsOptions

成员	定义	描述
`intervalMs?`	`number \| undefined` = `250`	更新统计信息的最小间隔（毫秒）

`LineDataUpdateOptions`

控制用于批量折线数据替换的动画过渡。

导入 @sixtyfold/line接口

interface LineDataUpdateOptions

成员	定义	描述
`preservePreviousFrame?`	`boolean \| undefined`	在揭示边界之前保持先前渲染的图表可见，同时绘制动画替换数据集。默认值为 false。请在先前的揭示完成后再使用此选项；否则其部分揭示的帧（包括任何空白余部）将被保留。被保留的像素是静态的，因此在新揭示期间平移或缩放可能会在过渡完成之前产生临时的网格/数据接缝。

`LineLODOptions`

稳定的屏幕空间呈现策略与保真/平滑系数。

导入 @sixtyfold/line接口

interface LineLODOptions

成员	定义	描述
`density?`	`number \| undefined` = `0.75`	每个 CSS 像素的目标呈现列数以及主要的保真/工作控制。较高的值保留更多局部细节并增加渲染工作量。
`mode?`	`"pyramid" \| "adaptive" \| undefined`	`adaptive` 在支持的情况下使用稳定的视口感知屏幕空间呈现。`pyramid` 在预构建的全局细节层级（LOD）之间选择。
`quantizationStep?`	`number \| undefined` = `0.25`	每个二进制倍频程内的加性网格间隔。较小的值使更接近的网格宽度可用并在更高查询成本下减少纹理跳变。为实现平滑过渡，请将此值与类似的重基准缩放配对（例如 0.1 与 1.1–1.12）。
`rebaseRatio?`	`number \| undefined` = `1.25`	粘性网格在重基准前允许的最大投影列宽漂移。下界为其倒数。较低的值会产生更小且更频繁的表示变化。

`MarkerGlowOptions`

悬停标记的可选辉光效果

导入 @sixtyfold/line接口

interface MarkerGlowOptions

成员	定义	描述
`blur?`	`number \| undefined` = `12`	发光模糊半径（像素）
`color?`	`string \| undefined`	发光颜色（默认为标记填充/序列颜色）
`opacity?`	`number \| undefined` = `0.45`	发光不透明度 0-1

`MarkerOptions`

悬停点指示器的标记选项

导入 @sixtyfold/line接口

interface MarkerOptions

成员	定义	描述
`borderColor?`	`string \| undefined` = `#fff`	边框/描边颜色
`borderWidth?`	`number \| undefined` = `1`	边框/描边宽度（像素）
`glow?`	`boolean \| MarkerGlowOptions \| undefined`	可选的标记光晕
`shape?`	`MarkerShape \| undefined` = `circle`	标记形状
`size?`	`number \| undefined` = `5`	标记大小（像素）——圆的半径，其他形状的半宽

`PointOptions`

散点/点特定的视觉选项

导入 @sixtyfold/line接口

interface PointOptions

成员	定义	描述
`borderColor?`	`string \| undefined` = `#fff`	点的边框/描边颜色
`borderWidth?`	`number \| undefined` = `0`	点的边框/描边宽度（像素）
`color?`	`string \| undefined`	点填充颜色（默认使用系列颜色）
`opacity?`	`number \| undefined` = `1`	点不透明度 0-1
`shape?`	`MarkerShape \| undefined` = `circle`	点形状
`size?`	`number \| undefined` = `3`	像素中的点大小 — 圆的半径，其他的半宽

`SeriesAppearanceOptions`

每系列外观字段 — 仅视觉与呈现

导入 @sixtyfold/line类型

type SeriesAppearanceOptions = Pick<SeriesOptions, "type" | "color" | "fill" | "fillColor" | "fillToZero" | "fillEffect" | "band" | "bar" | "stack" | "point" | "width" | "name" | "unit" | "marker">

成员	定义	描述
`band?`	`BandOptions \| undefined`	范围/带状特定的填充和边框样式
`bar?`	`BarOptions \| undefined`	条形/柱状特定的填充、边框、宽度和基线样式
`color?`	`string \| undefined`	线条颜色（未指定时回退到默认调色板）
`fill?`	`number \| boolean \| undefined`	填充线下区域。 - false：不填充（默认） - true：以线条颜色 40% 不透明度填充 - 数值（0-1）：以指定不透明度用线条颜色填充
`fillColor?`	`string \| SeriesGradient \| undefined`	填充颜色 — 纯色字符串或渐变对象。若指定则覆盖填充不透明度
`fillEffect?`	`"none" \| "glow" \| "layered" \| undefined`	填充样式效果 — 'none'：平坦颜色填充（默认） - 'glow'：从线条发散的柔和光晕 - 'layered'：叠层填充，使用不同不透明度营造深度感
`fillToZero?`	`boolean \| undefined` = `true`	填充到零基线而不是图表底部当为 true：正值向下填充到零，负值向上填充到零当为 false：始终填充到图表底部
`marker?`	`MarkerOptions \| undefined`	此系列悬停点的标记样式（覆盖图表级标记）
`name?`	`string \| undefined`	系列显示名称（用于图例和提示）。
`point?`	`PointOptions \| undefined`	散点/点状图专用的标记样式
`stack?`	`StackOptions \| undefined`	堆叠面积图专用的填充和顶部边界样式
`type?`	`LineSeriesType \| undefined` = `line`	系列绘制样式。"step" 为 "step-after" 的别名；"band" 为 "range" 的别名；"points" 为 "scatter" 的别名；"column" 为 "bar" 的别名；"stackedArea" 为 "stacked-area" 的别名。
`unit?`	`UnitOptions \| undefined`	该系列的单位配置（用于提示和坐标轴标签）
`width?`	`number \| undefined` = `1.5`	线条描边宽度（像素）。设置为 0 可在保留区间填充、提示和其他系列层的同时禁用描边。

`SeriesGradient`

系列填充的渐变定义

导入 @sixtyfold/line接口

interface SeriesGradient

成员	定义	描述
`colors`	`string[]`	CSS 颜色停点（至少 2 个）；无效颜色将被跳过。
`direction?`	`"vertical" \| "horizontal" \| undefined` = `vertical`	渐变方向
`offsets?`	`number[] \| undefined`	可选的每种颜色偏移位置（0-1），默认为均匀分布

`SeriesOptions`

单个序列的配置

导入 @sixtyfold/line接口

interface SeriesOptions

成员	定义	描述
`band?`	`BandOptions \| undefined`	范围/带状特定填充和边框样式
`bar?`	`BarOptions \| undefined`	条形/柱状特定的填充、边框、宽度和基线样式
`color?`	`string \| undefined`	折线颜色（如未指定则回退到默认调色板）
`fill?`	`number \| boolean \| undefined`	填充折线下方区域。 - false：不填充（默认） - true：以折线颜色并 40% 不透明度填充 - 数值（0-1）：以折线颜色按指定不透明度填充
`fillColor?`	`string \| SeriesGradient \| undefined`	填充颜色——实色字符串或渐变对象。如指定，则覆盖填充不透明度
`fillEffect?`	`"none" \| "glow" \| "layered" \| undefined`	填充样式效果 - 'none'：平面颜色填充（默认） - 'glow'：从线条发散的柔和光晕 - 'layered'：具有不同比例不透明度的分层填充以表现深度
`fillToZero?`	`boolean \| undefined` = `true`	填充到零基线而非图表底部为 true 时：正值向下填充到零，负值向上填充到零为 false 时：总是填充到图表底部
`marker?`	`MarkerOptions \| undefined`	此系列悬停点的标记样式（覆盖图表级标记）
`name?`	`string \| undefined`	系列显示名称（用于图例和工具提示）。
`point?`	`PointOptions \| undefined`	散点/点特有的标记样式
`stack?`	`StackOptions \| undefined`	堆叠面积特有的填充和顶部边界样式
`type?`	`LineSeriesType \| undefined` = `line`	系列绘制样式。"step"是"step-after"的别名；"band"是"range"的别名；"points"是"scatter"的别名；"column"是"bar"的别名；"stackedArea"是"stacked-area"的别名。
`unit?`	`UnitOptions \| undefined`	此系列的单位配置（用于提示和坐标轴标签）
`width?`	`number \| undefined` = `1.5`	折线描边宽度（像素）。设为 0 可在保留范围填充、提示和其他系列图层的同时抑制描边。

`StackOptions`

堆叠面积图专用的视觉选项

导入 @sixtyfold/line接口

interface StackOptions

Member	Definition	Description
`borderColor?`	`string \| undefined`	顶部边界颜色（默认为序列颜色）
`borderStyle?`	`StackBorderStyle \| undefined` = `solid`	顶部边界线样式
`borderWidth?`	`number \| undefined`	顶部边界宽度（以像素为单位，默认为序列宽度）。设为 0 可禁用。
`curve?`	`StackCurveStyle \| undefined` = `linear`	填充带和顶边界的边界形状。
`fill?`	`number \| boolean \| undefined`	填充堆叠区域。 - false：不填充区域 - true：以系列颜色和默认不透明度填充 - 数字（0-1）：以指定不透明度用系列颜色填充
`fillColor?`	`string \| SeriesGradient \| undefined`	区域填充颜色——实色字符串或渐变对象。若指定则覆盖填充不透明度