mirror of
https://github.com/d3/d3.git
synced 2025-12-08 19:46:24 +00:00
* checkpoint vitepress docs * edits * edits * hero drop shadow * d3-array edits * resolve d3 * split d3-array * move d3-array stuff around * d3-array is collapsed: true * italicize parameter names * searching edits * update dependencies * d3-array edits * array edits * array edits * array edits * array edits * array edits * move files * array edits * array edits * array edits * getting started edits * modules page * array edits * more structure * live example * dsv edits * fetch edits * dsv edits * random edits * time format edits * time edits * time edits * modules edits * color edits * color edits * interpolate edits * scale-chromatic edits * selection edits * break up d3-interpolate * scale edits * time scale edits * scale edits * scale edits * band edits * band edits * more descriptive titles * band and point edits * sequential edits * diverging edits * quantize edits * quantile edits * threshold edits * doc edits * fix titles * sequential edits * axis edits * axis edits * axis edits * shape edits * shape edits * dark mode chart * dark mode chart * curve edits * interpolate edits * line edits * link edits * radial edits * pie edits * symbol edits * stack edits * stack examples * path edits * polygon edits * quadtree edits * random examples * ease edits * ease edits * ease edits * timer edits * delaunay edits * quadtree find example * voronoi edits * dispatch edits * contour edits * chord edits * chord edits * fix find highlight * quadtree animation * transition edits * transition edits * transition edits * zoom edits * drag edits * brush edits * force edits * voronoi neighbors example * hierarchy edits * api edits * community edits * getting started edits * geo edits * Add short "D3 in React" section (#3659) * Add short "D3 in React" section I know you removed the TODO but I was already trying to fill it in! I think just making the distinction of modules that touch the DOM and those that don't was super clarifying for me personally when I figured that out. And I always forget the most basic ref pattern (and still might've messed it up here). I don't think we should get into updating or interactivity or whatever, but I think just this much goes a long way toward demystifying (and showing just the most basic best practices). * forgot i made data generic, rm reference to normal distribution * useEffect cleans up after itself Co-authored-by: Mike Bostock <mbostock@gmail.com> * Update getting-started.md --------- Co-authored-by: Mike Bostock <mbostock@gmail.com> * build fixes * index edits --------- Co-authored-by: Toph Tucker <tophtucker@gmail.com>
221 lines
5.4 KiB
JavaScript
221 lines
5.4 KiB
JavaScript
import * as Plot from "@observablehq/plot";
|
|
import {h, withDirectives} from "vue";
|
|
|
|
class Document {
|
|
constructor() {
|
|
this.documentElement = new Element(this, "html");
|
|
}
|
|
createElementNS(namespace, tagName) {
|
|
return new Element(this, tagName);
|
|
}
|
|
createElement(tagName) {
|
|
return new Element(this, tagName);
|
|
}
|
|
createTextNode(value) {
|
|
return new TextNode(this, value);
|
|
}
|
|
querySelector() {
|
|
return null;
|
|
}
|
|
querySelectorAll() {
|
|
return [];
|
|
}
|
|
}
|
|
|
|
class Style {
|
|
static empty = new Style();
|
|
setProperty() {}
|
|
removeProperty() {}
|
|
}
|
|
|
|
class Element {
|
|
constructor(ownerDocument, tagName) {
|
|
this.ownerDocument = ownerDocument;
|
|
this.tagName = tagName;
|
|
this.attributes = {};
|
|
this.children = [];
|
|
this.parentNode = null;
|
|
}
|
|
setAttribute(name, value) {
|
|
this.attributes[name] = String(value);
|
|
}
|
|
setAttributeNS(namespace, name, value) {
|
|
this.setAttribute(name, value);
|
|
}
|
|
getAttribute(name) {
|
|
return this.attributes[name];
|
|
}
|
|
getAttributeNS(name) {
|
|
return this.getAttribute(name);
|
|
}
|
|
hasAttribute(name) {
|
|
return name in this.attributes;
|
|
}
|
|
hasAttributeNS(name) {
|
|
return this.hasAttribute(name);
|
|
}
|
|
removeAttribute(name) {
|
|
delete this.attributes[name];
|
|
}
|
|
removeAttributeNS(namespace, name) {
|
|
this.removeAttribute(name);
|
|
}
|
|
addEventListener() {
|
|
// ignored; interaction needs real DOM
|
|
}
|
|
removeEventListener() {
|
|
// ignored; interaction needs real DOM
|
|
}
|
|
dispatchEvent() {
|
|
// ignored; interaction needs real DOM
|
|
}
|
|
appendChild(child) {
|
|
this.children.push(child);
|
|
child.parentNode = this;
|
|
return child;
|
|
}
|
|
insertBefore(child, after) {
|
|
if (after == null) {
|
|
this.children.push(child);
|
|
} else {
|
|
const i = this.children.indexOf(after);
|
|
if (i < 0) throw new Error("insertBefore reference node not found");
|
|
this.children.splice(i, 0, child);
|
|
}
|
|
child.parentNode = this;
|
|
return child;
|
|
}
|
|
querySelector() {
|
|
return null;
|
|
}
|
|
querySelectorAll() {
|
|
return [];
|
|
}
|
|
set textContent(value) {
|
|
this.children = [this.ownerDocument.createTextNode(value)];
|
|
}
|
|
set style(value) {
|
|
this.attributes.style = value;
|
|
}
|
|
get style() {
|
|
return Style.empty;
|
|
}
|
|
toHyperScript() {
|
|
return h(
|
|
this.tagName,
|
|
this.attributes,
|
|
this.children.map((c) => c.toHyperScript())
|
|
);
|
|
}
|
|
}
|
|
|
|
class TextNode {
|
|
constructor(ownerDocument, nodeValue) {
|
|
this.ownerDocument = ownerDocument;
|
|
this.nodeValue = String(nodeValue);
|
|
}
|
|
toHyperScript() {
|
|
return this.nodeValue;
|
|
}
|
|
}
|
|
|
|
// Converts the real DOM to virtual DOM (for client-side hydration).
|
|
function toHyperScript(node) {
|
|
if (node.nodeType === 3) return node.nodeValue; // TextNode
|
|
const props = {};
|
|
for (const name of node.getAttributeNames()) props[name] = node.getAttribute(name);
|
|
const children = [];
|
|
for (let child = node.firstChild; child; child = child.nextSibling) children.push(toHyperScript(child));
|
|
return h(node.tagName, props, children);
|
|
}
|
|
|
|
export default {
|
|
props: {
|
|
options: Object,
|
|
mark: Object,
|
|
defer: Boolean,
|
|
method: {type: String, default: "plot"}
|
|
},
|
|
render() {
|
|
const {method} = this;
|
|
const options = {
|
|
...(method === "plot" && {
|
|
marks: this.mark == null ? [] : [this.mark],
|
|
width: 688 // better default for VitePress
|
|
}),
|
|
...this.options,
|
|
className: "plot"
|
|
};
|
|
if (this.defer) {
|
|
const mounted = (el) => {
|
|
disconnect(); // remove old listeners
|
|
function observed() {
|
|
unmounted(el); // remove old plot (and listeners)
|
|
el.append(Plot[method](options));
|
|
}
|
|
const rect = el.getBoundingClientRect();
|
|
if (rect.bottom > 0 && rect.top < window.innerHeight) {
|
|
observed();
|
|
} else {
|
|
this._observer = new IntersectionObserver(
|
|
([entry]) => {
|
|
if (entry.isIntersecting) observed();
|
|
},
|
|
{rootMargin: "100px"}
|
|
);
|
|
this._observer.observe(el);
|
|
if (typeof requestIdleCallback === "function") {
|
|
this._idling = requestIdleCallback(observed);
|
|
}
|
|
}
|
|
};
|
|
const unmounted = (el) => {
|
|
while (el.lastChild) el.lastChild.remove();
|
|
disconnect();
|
|
};
|
|
const disconnect = () => {
|
|
if (this._observer !== undefined) {
|
|
this._observer.disconnect();
|
|
this._observer = undefined;
|
|
}
|
|
if (this._idling !== undefined) {
|
|
cancelIdleCallback(this._idling);
|
|
this._idling = undefined;
|
|
}
|
|
};
|
|
const {height = 400} = this.options;
|
|
return withDirectives(
|
|
h(
|
|
"span",
|
|
method === "plot"
|
|
? [
|
|
h("div", {
|
|
style: {
|
|
maxWidth: "100%",
|
|
width: `688px`,
|
|
aspectRatio: `688 / ${height}`
|
|
}
|
|
})
|
|
]
|
|
: []
|
|
),
|
|
[
|
|
[
|
|
{
|
|
mounted,
|
|
updated: mounted,
|
|
unmounted
|
|
}
|
|
]
|
|
]
|
|
);
|
|
}
|
|
if (typeof document !== "undefined") {
|
|
const plot = Plot[method](options);
|
|
const replace = (el) => el.firstChild.replaceWith(plot);
|
|
return withDirectives(h("span", [toHyperScript(plot)]), [[{mounted: replace, updated: replace}]]);
|
|
}
|
|
return h("span", [Plot[method]({...options, document: new Document()}).toHyperScript()]);
|
|
}
|
|
};
|