ReactScript

An elegant, flexible DSL for React for use with CoffeeScript (and maybe other languages)

With CoffeeScript:

1# Alias it as whatever you want (maybe _ or $?)
2E = ReactScript or require "react-script"
3
4class Message extends React.Component
5	render: ->
6		E ".message", class: (if @props.author is you then "from-you"),
7			E ".info",
8				style: float: "right"
9				"From "
10				E "span.author", @props.author
11				" at "
12				E "span.time", @props.time
13			E "p.body",
14				@props.text
15				if @props.fileTransfers
16					E ".transfers",
17						"Sent files:"
18						E "ul.files",
19							for transfer in @props.fileTransfers
20								E "li", E "a",
21									href: transfer.downloadLink
22									download: transfer.fileName
23									transfer.fileName
24
25message = E Message,
26	author: "John"
27	time: "5:47 PM"
28	text: "Hello world!"
29	fileTransfers: [
30		{fileName:  "virus.exe", downloadLink: "#"}
31	]
32
33ReactDOM.render message, document.body
34

By simply supporting arrays and ignoring nully values, it works with all forms of conditionals and comprehensions.

All the functionality of classnames is built in. Just provide any class, classes, className, classNames or classList. All those properties are treated the same and can be a single class name, a single string with multiple class names, an object where the keys are the class names and the values are whether they should be present, or an array of any of the preceding. Nully values are ignored, allowing for conditionals.

The whole library tries to be pretty flexible.

You can specify data-* and aria-* properties either as e.g. "data-size"/"aria-pressed" or dataSize/ariaPressed or data_size/aria_pressed or data: size: 1.337/aria: pressed: true. (ARIA's role attribute is just role.)

Check out the specs for more details.

If you find something that doesn't work as you'd hope, feel free to open an issue.

Installation

npm i react-script --save

Usage

You can use ReactScript through a bundler like browserify or webpack, or you can include it as a script:

1<script src="node_modules/react-script/lib/react-script.js"></script>`

Then alias ReactScript as something short such as E to use as a DSL.

1var E = ReactScript; // or require("react-script");

Run tests

npm test

Similar Projects

• hyperscript (generates HTML)
• react-hyperscript (hyperscript for React)
• virtual-hyperscript (hyperscript for virtual-dom)
• zorium (framework for virtual-dom)
• hyper ("React.js wrapper for CoffeeScript", part library, part transformer)
• coffee-react (JSX for CoffeeScript (plus related projects))
• react-no-jsx (uses arrays rather than function calls; not enough CoffeeScript)