D3圖形庫API參考

github發表於2015-01-10
API

D3 庫所提供的所有 API 都在 d3 名稱空間下。d3 庫使用語義版本命名法（Semantic versioning）。 你可以用 d3.version 檢視當前的版本資訊。

d3 (核心部分)

選擇集

  • d3.select - 從當前文件中選擇一系列元素。
  • d3.selectAll - 從當前文件中選擇多項元素。
  • selection.attr - 設定或獲取指定屬性。
  • selection.classed - 新增或刪除選定元素的 CSS 類（CSS class）。
  • selection.style - 設定或刪除 CSS 屬性。style優先順序高於attr。
  • selection.property - 設定或獲原生的屬性值（raw property）。
  • selection.text - 設定或獲取選定元素的標籤體文字內容。
  • selection.html - 設定或獲取選定元素的 HTML 內容（類似 innerHTML ）
  • selection.append - 建立並新增新元素到選定元素後。
  • selection.insert - 建立並新增新元素到選定元素前。
  • selection.remove - 從當前文件物件中刪除選定的元素。
  • selection.data - 設定或獲取一組元素的繫結資料（get or set data for a group of elements, while computing a relational join.）
  • selection.enter - 返回缺失元素的佔位物件（placeholder），指向繫結的資料中比選定元素集多出的一部分元素。
  • selection.exit - 返回多餘元素的元素集，即選擇元素中比繫結資料多出的一部分。(關於data, enter, exit原理的示例1, 示例2, 示例3)
  • selection.datum - 設定或獲取單獨元素的資料，不進行關聯。（get or set data for individual elements, without computing a join.）
  • selection.filter - 根據繫結的資料過濾選擇集。
  • selection.sort - 根據繫結的資料對選擇的元素進行排序。
  • selection.order - 對文件中的元素重排序以匹配選擇集。
  • selection.on - 新增或刪除事件監聽器。
  • selection.transition - 啟動一個過渡效果（返回 Transition 物件），可以理解為動畫。
  • selection.interrupt - 立即停止所有正在進行的動畫動作。
  • selection.each - 為每個選擇的元素集呼叫指定的函式。
  • selection.call - 為當前選擇的元素集呼叫指定的函式。
  • selection.empty - 測試選擇集是否為空。
  • selection.node - 返回選擇集中的第一個元素。
  • selection.size - 返回選擇集中的元素個數。
  • selection.select - 選擇所選的元素中的第一個子元素組成新的選擇集。
  • selection.selectAll - 選擇所選的元素中的多個子元素組成新的選擇集。
  • d3.selection - 選擇集物件原型（可通過 d3.selection.prototype 為選擇集增強功能）。
  • d3.event - 獲取當前互動的使用者事件。
  • d3.mouse - 獲取滑鼠的相對某元素的座標。
  • d3.touches - 獲取相對某元素的觸控點座標。

