ipyflex

Jupyter小部件的所见即所得布局编辑器

基于React库 FlexLayout，ipyflex允许您通过现有Jupyter小部件无需编码即可构建复杂的仪表板布局。它支持多个标签、可调整大小的卡片、拖放布局、将仪表板模板保存到磁盘等。

示例

动态布局

小部件工厂

可配置的标题

https://user-images.githubusercontent.com/4451292/149482302-30579785-4d8e-4d50-9bcc-249bea4a9d95.mp4

股票指数仪表板

文档

您可以通过以下链接阅读文档： https://ipyflex.readthedocs.io

安装

您可以使用 pip 进行安装

pip install ipyflex

或使用 conda

conda install -c conda-forge  ipyflex

如果您使用 jupyterlab <= 2

mamba install -c conda-forge yarn
jupyter labextension install @jupyter-widgets/jupyterlab-manager ipyflex

开发安装

创建开发环境

conda create -n ipyflex-dev -c conda-forge nodejs yarn python jupyterlab
conda activate ipyflex-dev

安装python。这将还会构建TS包。

pip install -e ".[test, examples]"

在开发您的扩展时，您需要手动使用笔记本/实验室前端启用您的扩展。对于实验室，这是通过以下命令完成的

jupyter labextension develop --overwrite .
yarn run build

对于经典笔记本，您需要运行

jupyter nbextension install --sys-prefix --symlink --overwrite --py ipyflex
jupyter nbextension enable --sys-prefix --py ipyflex

请注意，在Windows上，--symlink标志不起作用，因此您每次重新构建扩展时都必须运行install命令。对于某些安装，您可能还需要另一个标志代替--sys-prefix，但这里不会解释这些标志的含义。

如何查看您的更改

Typescript

如果您使用JupyterLab进行开发，则可以在不同终端中同时监视源目录并运行JupyterLab，以监视扩展源代码中的更改，并自动重新构建小部件。

# Watch the source directory in one terminal, automatically rebuilding when needed
yarn run watch
# Run JupyterLab in another terminal
jupyter lab

更改后，等待构建完成，然后刷新您的浏览器，更改应生效。

Python

如果您修改了Python代码，则需要重新启动笔记本内核以使更改生效。

谢谢

以下库/开源项目在ipyflex的开发中使用了或受到了启发：

• FlexLayout
• CoSApp Lab