tooltip坐標(biāo)軸指示器配置

2018-09-13 10:30 更新

polar.tooltip.axisPointer   |   Object

極坐標(biāo)系的 tooltip 坐標(biāo)軸指示器配置項。

tooltip.axisPointer 是配置坐標(biāo)軸指示器的快捷方式。實際上坐標(biāo)軸指示器的全部功能,都可以通過軸上的 axisPointer 配置項完成(例如 xAxis.axisPointer 或 angleAxis.axisPointer)。但是使用 tooltip.axisPinter 在簡單場景下會更方便一些。

注意: tooltip.axisPointer 中諸配置項的優(yōu)先級低于軸上的 axisPointer 的配置項。

坐標(biāo)軸指示器是指示坐標(biāo)軸當(dāng)前刻度的工具。

如下例,鼠標(biāo)懸浮到圖上,可以出現(xiàn)標(biāo)線和刻度文本。

ECharts中tooltip坐標(biāo)軸指示器使用實例

點擊編輯實例 》》

上例中,使用了 axisPointer.link 來關(guān)聯(lián)不同的坐標(biāo)系中的 axisPointer。

坐標(biāo)軸指示器也有適合觸屏的交互方式,如下:

ECharts觸屏tooltip和dataZoom實例

點擊編輯實例 》》

坐標(biāo)軸指示器在多軸的場景能起到輔助作用:

 

ECharts中tooltip坐標(biāo)軸指示器在多軸場景的實例

點擊編輯實例 》》 

ECharts中tooltip坐標(biāo)軸指示器在多軸場景的實例

點擊編輯實例 》》

注意: 一般來說,axisPointer 的具體配置項會配置在各個軸中(如 xAxis.axisPointer)或者 tooltip 中(如 tooltip.axisPointer)。但是這幾個選項只能配置在全局的 axisPointer 中:axisPointer.triggerOn、axisPointer.link。

如何顯示 axisPointer:

直角坐標(biāo)系 grid、極坐標(biāo)系 polar、單軸坐標(biāo)系 single 中的每個軸都自己的 axisPointer。

他們的 axisPointer 默認(rèn)不顯示,但是有兩種方法可以讓他們顯示:

  • 設(shè)置軸上的 axisPointer.show(例如 xAxis.axisPointer.show)為 true,則顯示此軸的 axisPointer。
  • 設(shè)置 tooltip.trigger 設(shè)置為 'axis' 或者 tooltip.axisPointer.type 設(shè)置為 'cross',則此時坐標(biāo)系會自動選擇顯示哪個軸的 axisPointer,也可以使用 tooltip.axisPointer.axis 改變這種選擇。注意,軸上如果設(shè)置了 axisPointer,會覆蓋此設(shè)置。

如何顯示 axisPointer 的 label:

axisPointer 的 label 默認(rèn)不顯示(也就是默認(rèn)只顯示指示線),除非:

  • 設(shè)置軸上的 axisPointer.label.show(例如 xAxis.axisPointer.label.show)為 true,則顯示此軸的 axisPointer 的 label。
  • 設(shè)置 tooltip.axisPointer.type 為 'cross' 時會自動顯示 axisPointer 的 label。

關(guān)于觸屏的 axisPointer 的設(shè)置

設(shè)置軸上的 axisPointer.handle.show(例如 xAxis.axisPointer.handle.show 為 true 則會顯示出此 axisPointer 的拖拽按鈕。(polar 坐標(biāo)系暫不支持此功能)。

注意: 如果發(fā)現(xiàn)此時 tooltip 效果不良好,可設(shè)置 tooltip.triggerOn 為 'none'(于是效果為:手指按住按鈕則顯示 tooltip,松開按鈕則隱藏 tooltip),或者 tooltip.alwaysShowContent 為 true(效果為 tooltip 一直顯示)。

參見例子。

自動吸附到數(shù)據(jù)(snap)

對于數(shù)值軸、時間軸,如果開啟了 snap,則 axisPointer 會自動吸附到最近的點上。

以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號