dash-html-components

Vanilla HTML components for Dash

Contributing

# Install dependencies
$ npm install

# Watch source for changes and build to `lib/`
$ npm start

Generating HTML Components

The components in src/components, as well as the export index in src/index.js are programmatically generated from element definitions in scripts/. To regenerate:

The list of attributes is regenerated by scraping the MDN HTML attribute reference.

$ npm run generate-components

Development

Testing your components in Dash

Build development bundle to lib/ and watch for changes

 # Once this is started, you can just leave it running.
 $ npm start

Install module locally (after every change)

 # Generate metadata, and build the JavaScript bundle
 $ npm run install-local

 # Now you're done. For subsequent changes, if you've got `npm start`
 # running in a separate process, it's enough to just do:
 $ python setup.py install

Run the dash layout you want to test

 # Import dash_core_components to your layout, then run it:
 $ python my_dash_layout.py

Installing python package locally

Before publishing to PyPi, you can test installing the module locally:

# Install in `site-packages` on your machine
$ npm run install-local

Uninstalling python package locally

$ npm run uninstall-local

Publishing

Builder / Archetype

We use Builder to centrally manage build configuration, dependencies, and scripts. See the dash-components-archetype repo for more information.

johnkabler/dash-html-components