-
Notifications
You must be signed in to change notification settings - Fork 16
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
26d276c
commit 758dcea
Showing
7 changed files
with
3,226 additions
and
6 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Large diffs are not rendered by default.
Oops, something went wrong.
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,13 @@ | ||
Copyright 2010-2021 Mike Bostock | ||
|
||
Permission to use, copy, modify, and/or distribute this software for any purpose | ||
with or without fee is hereby granted, provided that the above copyright notice | ||
and this permission notice appear in all copies. | ||
|
||
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH | ||
REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND | ||
FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, | ||
INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS | ||
OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER | ||
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF | ||
THIS SOFTWARE. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,74 @@ | ||
# D3: Data-Driven Documents | ||
|
||
<a href="https://d3js.org"><img src="https://d3js.org/logo.svg" align="left" hspace="10" vspace="6"></a> | ||
|
||
**D3** (or **D3.js**) is a JavaScript library for visualizing data using web standards. D3 helps you bring data to life using SVG, Canvas and HTML. D3 combines powerful visualization and interaction techniques with a data-driven approach to DOM manipulation, giving you the full capabilities of modern browsers and the freedom to design the right visual interface for your data. | ||
|
||
## Resources | ||
|
||
* [Introduction](https://observablehq.com/@d3/learn-d3) | ||
* [API Reference](https://github.com/d3/d3/blob/master/API.md) | ||
* [Releases](https://github.com/d3/d3/releases) | ||
* [Examples](https://observablehq.com/@d3/gallery) | ||
* [Wiki](https://github.com/d3/d3/wiki) | ||
|
||
## Installing | ||
|
||
If you use npm, `npm install d3`. You can also download the [latest release on GitHub](https://github.com/d3/d3/releases/latest). For vanilla HTML in modern browsers, import D3 from Skypack: | ||
|
||
```html | ||
<script type="module"> | ||
import * as d3 from "https://cdn.skypack.dev/d3@7"; | ||
const div = d3.selectAll("div"); | ||
</script> | ||
``` | ||
|
||
For legacy environments, you can load D3’s UMD bundle from an npm-based CDN such as jsDelivr; a `d3` global is exported: | ||
|
||
```html | ||
<script src="https://cdn.jsdelivr.net/npm/d3@7"></script> | ||
<script> | ||
const div = d3.selectAll("div"); | ||
</script> | ||
``` | ||
|
||
You can also use the standalone D3 microlibraries. For example, [d3-selection](https://github.com/d3/d3-selection): | ||
|
||
```html | ||
<script type="module"> | ||
import {selectAll} from "https://cdn.skypack.dev/d3-selection@3"; | ||
const div = selectAll("div"); | ||
</script> | ||
``` | ||
|
||
D3 is written using [ES2015 modules](http://www.2ality.com/2014/09/es6-modules-final.html). Create a custom bundle using Rollup, Webpack, or your preferred bundler. To import D3 into an ES2015 application, either import specific symbols from specific D3 modules: | ||
|
||
```js | ||
import {scaleLinear} from "d3-scale"; | ||
``` | ||
|
||
Or import everything into a namespace (here, `d3`): | ||
|
||
```js | ||
import * as d3 from "d3"; | ||
``` | ||
|
||
In Node: | ||
|
||
```js | ||
const d3 = require("d3"); | ||
``` | ||
|
||
You can also require individual modules and combine them into a `d3` object using [Object.assign](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/assign): | ||
|
||
```js | ||
const d3 = Object.assign({}, require("d3-format"), require("d3-geo"), require("d3-geo-projection")); | ||
``` |
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters