连续型比例尺 Continuous Scales 用于将连续型的定义域映射到连续型的值域

该类型的比例尺（以下的 continuous）的常用方法：

• continuous.domain(domainArr) 设置或返回定义域。如果没有传递参数，则返回当前比例尺的定义域；如果传递数组，则将定义域范围设置为该数组。
  提示

  一般传递的数组必须包含两个元素，而且元素的类型是数值。如果数组的元素有多个（元素依次是递增或递减的），则可以创建映射关系更复杂的比例尺。⚠️ 如果定义域 domain 数组长度 M （元素个数）和值域 range 数组长度 N（元素个数） 不同，则映射的关系按照 min(N, M) 构建，超出范围的无法进行转换

  js

  // 创建一个线性比例尺
  const color = d3.scaleLinear()
      .domain([-1, 0, 1]) // 定义域是 -1 到 1，其中 -1 到 0 是一部分（负值），0 到 1 是另一部分（正值）
      .range(["red", "white", "green"]); // 负值映射的值域是从红色渐变到白色的 rgb 值；正值映射的值域是从白色渐变到绿色的 rgb 值
  
  color(-0.5); // "rgb(255, 128, 128)"
  color(+0.5); // "rgb(128, 192, 128)"
  

• continuous.range(rangeArr) 设置或返回值域。在传递数组设置值域时，数组的元素不必是数值，只要是插值器支持的类型就可以，例如颜色值。⚠️ 如果希望比例尺支持 continuous.invert(value) 则值域的类型需要是数值。
  提示

  如果希望同时设置值域和插值方法为 d3.interpolateRound（通过四舍五入插入整数），可以使用 continuous.rangeRound(rangeArr)，那么此时传递的数组的元素类型只能是数值

• continuous(value) 向比例尺传递一个定义域 domain 的值，返回相应的值域 range 的值
• continuous.invert(value) 向比例尺传递一个值域的 range 的值，反过来得到定义域 domain 的值。这对于交互很有用，例如根据鼠标在图表的位置，反向求出并显式对应的数据。⚠️ 该方法只支持值域为数值类型的比例尺，否则返回 NaN
• continuous.clamp(clampState) 当 continuous(value) 或 continuous.invert(value) 入参值超出定义域（或值域）的范围时，比例尺的行为会根据 clamp 而定。
  • 如果开启 clamping 钳位功能 clampState=true，比例尺返回的值会限制在相应范围内
  • 如果不开启 clamping 钳位功能 clampState=false，比例尺会进行推断得出超出范围的值
  js

  const x = d3.scaleLinear()
      .domain([10, 130])
      .range([0, 960]);
  
  // 默认不开启 clamping 钳位功能
  x(-10); // -160 超出值域范围
  x.invert(-160); // -10 超出定义域范围
  
  // 开启 clamping 钳位功能
  x.clamp(true);
  x(-10); // 0 结果被限制在值域中
  x.invert(-160); // 10 结果被限制在定义域中
  

• continuous.unknown(value) 设置当比例尺接受的入参为 undefined 或 NaN 时，应该返回的值。这对于数据集中存在部分缺失时很有用（当然最好是在数据清洗中进行处理），可以将数据项映射到一个特定的可视化属性值
• continuous.nice(count?) 编辑定义域的范围，通过四舍五入使其两端的值更「整齐」nice，例如对于定义域的原本范围是 [0.201479…, 0.996679…] 可以扩展为 [0.2, 1.0]。
  （可选）参数 count 是一个数字，用于设置该比例尺所对应的坐标轴的刻度线数量（D3 会以此作为一个参考值，最终生成的刻度线数量可能与 count 不同，以便刻度划分更合理）
  提示

  通过配置该参数可以影响扩展定义域的步长 step（确保在定义域上采样生成一系列刻度时，定义域正好是可以均分的，即所生成的刻度完全覆盖定义域），从而影响了定义域的调整方式

  js

  const x = d3.scaleLinear([0.241079, 0.969679], [0, 960]).nice(40);
  x.domain(); // [0.24, 0.98]
  

  注意

  该方法只会对比例尺已存在的定义域进行编辑扩展，对于之后（通过方法 continue.domain()）设置的定义域并不会自动处理

  如果要对之后再设置的定义域进行编辑扩展，需要在设置好定义域后，再一次调用该方法 continue.domain().nice()

• continuous.interpolate(interpolate) 自定义值域的插值函数
• continuous.ticks() 设置比例尺所对应的坐标轴的刻度（数量/间距频率）
• continuous.tickFormat() 设置比例尺所对应的坐标轴的刻度值的格式

