react-d3/react-faux-dom

Name: react-faux-dom

Owner: react-d3

Description: DOM like structure that renders to React

Forked from: Olical/react-faux-dom

Created: 2015-10-30 15:41:46.0

Updated: 2016-10-20 15:52:32.0

Pushed: 2015-10-31 10:42:09.0

Homepage: http://oli.me.uk/2015/09/09/d3-within-react-the-right-way/

Size: 111

Language: JavaScript

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

react-faux-dom

DOM like data structure to be mutated by D3 et al, then rendered to React elements.

reate your element.
el = ReactFauxDOM.createElement('div')

hange stuff using actual DOM functions.
ven perform CSS selections.
tyle.setProperty('color', 'red')
etAttribute('class', 'box')

ender it to React elements.
rn el.toReact()

ields: <div style='color: red;' className='box'></div>

It supports a wide range of DOM operations and will fool most libraries but it isn't exhaustive (the full DOM API is ludicrously large). It supports enough to work with D3 but will require you to fork and add to the project if you encounter something that's missing.

You can think of this as a bare bones jsdom that's built to bridge the gap between the declarative React and the imperative JavaScript world. We just need to expand it as we go along since jsdom is a huge project that solves different problems.

I'm trying to keep it light so as not to slow down your render function. I want efficient, declarative and stateless code.

Usage

Here's a simple example using D3, you can find a more complex one in my lab (source) or d3-react-sparkline, a small component I built at Qubit.

d3 = require('d3')
React = require('react')
ReactFauxDOM = require('react-faux-dom')

Graph = React.createClass({
opTypes: {
data: React.PropTypes.arrayOf(React.PropTypes.number)

nder: function () {
// This is where we create the faux DOM node and give it to D3.
var chart = d3.select(ReactFauxDOM.createElement('div'))

chart
  .selectAll('.bar') // Yes, CSS selectors work.
  .data(this.props.data)
  .enter().append('div')
  .classed('bar', true)
  .style('width', function (d, i) {
    // Use styles exactly as you would with D3.
    // Hyphenated names are camel cased.
    return d * 10
  })
  .text(function (d) {
    return d
  })

// We ask D3 for the underlying fake node and then render it as React elements.
return chart.node().toReact()



data = [4, 8, 15, 16, 23, 42]

t.render(
act.createElement(Graph, {data: data}),
cument.getElementById('mount-chart')

There's not that much to show, and that's the point. It's just like the DOM, you just create your elements from a different root and call .toReact() at the end. Check out src/Element.js for the current API.

No real DOM nodes were used in the making of this example.

Development

tch the dependencies
 bootstrap

st
 test

st continually
 test-watch

Author

Oliver Caldwell (@OliverCaldwell)

Unlicenced

Find the full unlicense in the UNLICENSE file, but here's a snippet.

This is free and unencumbered software released into the public domain.

Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.

Do what you want. Learn as much as you can. Unlicense more software.