過渡效果

  • d3.transition - 開始一個動畫過渡。簡單教程
  • transition.delay - 指定每個元素過渡的延遲時間（單位：毫秒ms）。
  • transition.duration - 指定每個元素過渡的持續時間（單位：毫秒ms）。
  • transition.ease - 指定過渡的緩衝函式。
  • transition.attr - 平滑過渡到新的attr屬性值（起始屬性值為當前屬性）。
  • transition.attrTween - 在不同attr屬性值之間平滑過渡（起始屬性值可在過渡函式中設定,甚至整個過渡函式都可以自定義）。
  • transition.style - 平滑過渡到新的style屬性值。
  • transition.styleTween - 在不同style屬性值之間平滑過渡。
  • transition.text - 在過渡開始時設定文字內容。
  • transition.tween - 使某個屬性過渡到一個新的屬性值，該屬性可以是非attr或非style屬性，比如text。
  • transition.select - 選擇每個當前元素的某個子元素進行過渡。
  • transition.selectAll - 選擇每個當前元素的多個子元素進行過渡。
  • transition.filter - 通過資料篩選出當前元素中的部分元素進行過渡。
  • transition.transition - 當前過渡結束後開始新的過渡。
  • transition.remove - 過渡結束後移除當前元素。
  • transition.empty - 如果過渡為空就返回true。如果當前元素中沒有非null元素，則此過渡為空。
  • transition.node - 返回過渡中的第一個元素。
  • transition.size - 返回過渡中當前元素的數量。
  • transition.each - 遍歷每個元素執行操作。不指定觸發型別時，立即執行操作。當指定觸發型別為’start’或’end’時,會在過渡開始或結束時執行操作。
  • transition.call - 以當前過渡為this執行某個函式。
  • d3.ease - 定製過渡的緩衝函式。
  • ease - 緩衝函式。緩衝函式可讓動畫效果更自然，比如elastic緩衝函式可用以模擬彈性物體的運動。是一種插值函式的特例。
  • d3.timer - 開始一個定製的動畫計時。功能類似於setTimeout，但內部用requestAnimationFrame實現，更高效。
  • d3.timer.flush - 立刻執行當前沒有延遲的計時。可用於處理閃屏問題。
  • d3.interpolate - 生成一個插值函式，在兩個引數間插值。差值函式的型別會根據輸入引數的型別（數字、字串、顏色等）而自動選擇。
  • interpolate - 插值函式。輸入引數在[0, 1]之間。
  • d3.interpolateNumber - 在兩個數字間插值。
  • d3.interpolateRound - 在兩個數字間插值，返回值會四捨五入取整。
  • d3.interpolateString - 在兩個字串間插值。解析字串中的數字，對應的數字會插值。
  • d3.interpolateRgb - 在兩個RGB顏色間插值。
  • d3.interpolateHsl - 在兩個HSL顏色間插值。
  • d3.interpolateLab - 在兩個L*a*b*顏色間插值。
  • d3.interpolateHcl - 在兩個HCL顏色間插值。
  • d3.interpolateArray - 在兩個數列間插值。d3.interpolateArray( [0, 1], [1, 10, 100] )(0.5); // returns [0.5, 5.5, 100]
  • d3.interpolateObject - 在兩個object間插值。d3.interpolateArray( {x: 0, y: 1}, {x: 1, y: 10, z: 100} )(0.5); // returns {x: 0.5, y: 5.5, z: 100}
  • d3.interpolateTransform - 在兩個2D仿射變換間插值。
  • d3.interpolateZoom - 在兩個點之間平滑地縮放平移。示例
  • d3.interpolators - 新增一個自定義的插值函式.

資料操作(Working with Arrays)

  • d3.ascending - 升序排序函式.
  • d3.descending - 降序排序函式.
  • d3.min - 獲取陣列中的最小值.
  • d3.max - 獲取陣列中的最大值.
  • d3.extent - 獲取陣列的範圍(最小值和最大值).
  • d3.sum - 獲取陣列中數字之和.
  • d3.mean -獲取陣列中數字的算術平均值.
  • d3.median - 獲取陣列中數字的中位數 (相當於 0.5-quantile的值).
  • d3.quantile - 獲取排好序的陣列的一個分位數(quantile).
  • d3.bisect - 通過二分法獲取某個數在排好序的陣列中的插入位置(同d3.bisectRight).
  • d3.bisectRight - 獲取某個數在排好序的陣列中的插入位置(相等的值歸入右邊).
  • d3.bisectLeft - 獲取某個數在排好序的陣列中的插入位置(相等的值歸入左邊).
  • d3.bisector - 自定義一個二分函式.
  • d3.shuffle - 洗牌，隨機排列陣列中的元素.
  • d3.permute - 以指定順序排列陣列中的元素.
  • d3.zip - 將多個陣列合併成一個陣列的陣列，新陣列的的第i個元素是原來各個陣列中第i個元素組成的陣列.
  • d3.transpose - 矩陣轉置，通過d3.zip實現.
  • d3.pairs - 返回臨近元素對的陣列，d3.pairs([1, 2, 3, 4]); // returns [ [1, 2], [2, 3], [3, 4] ].
  • d3.keys - 返回關聯陣列(雜湊表、json、object物件)的key組成的陣列.
  • d3.values - 返回關聯陣列的value組成的陣列.
  • d3.entries - 返回關聯陣列的key-value實體組成的陣列, d3.entries({ foo: 42 }); // returns [{key: "foo", value: 42}].
  • d3.merge - 將多個陣列連成一個，類似於原生方法concat. d3.merge([ [1], [2, 3] ]); // returns [1, 2, 3].
  • d3.range - 獲得一個數列. d3.range([start, ]stop[, step])
  • d3.nest - 獲得一個nest物件，將陣列組織成層級結構. 示例：http://bl.ocks.org/phoebebright/raw/3176159/
  • nest.key - 為nest層級結構增加一個層級.
  • nest.sortKeys - 將當前的nest層級結構按key排序.
  • nest.sortValues - 將葉nest層級按value排序.
  • nest.rollup - 設定修改葉節點值的函式.
  • nest.map - 執行nest操作, 返回一個關聯陣列(json).
  • nest.entries - 執行nest操作, 返回一個key-value陣列. 如果nest.map返回的結果類似於{ foo: 42 }, 則nest.entries返回的結果類似於[{key: "foo", value: 42}].
  • d3.map - 將javascript的object轉化為hash,遮蔽了object的原型鏈功能導致的與hash不一致的問題。
  • map.has - map有某個key就返回true.
  • map.get - 返回map中某個key對應的value.
  • map.set - 設定map中某個key對應的value.
  • map.remove - 刪除map中的某個key.
  • map.keys - 返回map中所有key組成的陣列.
  • map.values - 返回map中所有value組成的陣列.
  • map.entries - 返回map中所有entry（key-value鍵值對）組成的陣列.類似於{ foo: 42 }轉化成[{key: "foo", value: 42}]
  • map.forEach - 對map中每一個entry執行某個函式.
  • d3.set - 將javascript的array轉化為set,遮蔽了array的object原型鏈功能導致的與set不一致的問題。set中的value是array中每個值轉換成字串的結果。set中的value是去重過的。
  • set.has - 返回set中是否含有某個value.
  • set.add - 新增某個value.
  • set.remove - 刪除某個value.
  • set.values - 返回set中的值組成的陣列.set中的value是去重過的.
  • set.forEach - 對set中每一個value執行某個函式.

