1
0
mirror of https://github.com/d3/d3.git synced 2025-12-08 19:46:24 +00:00
d3/docs/components/PlotRender.js
Mike Bostock 6d6c6792f1
vitepress docs (#3654)
* 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>
2023-06-07 21:30:47 -04:00

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()]);
}
};