OrbCharts 文件
文件
返回首頁
Github
  • English
  • 繁體中文
文件
返回首頁
Github
  • English
  • 繁體中文
  • 指南
  • 基本概念

    • 6種資料格式
    • 核心技術
  • 快速開始 !

    • 安裝
    • 範例
  • 基礎使用

    • 建立圖表
    • 使用預設集(Preset)
    • 繪製圖表
    • 資料標籤
  • 圖表 API

    • plugins$
    • data$
    • chartParams$
    • dataFormatter$
    • event$
    • destroy()
  • Plugins

    • 建立 Plugin
    • Series

      • Bubbles
      • Pie
      • PieEventTexts
      • PieLabels
      • Rose
      • RoseLabels
      • SeriesLegend
      • SeriesTooltip
    • Grid

      • Bars
      • BarsPN
      • BarsTriangle
      • Dots
      • GridLegend
      • GridTooltip
      • GroupAux
      • GroupAxis
      • GroupZoom
      • Lines
      • LineAreas
      • StackedBars
      • StackedValueAxis
      • ValueAxis
    • MultiGrid

      • MultiBars
      • MultiBarsTriangle
      • MultiDots
      • MultiGridLegend
      • MultiGridTooltip
      • MultiGroupAxis
      • MultiStackedBars
      • MultiStackedValueAxis
      • MultiValueAxis
      • OverlappingValueAxes
      • OverlappingStackedValueAxes
    • MultiValue

      • MultiValueLegend
      • MultiValueTooltip
      • OrdinalAux
      • OrdinalAxis
      • OrdinalBubbles
      • OrdinalZoom
      • RacingBars
      • RacingCounterTexts
      • RacingValueAxis
      • Scatter
      • ScatterBubbles
      • XYAux
      • XYAxes
      • XYZoom
    • Relationship

      • ForceDirected
      • ForceDirectedBubbles
      • RelationshipLegend
      • RelationshipTooltip
    • Tree

      • TreeLegend
      • TreeMap
      • TreeTooltip

XYAxes

  • 名稱:X And Y Axes(X 及 Y 圖軸)

  • 說明:MultiValue 資料類別使用的 X, Y 圖軸,value 索引 [0], [1] 資料分別對應 X , Y 軸座標。

  • 使用方式:圖軸的格式會搭配 dataFormatter 的 xAxis, yAxis 欄位設定,詳細 API 請參考文件(不過大部份情況下如已使用 Preset 則不太需要自行設定 dataFormatter,較常使用的是圖軸標籤的設定)

  • 圖軸標籤設定:使用 dataFormatter 的 xAxis.label, yAxis.label 設定標籤文字,範例如下:

chart.dataFormatter$.next({
  xAxis: {
    label: 'x'
  },
  yAxis: {
    label: 'y'
  }
})
  • Playground 範例

params$

  • 型別:DeepPartial<XYAxesParams>

  • 欄位:

    名稱說明型別
    xAxisX 軸設定Object
    yAxisY 軸設定Object
  • params.xAxis, params.yAxis

    名稱說明型別
    labelOffset圖軸標籤位移[number, number]
    labelColorType圖軸標籤顏色類別ColorType
    axisLineVisible顯示圖軸線boolean
    axisLineColorType圖軸線顏色類別ColorType
    ticks刻度數量
    * number: 合適數量
    * null: 自動判斷
    number | null
    tickFormat列表圖示寬度string | ((text: d3.NumberValue) => string | d3.NumberValue
    tickLineVisible顯示刻度線boolean
    tickPadding刻度和文字的距離number
    tickFullLine將刻度線顯示在整個場景上boolean
    tickFullLineDasharray設定刻度線虛線格式(搭配tickFullLine為true)string
    tickColorType刻度顏色類別ColorType
    tickTextColorType刻度文字顏色類別ColorType
詳細型別
type ColorType = 'none' | 'label' | 'labelContrast' | 'primary' | 'secondary' | 'background'
  • 預設值:
{
  xAxis: {
    labelOffset: [0, 0],
    labelColorType: 'primary',
    axisLineVisible: false,
    axisLineColorType: 'primary',
    ticks: null,
    tickFormat: num => {
      if (num === null || Number.isNaN(num) == true) {
        return num || 0
      }
      var parts = num.toString().split('.')
      parts[0] = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, ',')
      return parts.join('.')
    },
    tickLineVisible: true,
    tickPadding: 20,
    tickFullLine: true,
    tickFullLineDasharray: 'none',
    tickColorType: 'secondary',
    tickTextColorType: 'primary'
  },
  yAxis: {
    labelOffset: [0, 0],
    labelColorType: 'primary',
    axisLineVisible: false,
    axisLineColorType: 'primary',
    ticks: null,
    tickFormat: num => {
      if (num === null || Number.isNaN(num) == true) {
        return num || 0
      }
      var parts = num.toString().split('.')
      parts[0] = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, ',')
      return parts.join('.')
    },
    tickLineVisible: true,
    tickPadding: 20,
    tickFullLine: true,
    tickFullLineDasharray: 'none',
    tickColorType: 'secondary',
    tickTextColorType: 'primary'
  }
}