# 接口:TooltipOptions<TType>
# 类型参数
| 名称 | 类型 |
|---|---|
TType | 继承自 ChartType = ChartType |
# 层次结构
-
↳
TooltipOptions
# 属性
# 动画
• 动画: false | AnimationSpec<TType>
# 定义在
types/index.d.ts:2888 (在新窗口打开)
# 动画序列
• 动画序列: false | AnimationsSpec<TType>
# 定义在
types/index.d.ts:2889 (在新窗口打开)
# 轴
• 轴: InteractionAxis
定义用于计算距离的方向。在索引模式下默认为 'x',在数据集和最近模式下为 'xy'。
# 继承自
# 定义在
types/index.d.ts:1579 (在新窗口打开)
# 背景颜色
• 背景颜色: Scriptable<Color, ScriptableTooltipContext<TType>>
工具提示的背景颜色。
默认
'rgba(0, 0, 0, 0.8)'
# 定义在
types/index.d.ts:2746 (在新窗口打开)
# 主体对齐方式
• 主体对齐方式: Scriptable<TextAlign, ScriptableTooltipContext<TType>>
主体文本行的水平对齐方式。
默认
'left'
# 定义在
types/index.d.ts:2796 (在新窗口中打开)
# bodyColor
• bodyColor: Scriptable<Color, ScriptableTooltipContext<TType>>
主体的颜色
默认
'#fff'
# 定义在
types/index.d.ts:2786 (在新窗口中打开)
# bodyFont
• bodyFont: ScriptableAndScriptableOptions<Partial<FontSpec>, ScriptableTooltipContext<TType>>
请参阅字体设置。
默认
# 定义在
types/index.d.ts:2791 (在新窗口中打开)
# bodySpacing
• bodySpacing: Scriptable<number, ScriptableTooltipContext<TType>>
为每个提示项顶部和底部添加的间距
默认
2
# 定义在
types/index.d.ts:2781 (在新窗口中打开)
# borderColor
• borderColor: Scriptable<Color, ScriptableTooltipContext<TType>>
边框的颜色。
默认
'rgba(0, 0, 0, 0)'
# 定义在
types/index.d.ts:2871 (在新窗口中打开)
# borderWidth
• borderWidth: Scriptable<number, ScriptableTooltipContext<TType>>
边框的宽度。
默认
0
# 定义在
types/index.d.ts:2876 (在新窗口中打开)
# boxHeight
• boxHeight: Scriptable<number, ScriptableTooltipContext<TType>>
若 displayColors 为 true,则颜色框的高度。
默认
bodyFont.size
# 定义于
types/index.d.ts:2861 (在新窗口打开)
# boxPadding
• boxPadding: number
颜色框和文本之间的填充。
默认
1
# 定义于
types/index.d.ts:2751 (在新窗口打开)
# boxWidth
• boxWidth: Scriptable<number, ScriptableTooltipContext<TType>>
若 displayColors 为 true,则颜色框的宽度。
默认
bodyFont.size
# 定义于
types/index.d.ts:2856 (在新窗口打开)
# callbacks
• callbacks: TooltipCallbacks<TType, TooltipModel<TType>, TooltipItem<TType>>
# 定义于
types/index.d.ts:2890 (在新窗口打开)
# caretPadding
• caretPadding: Scriptable<number, ScriptableTooltipContext<TType>>
将工具提示箭尾移动到工具提示点之外的额外距离。
默认
2
# 定义于
types/index.d.ts:2831 (在新窗口打开)
# caretSize
• caretSize: Scriptable<number, ScriptableTooltipContext<TType>>
工具提示箭头的大小,单位为像素。
默认
5
# 定义于
types/index.d.ts:2836 (在新窗口打开)
# cornerRadius
• cornerRadius: Scriptable<number | BorderRadius, ScriptableTooltipContext<TType>>
工具提示角落的曲线半径。
默认
6
# 定义于
# displayColors
• displayColors: Scriptable<boolean, ScriptableTooltipContext<TType>>
如果为true,则在工具提示中显示颜色框。
默认
true
# 定义于
# enabled
• enabled: Scriptable<boolean, ScriptableTooltipContext<TType>>
是否启用了画布上的工具提示?
默认
true
# 定义于
# filter
• filter: (e: TooltipItem<TType>, index: number, array: TooltipItem<TType>[], data: ChartData<keyof ChartTypeRegistry, (number | [number, number] | Point | BubbleDataPoint)[], unknown>> => boolean
# 类型声明
▸ (e, index, array, data): boolean
# 参数
| 名称 | 类型 |
|---|---|
e | TooltipItem<TType> |
index | number |
array | TooltipItem<TType>[] |
data | ChartData<keyof ChartTypeRegistry, (number | [number, number] | Point | BubbleDataPoint)[], unknown> |
# 返回
boolean
# 定义于
# footerAlign
• footerAlign: Scriptable<TextAlign, ScriptableTooltipContext<TType>>
底部文本行的水平对齐方式。
默认
'left'
# 定义于
# footerColor
• footerColor: Scriptable<Color, ScriptableTooltipContext<TType>>
页脚颜色
默认
'#fff'
# 定义于
# footerFont
• footerFont: ScriptableAndScriptableOptions<Partial<FontSpec>, ScriptableTooltipContext<TType>>
参考字体
默认
# 定义于
# footerMarginTop
• footerMarginTop: Scriptable<number, ScriptableTooltipContext<TType>>
在绘制页脚前添加的边距。
默认
6
# 定义于
# footerSpacing
• footerSpacing: Scriptable<number, ScriptableTooltipContext<TType>>
在每行页脚顶部和底部添加的间距。
默认
2
# 定义于
# includeInvisible
• includeInvisible: boolean
如果为true,则在评估交互时,也会包含图表区域外的不可见点。
默认
false
# 继承自
CoreInteractionOptions.includeInvisible
# 定义于
intersect
• intersect: boolean
如果为真,悬停模式仅在鼠标位置与图表上的项目相交时应用。
默认
true
# 继承自
CoreInteractionOptions.intersect
# 定义在
types/index.d.ts:1574 (在新窗口中打开)
# itemSort
• itemSort: (a: TooltipItem<TType>, b: TooltipItem<TType>, data: ChartData<keyof ChartTypeRegistry, (number | [number, number] | Point | BubbleDataPoint][], unknown>) => number
# 类型声明
▸ (a, b, data): number
对提示项排序。
# 参数
| 名称 | 类型 |
|---|---|
a | TooltipItem<TType> |
b | TooltipItem<TType> |
data | ChartData<keyof ChartTypeRegistry, (number | [number, number] | Point | BubbleDataPoint)[], unknown> |
# 返回值
number
# 定义在
types/index.d.ts:2738 (在新窗口中打开)
# mode
• mode: keyof InteractionModeMap
设置哪些元素出现在提示框中。请参阅交互模式以获取详细信息。
默认
'nearest'
# 继承自
# 定义在
types/index.d.ts:1569 (在新窗口中打开)
# multiKeyBackground
• multiKeyBackground: Scriptable<Color, ScriptableTooltipContext<TType>>
当提示框中有多个项目时,绘制在彩色框背后的颜色。
默认
'#fff'
# 定义在
types/index.d.ts:2846 (在新窗口中打开)
# padding
• padding: Scriptable<Padding, ScriptableTooltipContext<TType>>
添加到提示框的填充。
默认
6
# 定义在
# position
• position: Scriptable<keyof TooltipPositionerMap, ScriptableTooltipContext<TType>>
工具提示定位模式
# 定义于
# rtl
• rtl: Scriptable<boolean, ScriptableTooltipContext<TType>>
从右向左渲染图例时设为true。
# 定义于
# textDirection
• textDirection: Scriptable<string, ScriptableTooltipContext<TType>>
强制在canvas上以'rtl'或'ltr'方向渲染工具提示文本,忽略canvas上指定的CSS。
默认
canvas的默认值
# 定义于
# titleAlign
• titleAlign: Scriptable<TextAlign, ScriptableTooltipContext<TType>>
标题文本行的水平对齐。
默认
'left'
# 定义于
# titleColor
• titleColor: Scriptable<Color, ScriptableTooltipContext<TType>>
标题颜色
默认
'#fff'
# 定义于
types/index.d.ts:2756(在新窗口中打开)
# titleFont
• titleFont: ScriptableAndScriptableOptions<code>Partial<FontSpec>, ScriptableTooltipContext<TType>>
参考字体
默认
# 定义于
types/index.d.ts:2761(在新窗口中打开)
# titleMarginBottom
• titleMarginBottom: Scriptable<number, ScriptableTooltipContext<TType>>
标题部分底部添加的边距。
默认
6
# 定义于
types/index.d.ts:2771(在新窗口中打开)
# titleSpacing
• titleSpacing: Scriptable<number, ScriptableTooltipContext<TType>>
每行标题上下添加的间距。
默认
2
# 定义于
types/index.d.ts:2766(在新窗口中打开)
# usePointStyle
• usePointStyle: Scriptable<boolean, ScriptableTooltipContext<TType>>
使用对应的数据点样式(从数据集选项中获取)代替颜色框,例如:星号、三角形等。(大小基于boxWidth和boxHeight之间的小值确定)
默认
false
# 定义于
types/index.d.ts:2866(在新窗口中打开)
# xAlign
• xAlign: Scriptable<TooltipXAlignment, ScriptableTooltipContext<TType>>
覆盖提示框对齐计算
# 定义于
types/index.d.ts:2732 (在新窗口中打开)
# yAlign
• yAlign: Scriptable<TooltipYAlignment, ScriptableTooltipContext<TType>>
# 定义于
types/index.d.ts:2733 (在新窗口中打开)
# 方法
# 外部
▸ external(this, args): void
参见外部提示框部分。
# 参数
| 名称 | 类型 |
|---|---|
此 | TooltipModel<TType> |
args | 对象 |
args.chart | Chart<keyof ChartTypeRegistry, (number | [number, number] | Point | BubbleDataPoint)[], unknown> |
args.tooltip | TooltipModel<TType> |
# 返回值
void