Math

  • d3.random.normal - 利用正態分佈產生一個隨機數.
  • d3.random.logNormal - 利用對數正態分佈產生一個隨機數.
  • d3.random.irwinHall - 利用Irwin–Hall分佈（簡單可行並且容易程式設計的正態分佈實現方法）產生一個隨機數.
  • d3.transform - 將svg的tranform格式轉化為標準的2D轉換矩陣字串格式.

載入外部資源(Loading External Resources)

  • d3.xhr - 發起XMLHttpRequest請求獲取資源。
  • xhr.header - 設定 request header。
  • xhr.mimeType - 設定 Accept request header，並重寫 response MIME type。
  • xhr.response - 設定response返回值轉化函式。如 function(request) { return JSON.parse(request.responseText); }
  • xhr.get - 發起GET請求。
  • xhr.post - 發起POST請求。
  • xhr.send - 以指定的方法和資料發起請求。
  • xhr.abort - 終止當前請求。
  • xhr.on - 為請求新增”beforesend”, “progress”, “load” 或 “error” 等事件監聽器。
  • d3.text - 請求一個text檔案。
  • d3.json - 請求一個JSON。
  • d3.html - 請求一個html文字片段。
  • d3.xml - 請求一個XML文字片段。
  • d3.csv - 請求一個CSV(comma-separated values, 逗號分隔值)檔案。
  • d3.tsv - 請求一個TSV(tab-separated values, tab分隔值)檔案。

字串格式化(String Formatting)

  • d3.format - 將數字轉化成指定格式的字串。轉化的格式非常豐富，且非常智慧。
  • d3.formatPrefix - 以指定的值和精度獲得一個[SI prefix]物件。這個函式可用來自動判斷資料的量級， 如K(千)，M(百萬)等等。示例: var prefix = d3.formatPrefix(1.21e9); console.log(prefix.symbol); // “G”; console.log(prefix.scale(1.21e9)); // 1.21
  • d3.requote - 將字串轉義成可在正規表示式中使用的格式。如 d3.requote(‘$’); // return “\$”
  • d3.round - 設定某個數按小數點後多少位取整。與toFixed()類似，但返回格式為number。 如 d3.round(1.23); // return 1; d3.round(1.23, 1); // return 1.2; d3.round(1.25, 1); // return 1.3

