python做界面,为什么我会强烈推荐nicegui

我是数据外星人 2024-02-22 01:26:05
前言

在网上搜索 "python 做界面" ,得到的结果无非是 Tkinter 、 wxWidgets 、 Qt 、 Gtk 。它们要不然就是打包后太大,要不就是界面丑,要不就是代码繁琐。这些都是 GUI,那么 web 界面又如何?

我之前推荐过 streamlit,在简单的场景下,它仍然值得推荐。但是 streamlit 实在不灵活,受限于它的核心机制,有些需求几乎无法实现。用来做简单的数据看板,还行。

streamlit 中加个边框线都很复杂,无语

我需要一个灵活的web框架,可以做web服务的网站,也可以打包成独立的 exe 。现在找到了,就是 niecgui。

看看演示效果

后续我会发布更多关于 nicegui 的教程。其中涉及重要知识点的,会以文章形式发布(方便查找)。视频主要演示实战过程。

今天,我将用一个小例子,整体体验一下 nicegui 吸引我的特性:

上手 nicegui 最关键的知识点打包独立的 exe

我们需要安装这些库

pip install nicegui pyinstaller pandas openpyxl

不要忘记一键三连。你的点赞、收藏、关注,是我创作的动力。

启动

创建 main.py 文件。简单显示一段文本作为开始。

行3: 所有的组件使用 ui.xxxx 创建行6: 最后必需写这句,启动服务

我们只需要简单执行 main.py 脚本即可。默认情况下,你的浏览器会自动打开了页面。效果是这样子:

注意几点:

执行脚本的控制台,此时处于占用状态。因为 nicegui 启动了一个 web 服务。

如果你关掉了这个控制台,那么服务就停止。

nicegui 使用的是 fastapi 作为 web 服务框架

此外,它会自动监控当前目录的 python 文件变化。因此我们可以直接修改代码(保存文件),浏览器的界面会自动更新。

nicegui 内置了许多组件可以使用,我们也没必要每个组件去学习,需要的时候查文档即可。

更多组件的使用技巧,可以查看我的后续视频教程

今天重点是讲解 nicegui 的关键知识点,我将用一个非常简单的需求。看代码更直接:

界面是这样子:

需求是,在输入框中输入execl 文件,点击按钮,下方显示表格数据布局

代码与界面对比,我们可以看到 nicegui 的基本布局方式:

按代码执行创建组件的顺序,界面上从上往下放置

很容易想到,它必定提供了一个能让我们把组件横向放置的组件,比如 ui.row:

布局并非学习 nicegui 的核心知识点,现在,我们不需要关注布局

事件驱动

nicegui 与市面上大多数界面框架一样,使用事件驱动流程推进。在我们的需求中,点击按钮后,需要加载表格。因此需要定义按钮的点击事件。

行10-12:定义函数行14:设置按钮参数 on_click = 自定义函数此时点击按钮,自定义函数就会执行

但是,我们该怎么在自定义函数中加入表格?所有基于事件驱动的框架,都需要把组件提前放置好,就算当前没有合适的数据。

在 nicegui 中有三种官方的方式。建议大家耐心看完,我相信官方文档都没有讲解得这么有逻辑。

我知道官方的方式都显得挺繁琐。放心,不是只能用官方的方式,我们可以自己打造更新方式。比如像 streamlit 一样的"傻瓜模式"

方式一:直接放入空表格,在点击按钮的时候,重新填入表格数据

行19:在 row 组件下方创建 table 组件,这次我们需要在点击事件中使用表格对象,因此定义变量 table行11:使用 pandas 加载数据行13-14:改写表格的配置。nicegui 使用 aggrid,这是一个非常厉害的前端表格库,可以配置出功能强大的表格。这里我们只是配置表头和数据行15:调用 update 函数,此时界面的表格才能刷新

界面是这样子的:

这种方式需要一开始定义一个空表格,显得不自然

方式二:使用容器

我们可以先定义一个 row 容器作为表格的占位:

行19:定义 row,用变量"拿着" 对象行13:清除容器行14:把表格移到容器里面

这种方式也显得不自然,因为表格的设置(行13-14) 与表格定义的地方(行19) 被划到不同的地方。每次都需要清除容器,比较麻烦。

方式三:定义刷新函数

官方为了解决上述方式的不协调,特意打造了一种刷新装饰器。其实本质上就是方式二的封装:

行20-23:定义函数,并打上 ui.refreshable 装饰器行25:执行函数,相当于方式二中使用容器占位行12: 由于目前的版本,refreshable 不能支持参数,我们只能定义全局变量行15:调用 table box.refresh 函数,相当于方式二中的,把容器内容清空,然后重新执行一次 table box 函数

实话说,这里官方设计不怎么样。这种方式由于全局变量的影响,导致代码更分散。

我已经向官方提了 issue ,未来的版本可能会得到改善

是不是感觉与 streamlit 相比,要麻烦很多?确实是这样子。不过,我们可以利用它的特性,打造出类似 streamlit 的运行方式。下一节我就会详细介绍

打包独立应用

nicegui 特别吸引我的一点是,它可以让我们直接打包成单文件程序,可以在其他没有安装 python 的电脑上运行。

首先,我们需要修改 main.py 的代码:

在 ui.run 函数中,设置2个参数reload = False 是打包必需native = True ,程序启动时,就像普通的程序一样有独立的窗体。如果此参数为False,那么启动时就会触发浏览器打开页面

然后在同目录下创建一个 build.py 文件,代码如下:

这与官方文档有一些不一样。安装官方给的代码,很容易把其他的python环境给打包进来,导致最终文件非常大建议大家使用 venv 创建虚拟环境进行打包

接下来就是执行这个文件即可。成功后,同目录下会看到一个 dist 的文件夹,里面就是打包后的 exe 文件。

篇幅太长了,详细打包细节可以关注后续的文章和视频教程。

如果你喜欢nicegui教程,请一键三连,评论区告诉我。不喜欢就直接划走即可

转发、关注我,私信"nicegui",获得本期源码和数据。

0 阅读:0

我是数据外星人

简介:感谢大家的关注