Dash的普通HTML组件
dash-html-components的Python项目详细描述
短划线HTML组件
用于Dash
的普通HTML组件安装依赖项
创建一个虚拟环境并激活。
$ virtualenv venv $ venv/bin/activate
注意:venv\scripts\activate for windows
安装构建组件所需的python包。
$ pip install -r dev-requirements.txt
生成组件并安装npm包
$ npm install
生成html组件
src/components
中的组件以及中的导出索引
src/index.js
由中的元素定义以编程方式生成
scripts/
。重新生成:
$ npm run generate-components
属性列表通过刮除 MDN HTML attribute reference。
注意:当您运行npm install
发展
在仪表板中测试部件
注意变化
$ npm run build:watch
在本地安装模块(每次更改后)
# Generate metadata, and build the JavaScript bundle
$ npm run install-local
# Now you're done. For subsequent changes, if you've got `npm run build:watch`
$ python setup.py install
运行要测试的短划线布局
# Import dash_html_components to your layout, then run it:
$ python my_dash_layout.py
在本地安装python包
注意变化
$ npm run build:watch
在本地安装模块(每次更改后)
# Generate metadata, and build the JavaScript bundle
$ npm run install-local
# Now you're done. For subsequent changes, if you've got `npm run build:watch`
$ python setup.py install
运行要测试的短划线布局
# Import dash_html_components to your layout, then run it:
$ python my_dash_layout.py
在发布到pypi之前,可以在本地测试安装模块:
# Install in `site-packages` on your machine
$ npm run install-local
在本地卸载python包
$ npm run uninstall-local
贡献
请参阅contributing guide以获取有关对此项目作出贡献的指南。
创建生产版本并发布:
生成代码:
$ npm run build
创建python tarball
$ python setup.py sdist
此分发tarball将在
dist/
文件夹中生成通过将tarball复制到新环境中并在本地安装来测试它:
$ pip install dash-html-components-<new-version>.tar.gz
如果有效,则可以将组件发布到npm和pypi:
- 在pypi上发布
$ twine upload dist/*
- 清除dist文件夹(可选)
$ rm -rf dist
- 在npm上发布(如果在
publish_on_npm
中选择false,则为可选)
将组件发布到npm将使javascript包在unpkg cdn上可用。默认情况下,dash从远程unpkg cdn服务器组件库的css和js,因此如果尚未将组件包发布到npm,则需要将$ npm publish
serve_locally
标志设置为True
(除非在publish_on_npm
上选择False
)。我们最终会将serve_locally=True
设为默认值,follow our progress in this issue。
- 在pypi上发布