CSV 格式化 (d3.csv)

  • d3.csv - 獲取一個CSV (comma-separated values, 冒號分隔值)檔案。
  • d3.csv.parse - 將CSV檔案字串轉化成object的陣列，object的key由第一行決定。如： [{"Year": "1997", "Length": "2.34"}, {"Year": "2000", "Length": "2.38"}]
  • d3.csv.parseRows - 將CSV檔案字串轉化成陣列的陣列。如： [ ["Year", "Length"],["1997", "2.34"],["2000", "2.38"] ]
  • d3.csv.format - 將object的陣列轉化成CSV檔案字串，是d3.csv.parse的逆操作。
  • d3.csv.formatRows - 將陣列的陣列轉化成CSV檔案字串，是d3.csv.parseRows的逆操作。
  • d3.tsv - 獲取一個TSV (tab-separated values, tab分隔值)檔案。
  • d3.tsv.parse - 類似於d3.csv.parse。
  • d3.tsv.parseRows - 類似於d3.csv.parseRows。
  • d3.tsv.format - 類似於d3.csv.format。
  • d3.tsv.formatRows - 類似於d3.csv.formatRows。
  • d3.dsv - 建立一個類似於d3.csv的檔案處理物件，可以自定義分隔符和mime type。如：var dsv = d3.dsv(“|”, “text/plain”);

顏色

  • d3.rgb - 指定一種顏色，建立一個RGB顏色物件。支援多種顏色格式的輸入。
  • rgb.brighter - 增強顏色的亮度，變化幅度由引數決定。
  • rgb.darker - 減弱顏色的亮度，變化幅度由引數決定。
  • rgb.hsl - 將RGB顏色物件轉化成HSL顏色物件。
  • rgb.toString - RGB顏色轉化為字串格式。
  • d3.hsl - 建立一個HSL顏色物件。支援多種顏色格式的輸入。
  • hsl.brighter - 增強顏色的亮度，變化幅度由引數決定。
  • hsl.darker - 減弱顏色的亮度，變化幅度由引數決定。
  • hsl.rgb - 將HSL顏色物件轉化成RGB顏色物件。
  • hsl.toString - HSL顏色轉化為字串格式。
  • d3.lab - 建立一個Lab顏色物件。支援多種顏色格式的輸入。
  • lab.brighter - 增強顏色的亮度，變化幅度由引數決定。
  • lab.darker - 減弱顏色的亮度，變化幅度由引數決定。
  • lab.rgb - 將Lab顏色物件轉化成RGB顏色物件。
  • lab.toString - Lab顏色轉化為字串格式。
  • d3.hcl - 建立一個HCL顏色物件。支援多種顏色格式的輸入。
  • hcl.brighter - 增強顏色的亮度，變化幅度由引數決定。
  • hcl.darker - 減弱顏色的亮度，變化幅度由引數決定。
  • hcl.rgb - 將HCL顏色物件轉化成RGB顏色物件。
  • hcl.toString - HCL顏色轉化為字串格式。

名稱空間

  • d3.ns.prefix - 獲取或擴充套件已知的XML名稱空間。
  • d3.ns.qualify - 驗證名稱空間字首是否存在, 如”xlink:href”中xlink是已知的名稱空間。

內部方法（Internals）

  • d3.functor - 函式化。將非函式變數轉化為只返回該變數值的函式。輸入函式，則返回原函式；輸入值，則返回一個函式，該函式只返回原值。
  • d3.rebind - 將一個物件的方法繫結到另一個物件上。
  • d3.dispatch - 建立一個定製的事件。
  • dispatch.on - 新增或移除一個事件監聽器。對一個事件可新增多個監聽器。
  • dispatch.type - 觸發事件。其中‘type’為要觸發的事件的名稱。

d3.scale(Scales)