• continuous.copy() 返回该比例尺的副本，可以对该复制的比例尺对象进行修改，并不影响原来的比例尺对象

D3 默认提供了以下 5 种连续型比例尺，可以调用相应的方法创建：

const x = d3.scaleLinear([10, 130], [0, 960]);
const color = d3.scaleLinear([10, 100], ["brown", "steelblue"]);

// 等价的方法

const x = d3.scaleLinear()
    .domain([10, 130])
    .range([0, 960]);

x(20); // 80
x(50); // 320

const color = d3.scaleLinear()
    .domain([10, 100])
    .range(["brown", "steelblue"]);

color(20); // "#9a3439"
color(50); // "#7b5167"

d3.scalePow()
  .exponent(0.5)

const x = d3.scaleTime()
    .domain([new Date(2000, 0, 1), new Date(2000, 0, 2)])
    .range([0, 960]);

x(new Date(2000, 0, 1,  5)); // 200
x(new Date(2000, 0, 1, 16)); // 640
x.invert(200); // Sat Jan 01 2000 05:00:00 GMT-0800 (PST) 地方时，PST 太平洋时区
x.invert(640); // Sat Jan 01 2000 16:00:00 GMT-0800 (PST)

它和连续型比例尺类似，也是将连续型的定义域映射到连续型的值域，但该比例尺的值域一般是指定一个插值器，一般用于颜色编码

使用方法 const sequential = d3.scaleSequential(domain, interpolator) 构建一个顺序比例尺

如果定义域省略，则默认使用 [0, 1]；如果值域（插值器）省略，则默认使用恒等函数 identity function

const rainbow = d3.scaleSequential(d3.interpolateRainbow);

该比例尺（以下的 sequential）除了有连续型比例尺的常用方法以外，还有一些不同的方法：

• sequential.interpolator(interpolator) 设置比例尺的插值器
• sequential.range(rangeArr) 设置插值的范围，D3 会将它转换为一个插值器

和连续型比例尺类似，顺序比例尺有一些衍生的比例尺，可以先对定义域的值进行幂、对数等运算，进行转换后再传递给插值器处理

• d3.scaleSequentialLog(domain, interpolator) 和 d3.scaleSequentialSqrt(domain, interpolator)
• d3.scaleSequentialPow(domain, interpolator) 和 d3.scaleSequentialSymlog(domain, interpolator)
• d3.scaleSequentialQuantile(domain, interpolator) 和分位数型比例尺类似

它和连续型比例尺类似，也是将连续型的定义域映射到连续型的值域，但该比例尺的定义域一般是由三个元素组成的数组，值域一般是指定一个插值器。一般用于颜色编码，例如 d3-scale-chromatic 模块中的 Diverging schemes 配色方案

使用方法 const diverging= d3.scaleDiverging(domain, interpolator) 构建一个发散比例尺，如果没有设置定义域，默认值为 [0, 0.5, 1]；如果没有设定插值器，则默认使用恒等函数 identity function

const spectral = d3.scaleDiverging(d3.interpolateSpectral);

分层比例尺 Quantize Scale 用于将连续型的定义域映射到离散型值域，一般通过四舍五入等修约 的方法将数据进行分层转换映射，以便将数据进行归类区分。

定义域的范围会根据离散型值域中可取值的数量划分为等距的片段，即每一个值域中离散值 $y$，都可以代表一段定义域范围 $y=m\space round(x)+b$，例如等值域图/分级统计地图

使用方法 d3.scaleQuantize(domain, range) 构建一个分层比例尺，如果省略了定义域或值域，则它默认范围是 [1, 0]，其作用就等价于 Math.round

const color = d3.scaleQuantize()
    .domain([0, 1])
    .range(["brown", "steelblue"]);

color(0.49); // "brown"
color(0.51); // "steelblue"

该类型的比例尺（以下的 quantize）的常用方法：

• quantize.domain(domainArr) 设置定义域，数组由两个元素组成一个范围，而且元素的类型是数值，而且按升序排列
• quantize.range(rangeArr) 设置值域，数组包含一些列离散的值
• quantize(value) 向比例尺传递一个定义域 domain 的值，返回相应的值域 range 的值
• quantize.invertExtent(value) 向比例尺传递一个值域的 range 的值，反过来得到定义域 domain 对应的片段
  js

  const width = d3.scaleQuantize()
      .domain([10, 100])
      .range([1, 2, 4]);
  
  width.invertExtent(2); // [40, 70]
  

• quantize.nice()

