[[TableOfContents]] == SVG == {{{#!c Hello, world! }}} SVG != HTML == D3 Resources == * D3 API Reference https://github.com/mbostock/d3/wiki/API-Reference * D3 Wiki https://github.com/mbostock/d3/wiki * D3 Group https://groups.google.com/group/d3-js * D3 Stack Overflow http://stackoverflow.com/questions/tagged/d3.js == Selectors == === CSS Selectors === {{{#!c pre, code { font-family: "Menlo", monospace; font-size: 48px; } #foo // foo // .foo // [foo=bar] // foo bar // foo.bar // foo#bar // }}} === Selectors === Javascript {{{#!c document.querySelectorAll("pre, code") }}} jQuery {{{#!c $('pre, code') }}} D3 {{{#!c d3.selectAll("pre, code") }}} === Selection.Append === Single {{{#!c // select the element var body = d3.select("body"); // add an

element var h1 = body.append("h1"); h1.text("Hello!"); }}} Collection {{{#!c // select all
elements var section = d3.selectAll("section"); // add an

element var h1 = section.append("h1"); h1.text("Hello!"); }}} == Enter, Update & Exit == === Enter === New data, for which there were no existing elements. {{{#!c var circle = svg.selectAll("circle") .data(data) .enter().append("circle"); .attr("cx", x) .attr("cy", y) .attr("r", 2.5); }}} === Update === New data that was joined successfully to an existing element. When updating, you might ignore enter and exit. {{{#!c var circle = svg.selectAll("circle") .data(data) .attr("cx", x) .attr("cy", y) .attr("r", 2.5); }}} === Exit === Existing elements, for which there were no new data. === Key Function === by default, the join is by index. {{{#!c var data = [ {name: "Alice", x: 10.0, y: 9.14}, {name: "Bob", x: 8.0, y: 8.14}, {name: "Carol", x: 13.0, y: 8.74}, {name: "Dave", x: 9.0, y: 8.77}, {name: "Edith", x: 11.0, y: 9.26}, }}} If needed, data should have a unique key for joining. {{{#!c function key(d) { return d.name; } var circle = svg.selectAll("circle"); .data(data, key) .attr("cx", x) .attr("cy", y) .attr("r", 2.5); }}} == Scale == === Quantitative Scales === Map a continuous (numeric) domain to a continuous range * linear * sqrt * pow * log * quantize * threshold * quantile * identity {{{#!c var x = d3.scale.linear() .domain([12, 24]) .range([0, 720]); x(16); // 240 }}} {{{#!c var x = d3.scale.sqrt() .domain([12, 24]) .range([0, 720]); x(16); // 268.9056992603583 }}} {{{#!c var x = d3.scale.log() .domain([12, 24]) .range([0, 720]); x(16); // 240 }}} === Domains & Ranges === {{{#!c var x = d3.scale.linear() .domain([0, d3.max(numbers)]) .range([0, 720]); }}} {{{#!c var x = d3.scale.log() .domain(d3.extent(number)) .range([0, 720]); }}} {{{#!c function value(d) { return d.value; } var x = d3.scale.log() .domain(d3.extent(object, value)) .range([0, 720]); }}} === Interpolators === Quantitative scales support multiple interpolators. {{{#!c var x = d3.scale.linear() .domain([12, 24]) .range(["steelblue", "brown"]); x(16); // #666586 }}} {{{#!c var x = d3.scale.linear() .domain([12, 24]) .range(["0px", "720px"]); x(16); // 240px }}} {{{#!c var x = d3.scale.linear() .domain([12, 24]) .range(["steelblue", "brown"]); .interpolate(d3.interpolateHsl); x(16); // #3cb05f }}} === Diverging Scales === Sometimes, you want a compound ("polylinear") scale. {{{#!c var x = d3.scale.linear() .domain([-10, 0, 100]) .range(["red", "white", "green"]); x(-5); // #ff8080 x(50); // #80c080 }}} === Ordinal Scales === An ordinal Scale is essentially an explicit mapping. {{{#!c var x = d3.scale.ordinal() .domain(["A", "B", "C", "D"]) .range([0, 10, 20, 30]); x("B"); // 10 }}} {{{#!c var x = d3.scale.category20() .domain(["A", "B", "C", "D"]) x("B"); // #aec7e8 x("E"); // #2ca02c x.domain(); // A, B, C, D, E }}} === Color Scale === * d3.scale.category10 * d3.scale.category20 * d3.scale.category20b * d3.scale.category20c === Ticks === {{{#!c var x = d3.scale.linear() .domain([12, 24]) .range([0, 720]); x.ticks(5); // [12, 14, 16, 18, 20, 22, 24] == Axix == === Create === {{{#!c var yAxis = d3.svg.axis() .scale(y) .orient("left"); }}} === Render === {{{#!c svg.append("g") .attr("class", "y axis") .call(yAxis); }}} === Style === {{{#!c .axis path, .axis line { fill: none; stroke: #000; shape-rendering: crispEdges; } }}} == Path == === SVG Paths === {{{#!c }}} === Path Generators === * d3.svg.line * d3.svg.area Create {{{#!c var x = d3.scale.linear(); y = d3.scale.linear(); var line = d3.svg.line() .x(function(d) { return x(d.x); }) .y(function(d) { return y(d.y); }); }}} Redner {{{#!c svg.append("path") .datum(objects) .attr("class", "line") .attr("d", line); }}} == Layouts == * d3.layout.treemap * d3.layout.tree * d3.layout.pack * d3.layout.partition * d3.layout.force * d3.layout.bundle * d3.layout.voronoi * d3.layout.chord * References http://bost.ocks.org/mike/d3/workshop/