定量變換(Quantitative)

  • d3.scale.linear - 建立一個線性定量變換。（建議參考原始碼以深入理解各種變換。）
  • linear - 輸入一個定義域的值，返回一個值域的值。
  • linear.invert - 反變換，輸入值域值返回定義域值。
  • linear.domain - get或set定義域。
  • linear.range - get或set值域。
  • linear.rangeRound - 設定值域，並對結果取整。
  • linear.interpolate - get或set變換的插值函式，如將預設的線性插值函式替換成取整的線性插值函式d3_interpolateRound。
  • linear.clamp - 設定值域是否閉合，預設不閉合。當值域閉合時，如果插值結果在值域之外，會取值域的邊界值。如值域為[1, 2],插值函式的計算結果為3，如果不閉合，最終結果為3；如果閉合，最終結果為2。
  • linear.nice - 擴充套件定義域範圍使定義域更規整。如[0.20147987687960267, 0.996679553296417] 變成 [0.2, 1]。
  • linear.ticks - 從定義域中取出有代表性的值。通常用於座標軸刻度的選取。
  • linear.tickFormat - 獲取格式轉化函式，通常用於座標軸刻度的格式轉化。如：var x = d3.scale.linear().domain([-1, 1]); console.log(x.ticks(5).map(x.tickFormat(5, “+%”))); // ["-100%", "-50%", "+0%", "+50%", "+100%"]
  • linear.copy - 從已有的變換中複製出一個變換。
  • d3.scale.sqrt - 建立一個求平方根的定量轉換。
  • d3.scale.pow - 建立一個指數變換。（可參考linear對應函式的註釋）
  • pow - 輸入一個定義域的值，返回一個值域的值。
  • pow.invert - 反變換，輸入值域值返回定義域值。
  • pow.domain - get或set定義域。
  • pow.range - get或set值域。
  • pow.rangeRound - 設定值域，並對結果取整。
  • pow.interpolate - get或set變換的插值函式。
  • pow.clamp - 設定值域是否閉合，預設不閉合。
  • pow.nice - 擴充套件定義域範圍使定義域更規整。
  • pow.ticks - 從定義域中取出有代表性的值。通常用於座標軸刻度的選取。
  • pow.tickFormat - 獲取格式轉化函式，通常用於座標軸刻度的格式轉化。
  • pow.exponent - get或set指數的冪次。預設為1次冪。
  • pow.copy - 從已有的變換中複製出一個變換。
  • d3.scale.log - 建立一個對數變換。（可參考linear對應函式的註釋）
  • log - 輸入一個定義域的值，返回一個值域的值。
  • log.invert - 反變換，輸入值域值返回定義域值。
  • log.domain - get或set定義域。
  • log.range - get或set值域。
  • log.rangeRound - 設定值域，並對結果取整。
  • log.interpolate - get或set變換的插值函式。
  • log.clamp - 設定值域是否閉合，預設不閉合。
  • log.nice - 擴充套件定義域範圍使定義域更規整。
  • log.ticks - 從定義域中取出有代表性的值。通常用於座標軸刻度的選取。
  • log.tickFormat - 獲取格式轉化函式，通常用於座標軸刻度的格式轉化。
  • log.copy - 從已有的變換中複製出一個變換。
  • d3.scale.quantize - 建立一個quantize線性變換,定義域為一個數值區間，值域為幾個離散值。
  • quantize - 輸入數值，返回離散值。如： var q = d3.scale.quantize().domain([0, 1]).range(['a', 'b', 'c']); //q(0.3) === ‘a’, q(0.4) === ‘b’, q(0.6) === ‘b’, q(0.7) ===’c;
  • quantize.invertExtent - 返回得到某個離散值的值域範圍。 // q.invertExtent(‘a’) 的結果為 [0, 0.3333333333333333]
  • quantize.domain - get或set變換的定義域。
  • quantize.range - get或set變換的值域。
  • quantize.copy - 從已有的變換中複製出一個變換。
  • d3.scale.threshold - 構建一個threshold(閾值)線性變換。定義域為分隔值數值序列，值域為離散值。它與quantize的區別是quantize指定的值域為一個區間，然後均分這個區間為多個小區間，以對應各離散值。threshold則指定各小區間的邊界分隔值。示例: var t = d3.scale.threshold().domain([0, 1]).range(['a', 'b', 'c']); t(-1) === ‘a’; t(0) === ‘b’; t(0.5) === ‘b’; t(1) === ‘c’; t(1000) === ‘c’; t.invertExtent(‘a’); //returns [undefined, 0] t.invertExtent(‘b’); //returns [0, 1] t.invertExtent(‘c’); //returns [1, undefined]
  • threshold - 輸入數值，返回離散值。
  • threshold.invertExtent - 輸入離散值，返回數值。
  • threshold.domain - get或set變換的定義域。
  • threshold.range - get或set變換的值域。
  • threshold.copy - 從已有的變換中複製出一個變換。
  • d3.scale.quantile - 構建一個quantile線性變換。使用方法與quantize完全類似，區別是quantile根據中位數來分隔區間，quantize根據算數平均值來分隔區間。example
  • quantile - 輸入數值，返回離散值。
  • quantile.invertExtent - 輸入離散值，返回數值。
  • quantile.domain - get或set變換的定義域。
  • quantile.range - get或set變換的值域。
  • quantile.quantiles - 獲得quantile變換的分隔值。示例： var q = d3.scale.quantile().domain([0, 1]).range(['a', 'b', 'c']); q.quantiles() returns [0.33333333333333326, 0.6666666666666665]
  • quantile.copy - 從已有的變換中複製出一個變換。
  • d3.scale.identity - 構建一個identity線性變換。特殊的linear線性變換，此變換定義域和值域相同，只在一些d3內部的axis或brush模組中用到。
  • identity - identity線性變換函式。返回輸入值。
  • identity.invert - 和identity函式相同，返回輸入值。
  • identity.domain - get或set變換的定義域。
  • identity.range - get或set變換的值域。
  • identity.ticks - 從定義域中取出有代表性的值。通常用於座標軸刻度的選取。
  • identity.tickFormat - 獲取格式轉化函式，通常用於座標軸刻度的格式轉化。
  • identity.copy - 從已有的變換中複製出一個變換。

序數變換（Ordinal）

  • d3.scale.ordinal - 構建一個ordinal變換物件。ordinal變換的輸入定義域和輸出值域都是離散的。而quantitative變換的輸入定義域是連續的，這是兩者最大的不同。
  • ordinal - 輸入一個離散值，返回一個離散值。不在當前定義域中的輸入值會自動加入定義域。
  • ordinal.domain - get或set變換的定義域。
  • ordinal.range - get或set變換的值域。
  • ordinal.rangePoints - 用幾個離散點來分割一個連續的區間。詳情請看連結中的圖例。
  • ordinal.rangeBands - 用幾個離散區間來分割一個連續的區間。詳情請看連結中的圖例。
  • ordinal.rangeRoundBands - 用幾個離散區間來分割一個連續的區間，區間邊界和寬度會取整。詳情請看連結中的圖例。
  • ordinal.rangeBand - 獲取離散區間的寬度。
  • ordinal.rangeExtent - 獲取輸出域的最小最大值。
  • ordinal.copy - 從已有的變換中複製出一個變換。
  • d3.scale.category10 - 用10種顏色構建一個ordinal變換。
  • d3.scale.category20 - 用20種顏色構建一個ordinal變換。
  • d3.scale.category20b - 用另外20種顏色構建一個ordinal變換。
  • d3.scale.category20c - 用另外20種顏色構建一個ordinal變換。

d3.svg (SVG)

Shapes

座標軸(Axes)

Controls

  • d3.svg.brush - 點選拖拽選擇一個二維區域。
  • brush - 在頁面中某個區域中正式繫結一個brush。
  • brush.x - get或set brush的x變換,用於水平方向的拖拽。
  • brush.y - get或set brush的y變換,用於垂直方向的拖拽。
  • brush.extent - get或set brush的選取範圍（extent）。
  • brush.clear - 設定brush的選取範圍（extent）為空。
  • brush.empty - 判斷brush的選取範圍（extent）是否為空。
  • brush.on - get或set brush的事件監聽器。可監聽3種事件：brushstart, brush, brushend。
  • brush.event - 通過程式觸發監聽事件，在通過程式設定extent後使用。

d3.time (Time)

時間格式轉換(Time Formatting)

  • d3.time.format - 建立基於某種時間格式的本地時間格式轉換器。
  • format - 將一個date物件轉換成特定時間格式的字串。
  • format.parse - 將特定時間格式的字串轉換成date物件。
  • d3.time.format.utc - 建立基於某種時間格式的世界標準時間（UTC）格式轉換器。
  • d3.time.format.iso - 建立基於某種時間格式的ISO世界標準時間（ISO 8601 UTC）格式轉換器。

時間變換(Time Scales)

  • d3.time.scale - 建立一個線性時間變換，定義域為數值區間，值域為時間區間。常用於時間座標軸的建立。詳情可參考d3.scale.linear。
  • scale - 輸入為一個數值，返回為一個時間。
  • scale.invert - 反變換，輸入時間返回數值。
  • scale.domain - get或set變換的定義域。
  • scale.nice - 擴充套件定義域範圍使定義域更規整。
  • scale.range - get或set變換的值域。
  • scale.rangeRound - 設定值域，並對結果取整。
  • scale.interpolate - get或set變換的插值函式，如將預設的線性插值函式替換成指數插值函式。
  • scale.clamp - 設定值域是否閉合，預設不閉合。當值域閉合時，如果插值結果在值域之外，會取值域的邊界值。詳情參考linear.clamp。
  • scale.ticks - 從定義域中取出有代表性的值。通常用於座標軸刻度的選取。
  • scale.tickFormat - 獲取格式轉化函式，通常用於座標軸刻度的格式轉化。
  • scale.copy - 從已有的時間變換中複製出一個變換。

Time Intervals

構圖(d3.layout)

