logo

G2

  • 文档
  • 图表介绍
  • API
  • 图表示例
  • 主题
  • 周边生态
  • 所有产品antv logo arrow
  • 5.3.3
  • 快速上手
  • 简介
    • 什么是 G2
    • 在前端框架中使用
    • Spec 和 API
  • 核心概念
    • 图表(Chart)
      • G2 图表组成
      • 如何使用图表
    • 标记(Mark)
      • 概览
      • area
      • box
      • boxplot
      • cell
      • chord
      • density
      • gauge
      • heatmap
      • image
      • interval
      • line
      • lineX
      • lineY
      • link
      • liquid
      • sunburst
      • point
      • polygon
      • range
      • rangeX
      • rangeY
      • rect
      • shape
      • text
      • vector
      • wordCloud
    • 视图(View)
    • 数据(Data)
      • 概览
      • custom
      • ema
      • fetch
      • filter
      • fold
      • inline
      • join
      • kde
      • log
      • map
      • pick
      • rename
      • slice
      • sort
      • sortBy
    • 编码(Encode)
    • 比例尺(Scale)
      • 概览
      • band
      • linear
      • log
      • ordinal
      • point
      • quantile
      • quantize
      • sqrt
      • threshold
      • time
      • pow
    • 转换(Transform)
      • 概览
      • bin
      • binX
      • diffY
      • dodgeX
      • flexX
      • group
      • groupColor
      • groupX
      • groupY
      • jitter
      • jitterX
      • jitterY
      • normalizeY
      • pack
      • sample
      • select
      • selectX
      • selectY
      • sortColor
      • sortX
      • sortY
      • stackEnter
      • stackY
      • symmetryY
    • 坐标系(Coordinate)
      • 概览
      • fisheye
      • parallel
      • polar
      • theta
      • transpose
      • radial
      • cartesian3D
      • helix
    • 样式(Style)
    • 动画(Animate)
      • 概览
      • fadeIn
      • fadeOut
      • growInX
      • growInY
      • morphing
      • pathIn
      • scaleInX
      • scaleInY
      • scaleOutX
      • scaleOutY
      • waveIn
      • zoomIn
      • zoomOut
    • 状态(State)
    • 交互(Interaction)
      • 概览
      • brushAxisHighlight
      • brushHighlight
      • brushXHighlight
      • brushYHighlight
      • brushFilter
      • brushXFilter
      • brushYFilter
      • chartIndex
      • elementHighlight
      • elementHighlightByColor
      • elementHighlightByX
      • elementSelect
      • elementSelectByColor
      • elementSelectByX
      • fisheye
      • legendFilter
      • legendHighlight
      • poptip
      • scrollbarFilter
      • sliderFilter
    • 复合(Composition)
      • 概览
      • facetCircle
      • facetRect
      • repeatMatrix
      • spaceFlex
      • spaceLayer
      • timingKeyframe
    • 主题(Theme)
      • 概览
      • academy
      • classic
      • classicDark
    • 事件(Event)
    • 颜色映射(Color)
  • 图表 API
  • 图表组件
    • 标题(Title)
    • 坐标轴(Axis)
    • 图例(Legend)
    • 滚动条(Scrollbar)
    • 缩略轴(Slider)
    • 提示信息(Tooltip)
    • 数据标签(Label)
  • 进阶主题
    • 关系图(Graph)
      • forceGraph
      • pack
      • sankey
      • tree
      • treemap
    • 地图(Geo)
      • geoPath
      • geoView
    • 3D 图表(3D Chart)
      • 绘制 3D 图表
      • point3D
      • line3D
      • interval3D
      • surface3D
    • 插件扩展(Plugin)
      • renderer
      • rough
      • lottie
      • a11y
    • 按需打包
    • 设置纹理
    • 服务端渲染(SSR)
    • Spec 函数表达式支持 (5.3.0 支持)
  • 版本特性
    • 新版本特性
    • v4 升级 v5 指南
  • 常见问题 FAQ

log

上一篇
linear
下一篇
ordinal

Resources

Ant Design
Galacea Effects
Umi-React 应用开发框架
Dumi-组件/文档研发工具
ahooks-React Hooks 库

社区

体验科技专栏
seeconfSEE Conf-蚂蚁体验科技大会

帮助

GitHub
StackOverflow

more products更多产品

