ECharts grid組件配置 坐標軸指示器

grid.tooltip.axisPointer   |   Object

坐標軸指示器配置項。

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

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

坐標軸指示器是指示坐標軸當前刻度的工具。

如下例，鼠標懸浮到圖上，可以出現標線和刻度文本。

點擊編輯實例 》》

上例中，使用了 axisPointer.link 來關聯不同的坐標系中的 axisPointer。

坐標軸指示器也有適合觸屏的交互方式，如下：

點擊編輯實例 》》

坐標軸指示器在多軸的場景能起到輔助作用：

點擊編輯實例 》》 

點擊編輯實例 》》 

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

如何顯示 axisPointer：

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

他們的 axisPointer 默認不顯示。有兩種方法可以讓他們顯示：

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

如何顯示 axisPointer 的 label：

axisPointer 的 label 默認不顯示（也就是默認只顯示指示線），除非：

• 設置軸上的 axisPointer.label.show（例如 xAxis.axisPointer.label.show）為 true，則顯示此軸的 axisPointer 的 label。
• 設置 tooltip.axisPointer.type 為 'cross' 時會自動顯示 axisPointer 的 label。

關于觸屏的 axisPointer 的設置

設置軸上的 axisPointer.handle.show（例如 xAxis.axisPointer.handle.show 為 true 則會顯示出此 axisPointer 的拖拽按鈕。（polar 坐標系暫不支持此功能）。

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

參見例子。

自動吸附到數據（snap）

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