Bundle

  • d3.layout.bundle - construct a new default bundle layout.
  • bundle - apply Holten’s hierarchical bundling algorithm to edges.

弦圖(Chord)

  • d3.layout.chord - 初始化一個弦圖物件, 返回一個 Chord 例項
  • chord.matrix - 設定或者獲取弦圖例項對應的矩陣資料
  • chord.padding - 設定或獲取弦圖各段圓弧之間的間隔角度
  • chord.sortGroups - 設定或獲取矩陣分組的排序函式
  • chord.sortSubgroups - 設定或獲取矩陣二級分組的排序函式
  • chord.sortChords - 設定或獲取弦圖在z序上的排序函式(決定哪一組顯示在最上層)
  • chord.chords - 該函式會將引數處理成對 chord 更友好的格式並返回, 若沒有提供引數, 會呼叫matrix()來獲取資料
  • chord.groups - 該函式引數處理成更易於理解的分組資訊, 若沒有提供引數, 會呼叫matrix()來獲取資料

叢集(Cluster)

  • d3.layout.cluster - 用預設設定生成一個叢集佈局物件.
  • cluster.sort - 獲取或設定一個函式, 用來給兄弟節點(同一父結點的子結點)的排序.
  • cluster.children - 獲取或設定子結點的訪問器.
  • cluster.nodes - 計算並返回指定結點的子結點在叢集中的資訊(座標,深度等).
  • cluster.links - 指定一個子結點陣列(通常是nodes函式返回值), 計算它們與父結點的連線資訊.
  • cluster.separation - 獲取或設定相鄰結點間的間隔(不僅限於兄弟結點).
  • cluster.size - 獲取或設定佈局的 寬 和 高 的大小.
  • cluster.nodeSize - 為結點指定大小.

力學(Force)

  • d3.layout.force -節點（node）基於物理模擬的位置連線。
  • force.on - 監聽佈局位置的變化。(僅支援”start”,”step”,”end”三種事件)
  • force.nodes - 獲得或設定佈局中的節點（node）陣列組。
  • force.links - 獲得或設定佈局中節點間的連線（Link）陣列組。.
  • force.size - 獲取或設定佈局的 寬 和 高 的大小.
  • force.linkDistance - 獲取或設定節點間的連線線距離.
  • force.linkStrength - 獲取或設定節點間的連線強度.
  • force.friction - 獲取或設定摩擦係數.
  • force.charge - 獲取或設定節點的電荷數.(電荷數決定結點是互相排斥還是吸引)
  • force.gravity - 獲取或設定節點的引力強度.
  • force.theta - 獲取或設定電荷間互相作用的強度.
  • force.start - 開啟或恢復結點間的位置影響.
  • force.resume - 設定冷卻係數為0.1,並重新呼叫start()函式.
  • force.stop - 立刻終止結點間的位置影響.(等同於將冷卻係數設定為0)
  • force.alpha - 獲取或設定佈局的冷卻係數.(冷卻係數為0時,節點間不再互相影響)
  • force.tick - 讓佈局執行到下一步.
  • force.drag - 獲取當前佈局的拖拽物件例項以便進一步繫結處理函式.

層級佈局(Hierarchy)

直方圖(Histogram)

  • d3.layout.histogram - 構建一個預設直方圖(用來表示一組離散數字的分佈,橫軸表示區間,縱軸表示區間內樣本數量或樣本百分比).
  • histogram.value - 獲取或設定值訪問器.
  • histogram.range - 獲取或設定合法值範圍.
  • histogram.bins - 指定如何將資料分組到不同的區間(bin)裡, 返回一個建構函式 .
  • histogram - 根據已設定的區間將資料分組,返回已分組的二維陣列(compute the distribution of data using quantized bins).
  • histogram.frequency - 設定直方圖Y軸值是區間內資料的總量還是百分比(compute the distribution as counts or probabilities).

層包(Pack)

  • d3.layout.pack - 用遞迴的圓環表現一個多層級佈局.
  • pack.sort - 獲取或設定一個函式, 用來給兄弟節點(同一父結點的子結點)排序.
  • pack.children - 獲取或設定子結點的訪問器.
  • pack.nodes - 計算並返回指定結點的子結點資訊.
  • pack.links - 指定一個子結點陣列(通常是nodes函式返回值), 計算它們與父結點的連線資訊.
  • pack.value - 獲取或設定一個函式, 用來計算圓環的大小(近似值).
  • pack.size - 設定整個佈局畫布的 寬 and 高.
  • pack.radius - 如果不想結點半徑與結點的值相同, 可以傳入一個函式用來計算結點半徑.
  • pack.padding - 指定相鄰結點之點的間距(近似值).

