Wiki

D3.js adalah pustaka JavaScript untuk manipulasi dokumen berdasarkan data. D3 membantu anda menyajikan data menggunakan HTML, SVG dan CSS. Penekanan D3 pada standard web memberi Anda kompatibilitas penuh trerhadap perambah web (web browser) modern tanpa mengkaitkan anda dengan framework proprietary, menggabungkan komponen-komponen visualisasi yang powerful dan pendekatan berdasarkan data pada manipulasi DOM (Document Object Model).

Resources

Browser Support

D3 mendukung apa yang disebut sebagai perambah (browser) web “modern”, yang umumnya semua perambah kecuali IE8 dan dibawahnya. D3 diujicoba terhadap Firefox, Chrome (Chromium), Safari (WebKit), Opera dan IE9. Beberapa bagian dari D3 mungkin dapat berjalan pada perambah yang lebih tua, karena pustaka inti (core) mempunyai requirement minimal: JavaScript dan API W3C DOM. Untuk IE8, direkomendasikan menggunakan pustaka kompatibilitas Aight. D3 memnggunakan Selectors API Level 1, tapi Anda dapat mem-preload Sizzle untuk kompatibilitas. Anda akan membutuhkan perambah modern untuk menggunakan SVG dan CSS3 Transitions. D3 bukanlah suatu lapisan kompatibilitas, jadi bila perambah Anda tidak mendukung standard, Anda tidak beruntung. Mohon maaf :)

D3 bekerja juga dengan Node.js. Lihat https://groups.google.com/forum/#!msg/d3-js/JyldAkWkTvI/n8thanJeGvAJ untuk detailnya.

Installing

Unduh versi terakhir di sini:

Atau, me-link secara langsybg ke rilis terakhir, kopi potongan kode berikut:

<script src="http://d3js.org/d3.v3.min.js" charset="utf-8"></script>

Atau, bila Anda ingin repositori lengkapnya termasuk pengetesan-pengetesan:

Ketika membangun secara lokal, lihat bahwa perambah Anda mungkin memaksa permisi yang ketat untuk membaca file di luar file system lokal. Bila anda menggunakan d3.xhr secara lokal (termasuk d3.json dan lain-lain), Anda harus mempunyai server web lokal. Sebagai contoh, Anda dapat menjalankan built-in server Python:

python -m SimpleHTTPServer 8888 &

atau untuk Python 3+

python -m http.server 8888 &

Setelah berjalan, masuk ke http://localhost:8888/.

D3 mendukung API definisi modul asinkronos (asynchronous module definition - AMD). Sebagai contoh, bila Anda menggunakan RequireJS, Anda mungkin me-load yang berikut ini:

require.config({paths: {d3: "http://d3js.org/d3.v3.min"}});

require(["d3"], function(d3) {
  console.log(d3.version);
});

Modifying

Bila Anda ingin memodifikasi bagaimana D3 diimplementasikan, klik tombol "Fork" pada pojok kanan-atas dari halaman ini, dan kemudian clone menjadi fork Anda dengan perintah command line dengan mengganti username dengan username Github Anda:

git clone git://github.com/username/d3.git

Repositori D3 seharusnya dapat berjalan bila Anda hanya ingin membuat visualisasi baru menggunakan D3. Di sisi lain, bila Anda ingin memperluas D3 dengan fitur-fitur baru, memperbaiki bug, atau menjalankan pengetesan-pengetesan, Anda harus mem-fork repositori D3, dan instal Node.js (version 0.10.x atau lebih). Dari direktori root dari repositori ini, Anda kemudian dapat menginstal dependensi D3:

npm install

Untuk menjalankan tes, gunakan:

make test