A Django module integrating Storybook pattern library and Django
Project description
django-storybook
A Django module to intergrate the Storybook pattern library and django
Installation
pip install django-storybook && pip install django-cors-headers
Follow the setup for django-cors-headers here.
Config
Settings.dev
Please note django_storybook disables CSRF protection to allow for local development using Docker. This should not be used in production.
# Enable django_storybook
CORS_ORIGIN_ALLOW_ALL = True
CORS_ALLOW_HEADERS = default_headers + ("Access-Control-Allow-Origin", "csrftoken")
Installed apps
Add the following to your installed apps:
INSTALLED_APPS =[
...
"django_storybook",
"corsheaders",
...
]
URLs
Add the following to your debug urls:
if settings.debug:
urlpatterns += url(r"", include(django_storybook_urls)),
Storybook
Add the following to your webpack.config.js:
"django-storybook": "start-storybook -p 6006 & webpack --mode development --progress --watch",
While your development environment is running:
npm run django-storybook
Creating templates
To create Storybook stories that django-storybook can interpret you need to add the following Javascript file titled "base-template.js"
import React from 'react'
const baseUrl = "http://0.0.0.0:8000/compile_django/"
class BaseTemplate extends React.Component {
constructor() {
super()
this.state = {
data: null,
};
}
componentDidMount() {
var xhr = new XMLHttpRequest();
xhr.open("POST", baseUrl, true);
xhr.setRequestHeader('Content-type', 'application/json')
xhr.onload = () => {
var template = xhr.response;
console.log(template);
this.setState({ template });
}
xhr.send(JSON.stringify( this.props ));
}
render() {
if (this.state.template) {
return <div dangerouslySetInnerHTML={{__html:this.state.template}} />;
}
else {
return <div>Loading...</div>
}
}
}
export default BaseTemplate;
Templating
To render django templates, template tags and pass in context you simply import the base template and create props that mimic the expected context. The template variable is the relative path to you desired template.
import React from 'react';
import BaseTemplate from '../path/to/your/base-template.js';
// Set storybook title
export default { title: 'Example' };
// Create props for context
var props = {
template: 'path/to/your/html.html',
context: {
card: {
description: "A Description",
url: "https://wwww.williamblackie.com",
button_title: "Vist website"
},
card_image: {
url: "https://via.placeholder.com/250x150?text=William+Blackie"
}
},
}
// Export
export const example = () => (
<BaseTemplate {...props}/>
)
Deployment
Due to disabling CSRF django_storybook is not safe for production. However, deploying a static storybook using storybook deployer is a good alternative.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django_storybook-0.1.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9f4e1494a0f137575b40754436692565b7a6a6a405ce8150b5bd932aa2d87e1c |
|
MD5 | ec96ab4610cca4e4fde8338980d01c54 |
|
BLAKE2b-256 | 5cb5b6dcb63f4fbf656209671e2c5508be29105e5583f1e87fe30c121d7f90b2 |