分割槽(Partition)

餅圖(Pie)

  • d3.layout.pie - 構建一個預設的餅圖.
  • pie - 該函式將傳入的原始引數轉換成可用於餅圖或者環形圖的資料結構.
  • pie.value - 獲取或設定值訪問器.
  • pie.sort - 設定餅圖順時針方向的排序方法.
  • pie.startAngle - 設定或獲取整個餅圖的起始角度.
  • pie.endAngle - 設定或獲取整個餅圖的終止角度.

堆疊圖(Stack)

  • d3.layout.stack - 構建一個預設的堆疊圖(用來展示一系列x軸相同的面積圖或者立方圖).
  • stack - 計算每一層的基線.
  • stack.values - 設定或者獲取每層的值訪問器.
  • stack.order - 設定每層的排序.
  • stack.offset - 指定總的基線演算法.
  • stack.x - 設定或獲取每層的x軸訪問器.
  • stack.y - 設定或獲取每層的y軸訪問器.
  • stack.out - 設定或獲取用來儲存基線的輸出函式.

樹(Tree)

  • d3.layout.tree - position a tree of nodes tidily.
  • tree.sort - 設定或獲取一個函式, 用來給兄弟節點(同一父結點的子結點)排序.
  • tree.children - 設定或獲取子結點的訪問器.
  • tree.nodes - 計算並返回指定結點的子結點資訊.
  • tree.links - 指定一個子結點陣列(通常是nodes函式返回值), 計算它們與父結點的連線資訊.
  • tree.separation - 設定或獲取相隔結點之間的間隔計算函式.
  • tree.size - 指定整個佈局的寬和高.
  • tree.nodeSize - 給全部結點指定一個固定的大小(會導致tree.size失效).

矩陣樹(Treemap)

  • d3.layout.treemap - 返回一個矩陣樹物件(用矩陣來展示一顆樹).
  • treemap.sort - 設定或獲取一個函式, 用來給兄弟節點(同一父結點的子結點)排序.
  • treemap.children - 設定或獲取子結點的訪問器.
  • treemap.nodes - 計算並返回指定結點的子結點資訊.
  • treemap.links - 指定一個子結點陣列(通常是nodes函式返回值), 計算它們與父結點的連線資訊.
  • treemap.value - 設定或獲取一個用來計算單元格大小的值訪問器.
  • treemap.size - 指定整個佈局的寬和高.
  • treemap.padding - 指定父結點和子結點的間距.
  • treemap.round - 禁用或啟用邊界補償.
  • treemap.sticky - 讓佈局更”粘”以保證在更新資料時有平滑的動畫效果.
  • treemap.mode - 更改矩陣樹的佈局演算法.

d3.geo (Geography)

Paths

Projections

Streams

d3.geom (Geometry)

Voronoi

  • d3.geom.voronoi - create a Voronoi layout with default accessors.
  • voronoi - compute the Voronoi tessellation for the specified points.
  • voronoi.x - get or set the x-coordinate accessor for each point.
  • voronoi.y - get or set the y-coordinate accessor for each point.
  • voronoi.clipExent - get or set the clip extent for the tesselation.
  • voronoi.links - compute the Delaunay mesh as a network of links.
  • voronoi.triangles - compute the Delaunay mesh as a triangular tessellation.

Quadtree

Polygon

Hull

  • d3.geom.hull - create a convex hull layout with default accessors.
  • hull - compute the convex hull for the given array of points.
  • hull.x - get or set the x-coordinate accessor.
  • hull.y - get or set the y-coordinate accessor.

d3.behavior (Behaviors)

Drag

縮放 Zoom

  • d3.behavior.zoom - 建立一個縮放行為.
  • zoom - 對指定元素應用縮放.
  • zoom.scale - the current scale factor.
  • zoom.translate - the current translate offset.
  • zoom.scaleExtent - optional limits on the scale factor.
  • zoom.center - an optional focal point for mousewheel zooming.
  • zoom.size - the dimensions of the viewport.
  • zoom.x - an optional scale whose domain is bound to the x extent of the viewport.
  • zoom.y - an optional scale whose domain is bound to the y extent of the viewport.
  • zoom.on - listeners for when the scale or translate changes.
  • zoom.event - dispatch zoom events after setting the scale or translate.

相關文章