Home

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 terhadap 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).

Sumber Daya

• Pengantar
• Gallery contoh-contoh
• Tutorial dan Diskusi
• Referensi API (Bahasa Indonesia)
• Catatan Rilis
• Plugins
• Pertanyaan mengenai d3.js di Stack Overflow
• Milis d3-js di Google Group
• English

Dukungan Browser

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 menggunakan 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.

Menginstal

Unduh versi terakhir di sini:

• https://github.com/mbostock/d3/releases

Atau, me-link secara langsung 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:

• https://github.com/mbostock/d3/zipball/master

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

Memodifikasi

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