# 接口:TooltipOptions<TType>

# 类型参数

名称 类型
TType 继承自 ChartType = ChartType

# 层次结构

# 属性

# 动画

动画: false | AnimationSpec<TType>

# 定义在

types/index.d.ts:2888 (在新窗口打开)


# 动画序列

动画序列: false | AnimationsSpec<TType>

# 定义在

types/index.d.ts:2889 (在新窗口打开)


#

: InteractionAxis

定义用于计算距离的方向。在索引模式下默认为 'x',在数据集和最近模式下为 'xy'。

# 继承自

CoreInteractionOptions.axis

# 定义在

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

# 定义于

types/index.d.ts:2841 (打开新窗口)


# displayColors

displayColors: Scriptable<boolean, ScriptableTooltipContext<TType>>

如果为true,则在工具提示中显示颜色框。

默认

true

# 定义于

types/index.d.ts:2851 (打开新窗口)


# enabled

enabled: Scriptable<boolean, ScriptableTooltipContext<TType>>

是否启用了画布上的工具提示?

默认

true

# 定义于

types/index.d.ts:2719 (打开新窗口)


# 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

# 定义于

types/index.d.ts:2740 (打开新窗口)


# footerAlign

footerAlign: Scriptable<TextAlign, ScriptableTooltipContext<TType>>

底部文本行的水平对齐方式。

默认

'left'

# 定义于

types/index.d.ts:2821 (打开新窗口)


# footerColor

footerColor: Scriptable<Color, ScriptableTooltipContext<TType>>

页脚颜色

默认

'#fff'

# 定义于

types/index.d.ts:2811 (打开新窗口)


# footerFont

footerFont: ScriptableAndScriptableOptions<Partial<FontSpec>, ScriptableTooltipContext<TType>>

参考字体

默认

# 定义于

types/index.d.ts:2816 (打开新窗口)


# footerMarginTop

footerMarginTop: Scriptable<number, ScriptableTooltipContext<TType>>

在绘制页脚前添加的边距。

默认

6

# 定义于

types/index.d.ts:2806 (打开新窗口)


# footerSpacing

footerSpacing: Scriptable<number, ScriptableTooltipContext<TType>>

在每行页脚顶部和底部添加的间距。

默认

2

# 定义于

types/index.d.ts:2801 (打开新窗口)


# includeInvisible

includeInvisible: boolean

如果为true,则在评估交互时,也会包含图表区域外的不可见点。

默认

false

# 继承自

CoreInteractionOptions.includeInvisible

# 定义于

types/index.d.ts:1585 (打开新窗口)


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'

# 继承自

CoreInteractionOptions.mode

# 定义在

types/index.d.ts:1569 (在新窗口中打开)


# multiKeyBackground

multiKeyBackground: Scriptable<Color, ScriptableTooltipContext<TType>>

当提示框中有多个项目时,绘制在彩色框背后的颜色。

默认

'#fff'

# 定义在

types/index.d.ts:2846 (在新窗口中打开)


# padding

padding: Scriptable<Padding, ScriptableTooltipContext<TType>>

添加到提示框的填充。

默认

6

# 定义在

types/index.d.ts:2826 (新窗口打开)


# position

position: Scriptable<keyof TooltipPositionerMap, ScriptableTooltipContext<TType>>

工具提示定位模式

# 定义于

types/index.d.ts:2727 (新窗口打开)


# rtl

rtl: Scriptable<boolean, ScriptableTooltipContext<TType>>

从右向左渲染图例时设为true。

# 定义于

types/index.d.ts:2880 (新窗口打开)


# textDirection

textDirection: Scriptable<string, ScriptableTooltipContext<TType>>

强制在canvas上以'rtl'或'ltr'方向渲染工具提示文本,忽略canvas上指定的CSS。

默认

canvas的默认值

# 定义于

types/index.d.ts:2886 (新窗口打开)


# titleAlign

titleAlign: Scriptable<TextAlign, ScriptableTooltipContext<TType>>

标题文本行的水平对齐。

默认

'left'

# 定义于

types/index.d.ts:2776 (新窗口打开)


# 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

# 定义于

types/index.d.ts:2723 (在新窗口中打开)