分位数型比例尺 Quantile Scales 将输入的数据作为总体（一堆通过采样获取的离散值），这样就可以接受在该总体范围中的任意值输入（即定义域是连续型），可以计算出它在总体中的分位数，然后基于分位数再找出在值域中一些列离散值中的那个对应值。

使用方法 d3.scaleQuantile(domain, range) 构建一个分位数比例尺

该类型的比例尺（以下的 quantile）的常用方法：

• quantile.domain(domainArr) 设置定义域，数组由一堆通过采样获取的离散值，而且元素的类型是数值，然后 D3 会对数组进行拷贝并对元素进行排序，作为总体用于计算分位数
• quantile.range(rangeArr) 设置值域，数组包含一些列离散的值
• quantile(value) 向比例尺传递一个定义域 domain 的值，返回相应的值域 range 的值
• quantile.invertExtent(value) 向比例尺传递一个值域的 range 的值，反过来得到定义域 domain 对应的片段
• quantile.quantiles() 根据值域 range 的离散值数量 n，对分位数进行分段，再根据各段的分位数可以计算出对应的定义域的 domain 的值，该方法就是返回 n-1 个阈值构成的数组。

阈值比例尺 Threshold Scales 和分层型比例尺 Quantize Scale 类似，不过映射规则更自由，定义域数组中各元素是阈值，可以更灵活地对定义域进行任意的划分，然后 D3 将各段定义域分别映射到值域各个离散值

使用方法 d3.scaleThreshold(domain, range) 构建一个阈值比例尺

const color = d3.scaleThreshold()
    .domain([0, 1])
    .range(["red", "white", "green"]);

color(-1);   // "red"
color(0);    // "white"
color(0.5);  // "white"
color(1);    // "green"
color(1000); // "green"

该类型的比例尺（以下的 threshold）的常用方法：

• threshold.domain(domainArr) 设置定义域，数组由一系列阈值组成，然后元素按升序排列
• threshold.range(rangeArr) 设置值域，数组包含一些列离散的值
  注意

  如果值域离散值数量是 N+1，则定义域数组中的阈值数量需要是 N。如果阈值数量少于期望的值，则相应的值域离散值会被忽略；如果阈值的数量多于期望的值，则在调用阈值比例尺时可能返回 undefined，因为在值域没有相应的离散值与该段定义域相对应。

• threshold(value) 向比例尺传递一个定义域 domain 的值，返回相应的值域 range 的值
• threshold.invertExtent(value) 向比例尺传递一个值域的 range 的值，反过来得到定义域 domain 对应的片段
  js

  const color = d3.scaleThreshold()
      .domain([0, 1])
      .range(["red", "white", "green"]);
  
  color.invertExtent("red"); // [undefined, 0]
  color.invertExtent("white"); // [0, 1]
  color.invertExtent("green"); // [1, undefined]
  

以下比例尺适用于定义域为离散型

排序比例尺 Ordinal Scales 用于将有序 ordinal/ordered 或无序 categorical/unordered 的离散型的定义域映射到离散型值域，例如将一系列类别名称，映射到不同的颜色中

使用方法 d3.scaleOrdinal(domain, range) 构建一个排序比例尺

const ordinal = d3.scaleOrdinal([0, 1, 2], ["A", "B", "C"]);

ordinal(0); // "A"
ordinal(1); // "B"
ordinal(2); // "C"

该类型的比例尺（以下的 ordinal）的常用方法：

• ordinal.domain(domainArr) 设置定义域，数组的第一个元素映射到值域的第一个元素，依此类推。
  提示

  其中对于 ordinal 比例尺并非一定要设置定义域。

  因为当使用该比例尺时 ordinal(value) 如果传入的值 value 不在定义域 domain 中，则该入参 value 会「隐式地」自动添加到定义域 domain 数组中，并按规则（先后顺序）对应到到值域中的一个值，所以最后返回的其实还是 range 值域中的一个值。

  根据这个工作方式，可以先不为该比例尺设置定义域。而是在不断地调用比例尺时，才不断记录和创建定义域，这样在下一次调用比例尺时，如果传入相同的值，就会映射得到相同的结果。

  提示

  如果定义域数量多于值域，就进行「循环」映射。

  注意

  D3 通过 Map 映射将各元素作为键与它们的索引进行匹配，再利用该索引获取值域的数组中相应的值，以此实现定义域和值域的映射。

  因此定义域的数组元素需要是原始类型，它们需要作为 Map 对象的键，而且每个元素应该是唯一的