Ant DesignAnt Design-企业级 UI 设计语言
yuque语雀-知识创作与分享工具
EggEgg-企业级 Node 开发框架
kitchenKitchen-Sketch 工具集
GalaceanGalacean-互动图形解决方案
xtech蚂蚁体验科技
© Copyright 2025 Ant Group Co., Ltd..备案号:京ICP备15032932号-38

Loading...

概述

G2 中 对数比例尺(log scale) 是使用对数函数进行数据映射,基于指数关系的非线性分布,针对呈现指数增长的数据。当 data 中的数值范围跨度很大而导致部分图形密集或者空白过多时,可以优先考虑使用。

基于数学公式 y = log(base) + b 。

  • 线性比例尺(linear scale)

  • 对数比例尺(log scale)

使用方式

import { Chart } from '@antv/g2';
const chart = new Chart({
container: 'container',
});
chart.options({
type: 'view',
autoFit: true,
height: 300,
data: [
{ year: '1991', value: 1 },
{ year: '1992', value: 10 },
{ year: '1993', value: 100 },
{ year: '1994', value: 1000 },
{ year: '1995', value: 10000 },
],
encode: { x: 'year', y: 'value' },
scale: {
y: {
type: 'log',
// 刻度数
tickCount: 5,
// 生成均匀的刻度
tickMethod: (min, max, count, base) => {
// 计算对数范围
const logMin = Math.log(min) / Math.log(base);
const logMax = Math.log(max) / Math.log(base);
// 计算对数步长
const logStep = (logMax - logMin) / (count - 1);
// 生成刻度数组
const ticks = [];
for (let i = 0; i < count; i++) {
const logValue = logMin + i * logStep;
const value = Math.pow(base, logValue);
// 过滤超出范围的值
if (value >= min && value <= max) {
ticks.push(Math.round(value));
}
}
return ticks;
},
},
},
children: [
{ type: 'line', labels: [{ text: 'value', style: { dx: -10, dy: -12 } }] },
{ type: 'point', style: { fill: 'white' }, tooltip: false },
],
});
chart.render(); // 渲染图标

选项

属性描述类型默认值必选
domain设置数据的定义域范围number[]输入数据的最大最小值范围
domainMin设置数据的定义域最小值number输入数据的最小值
domainMax设置数据的定义域最大值number输入数据的最大
range设置数据映射的值域范围number[] | string[][0, 1]
rangeMin设置数据映射的值域最小值number | string0
rangeMax设置数据映射的值域最大值number | string1
unknown对于 undefined, NaN,null 空值,返回的数据anyundefined
tickCount设置推荐的 tick 生成数量,tickCount 只是建议值,不会完全按照这个值产生 ticknumber5
tickMethod设置生成 tick 的方法,常用于自定义 tick(min: number, max: number, count: number) => number[]calculateLogTicks
round输出值去四舍五入booleanfalse
clamp将映射值限定在 range 的范围内booleanfalse
nice扩展 domain 范围,让输出的 tick 展示得更加友好booleanfalse
interpolate自定义差值函数(a: number, b: number) => (t: number) => T(a, b) => (t) => a * (1 - t) + b * t
base设定对数底number10

配置及注意事项:

{
scale: {
y: {
type: 'log', // 注意 当数据返回跨度正负数的时候,请勿使用 log。
domainMin: 10,
domainMax: 1000,
base: 100, // 设置 base 底数为 100,
}
}
}

如果需要最小值 domainMin:0 的情况, 可参考 图表示例 - 对数柱形图页面。

示例

格式化转化为 linear

import { Chart } from '@antv/g2';
const chart = new Chart({
container: 'container',
});
chart.options({
type: 'view',
autoFit: true,
height: 300,
data: [
{ year: '1991', value: 1 },
{ year: '1992', value: 10 },
{ year: '1993', value: 1000 },
{ year: '1994', value: 0.1 },
{ year: '1995', value: 100 },
],
encode: { x: 'year', y: 'value' },
scale: { x: { range: [0, 1] }, y: { type: 'log', tickCount: 4 } },
axis: {
y: {
labelFormatter: (v) => {
return Math.log10(v) + 1;
},
},
},
children: [
{
type: 'line',
labels: [
{
text: 'value',
formatter: (v) => {
return Math.log10(v) + 1;
},
style: { dx: -10, dy: -12 },
},
],
},
{ type: 'point', style: { fill: 'white' }, tooltip: false },
],
});
chart.render(); // 渲染图标