• ordinal.range(rangeArr) 设置值域，数组的第一个元素映射到定义域的第一个元素，依此类推。如果值域的数组长度小于定义域的数组长度，则值域的元素会被从头重复使用进行映射，即进行 「循环」映射。
• ordinal(value) 向比例尺传递一个定义域 domain 的值，返回相应的值域 range 的值。
  说明

  如果 ordinal(value) 传入的值不在定义域中，则返回 unknown

  如果 unknown 的值是 implicit（默认值，即 d3.scaleImplicit 是一个 Symbol 值），则该入参 value 会「隐式地」自动添加到定义域 domain 数组中，并按规则（先后顺序）对应到到值域中的一个值，所以最后返回的其实还是 range 值域中的一个值

  可以使用方法 ordinal.unknown(valueForUnknown) 替代 unknown 的默认值，当 ordinal(value) 传入的值不在定义域中，返回的值就是固定为 valueForUnknown

带状比例尺 Band Scales 和排序比例尺类似，虽然定义域和离散的值域元素也是按索引依次对映的，但是值域的各值表示一个个连续区间。

该比例尺根据定义域数组的元素数量，将值域的范围分割为等距的各段，得到的每个值就表示相应的区间，其可视化效果就是一个个宽度相同的带状，该比例尺一般用于柱状图。

使用方法 d3.scaleBand(domain, range) 构建一个带状比例尺

const band = d3.scaleBand()
  .domain(["one", "two", "three", "four"])
  .range([0, 100])

该类型的比例尺（以下的 band）的常用方法：

• band.domain(domainArr) 设置定义域，数组的第一个元素映射到值域的第一个元素，依此类推。⚠️ 定义域数组的元素也需要是 原始类型
• band.range(rangeArr) 设置值域，它是一个数组，有两个元素指定整体范围（默认值是 [0, 1]），因此元素的类型是数值。D3 会根据定义域数值的元素数量，将值域的范围分割为等距的各段。
• band.rangeRound(rangeArr) 用于设定值域整体范围，并对两端进行四舍五入的修约，让两端的值为整数，使值域更适合可视化。该方法等价于以下操作
  js

  band.range(range)
      .round(true);
  

  提示

  如果值域范围不是定义域的数组元素的数量的整数倍，那么即使没有设置间隔 padding，最后生成的带状也会有外间隔，可以通过方法 band.align(alignValue) 来设置外间隔的分布

• band(value) 向比例尺传递一个定义域 domain 的值，返回相应区间的起始值。如果输入的值不在定义域中，则返回 undefined
• band.padding(padding) 设定值域的内外间隔，入参的值 $padding \le 1$ 表示间隔占据区间的比例大小
  提示

  如果希望分别设置各区间之间的间隔和值域两端的间隔，可以分别使用方法 band.paddingInner(padding) 和方法 band.paddingOuter(padding)

• band.align(alignValue) 入参的值 $align \le 1$ 用以设置外间隔的分布方式。如果 align=0.5（默认值）则两外侧的间隔相同，即这些 bands 居中，如果 align=0 或 align=1 则它们会向一侧偏移。
• band.bandwidth() 返回 band 的宽度，不包含 padding
• band.step() 返回「步长」，即 band 的宽度和 padding 的宽度之和

点状比例尺 Point Scales 和带状比例尺类似，就像是将 band 的宽度设置为 $0$

该比例尺将根据定义域数组的离散元素的数量，将值域的范围分割为等距的各段，各个分隔点与定义域中的离散元素依次映射，该比例尺一般用于散点图。

使用方法 d3.scalePoint(domain, range) 构建一个点状比例尺

该类型的比例尺的常用方法和带状比例尺类似

比例尺模块只是提供了各种数据转换的规则方法，并不能生成视觉元素，一般会搭配坐标轴 d3-axis 模块使用，该模块可以基于比例尺 scale 在页面生成相应的坐标轴。

可以使用以下 4 种方法构建不同反向的坐标轴（其中参数 scale 是生成坐标轴时所使用的比例尺）

• d3.axisTop(scale) 生成一个朝上的坐标轴，即其刻度在水平轴线的上方
• d3.axisBottom(scale) 生成一个朝下的坐标轴，即其刻度在水平轴线的下方
• d3.axisRight(scale) 生成一个朝右的坐标轴，即其刻度在竖直轴线的右方
• d3.axisLeft(scale) 生成一个朝左的坐标轴，即其刻度在竖直轴线的左方

D3 构建出来的坐标轴是有一系列 SVG 元素构成：

• 轴线由 <path> 路径元素构成，它带有类名 domain
• 刻度是和刻度值分别由元素 <line> 和 <text> 构成。每一刻度和相应的刻度值都包裹在一个 <g> 元素中，它带有类名 tick

<!-- 渲染在页面上的坐标轴模板 -->
<!-- 一般会使用一个 g 元素包裹坐标轴的所有元素，便于对整体设置样式，例如 transform -->
<g fill="none" font-size="10" font-family="sans-serif" text-anchor="middle">
  <path class="domain" stroke="currentColor" d="M0.5,6V0.5H880.5V6"></path>
  <g class="tick" opacity="1" transform="translate(0.5,0)">
    <line stroke="currentColor" y2="6"></line>
    <text fill="currentColor" y="9" dy="0.71em">0.0</text>
  </g>
  <g class="tick" opacity="1" transform="translate(176.5,0)">
    <line stroke="currentColor" y2="6"></line>
    <text fill="currentColor" y="9" dy="0.71em">0.2</text>
  </g>
  <g class="tick" opacity="1" transform="translate(352.5,0)">
    <line stroke="currentColor" y2="6"></line>
    <text fill="currentColor" y="9" dy="0.71em">0.4</text>
  </g>
  <g class="tick" opacity="1" transform="translate(528.5,0)">
    <line stroke="currentColor" y2="6"></line>
    <text fill="currentColor" y="9" dy="0.71em">0.6</text>
  </g>
  <g class="tick" opacity="1" transform="translate(704.5,0)">
    <line stroke="currentColor" y2="6"></line>
    <text fill="currentColor" y="9" dy="0.71em">0.8</text>
  </g>
  <g class="tick" opacity="1" transform="translate(880.5,0)">
    <line stroke="currentColor" y2="6"></line>
    <text fill="currentColor" y="9" dy="0.71em">1.0</text>
  </g>
</g>

使用以上 4 种方法之一构建出来的坐标轴对象 axis ，也是一个方法，它接受一个 SVG 元素 axis(context) 将坐标轴在其内部渲染出来。

d3.select("g")
  .call(axis);

export default function() {
  var callback = arguments[0];
  arguments[0] = this;
  callback.apply(null, arguments);
  return this;
}

function name(selection, first, last) {
  selection
      .attr("first-name", first)
      .attr("last-name", last);
}

d3.selectAll("div").call(name, "John", "Snow");

// 等价以下的操作
name(d3.selectAll("div"), "John", "Snow");

坐标轴对象（以下的 axis）还有一些常用方法：

• axis.scale([scale]) 如果传递了参数，基于新的比例尺生成新的坐标轴；如果没有传递参数，返回当前的坐标轴
• axis.ticks(arguments…) 或 axis.tickArguments([arguments]) 设置坐标轴的刻度间隔和刻度值的格式，不同类型的比例尺可以传递不同的参数，一般是设定刻度的数量 count（或对于时间比例尺是时间间隔 interval）和刻度值的格式 specifier
  💡 该方法对于无法提供 scale.ticks 的比例尺无效，例如带状比例尺和点状比例尺
  js

  // 时间坐标轴上，每隔 15 分钟设定一个刻度
  axis.ticks(d3.timeMinute.every(15));
  axis.tickArguments([d3.timeMinute.every(15)]);
  

• axis.tickValues([values]) 如果传递了数组，则用该数组的元素覆盖比例尺自动生成的刻度值；如果 values=null 则清除之前设置的刻度值，并使用比例尺自动生成的刻度值；如果没有传递参数，则返回当前的刻度值（默认值是 null，则使用比例尺自动生成的刻度值）
  js

  var xAxis = d3.axisBottom(scale)
      .tickValues([1, 2, 3, 5, 8, 13, 21]);
  

• axis.tickFormat([format]) 设定刻度值的格式（时间格式）
• axis.tickSize([size]) 设定内侧刻度和外侧刻度的长度，默认值是 6
  内侧刻度和外侧刻度不同，内侧刻度是一个个单独的 line 元素，而外侧刻度是坐标轴最外侧两端的刻度线，它是轴线 path 元素的一部分。
• axis.tickSizeInner([size]) 和 axis.tickSizeOuter([size]) 分别设置内侧刻度和外侧刻度的长度
• axis.tickPadding([padding]) 设置刻度线和刻度文本之间的间距，默认值是 3 像素
• axis.offset([offset]) 设置坐标轴的偏移，默认值是 0

从比例尺构建坐标轴的一般流程：

• 基于抽象数据和图形符号的属性构建合适比例尺
• 基于比例尺构建特定方向的坐标轴
• 将坐标轴添加到页面上