前言

之前小编用Python做GUI界面，首选就是Tkinter、PyQt5 。但是它们实现起来工作量及代码量太大，还要一步步设计调试界面排版等问题，而且界面最终呈现也不是特别美观，还有就是打包后太大等一系列问题。

最近公司同事刚好有个相关界面开发需求，给我推荐了Python的新型Gui库，不仅可以做本地GUI程序，还可以同步生成一个Web Gui 服务，将Gui界面同步到浏览器上展示。它就是 nicegui。

NiceGui介绍

NiceGui 是一个简单易用的基于Python的Web-UI框架，其目的是使在Python中开发前端应用程序变得容易。

小编也看了下其源代码，Web相关服务/路由等是基于Python FastAPI 框架构建的。而 UI 元素基于 Vue 和 Quasar。NiceGui 带有许多现成的元素。它甚至允许不同元素之间的值绑定。可以轻松显示各种图表。

主要功能：

• 预加载了随时可用的 GUI 元素，如按钮、标签、复选框、滑块、开关等
• 表情符号图标、SVG 和 base64 支持
• 提供简单的数据绑定
• 用于刷新数据的内置定时器
• 能够渲染 3D 场景，绘制图表
• 可以轻松显示图像和视频
• 它使自定义页面和布局变得容易，并且内置了对 Tailwind CSS 的支持

NiceGui的安装和使用

1、安装

使用 pip 下载 NiceGui（仅支持3.7及以上版本）

pip install nicegui

2、编写一个简单代码，测试其功能是否正常

from nicegui import ui
# 创建一个标签
ui.label('Welcome to NiceGui!')  
# 创建一个按钮，设置回调函数，调用niceui的弹窗消息通知
ui.button('Click Here', on_click=lambda: ui.notify('Button Pressed'))
# niceui 运行
ui.run()

点击运行后，终端会输出web url访问地址，自动打开浏览器

NiceGUI ready to go on http://localhost:8080, and http://192.168.0.102:8080

NiceGui 基本元素的使用

1、图标和链接

ui.label('Display Icon')
ui.icon('settings', color='primary').classes('text-5xl')
ui.link('NiceGui on GitHub', 'https://github.com/zauberzeug/nicegui')
ui.run()

从上面的代码创建以下函数：

• icon() ：此函数允许我们在 UI 上显示图标。要显示一个图标，我们需要提供一个图标名称。此功能依赖于 Quasar 的 QIcon。可以使用 CSS、Quasar 或 Tailwind 颜色指定颜色选项。大小选项由 classes() 方法使用 CSS 单位确定。
• link() 此函数使我们能够将链接分配给 UI 中的文本。首先，我们指定应链接的文本，然后是相应的网站 URL。

运行代码将产生以下输出：

2、选择元素

NiceGui 有不同的选择元素，如切换框、单选框和复选框。

ui.label('Toggle Box')
toggle = ui.toggle([1, 2, 3], value=1)

ui.label('Radio Select')
radio = ui.radio(["one", "two", "three"], value=1).props('inline')

ui.label('Dropdown Select')
select = ui.select(["red", "blue", "green"], value=1)

ui.label('Check Box')
checkbox = ui.checkbox('check me')

ui.run()

上面代码中的函数包括：

• toggle()：此函数可以生成一个切换框，我们在其中通过包含值到标签的映射的字典值列表传递选项。当用户选择一个选项时，它被保存在toggle变量中。
• radio()：这类似于 toggle() 函数，但在这里我们可以选择单选选项。
• select()：此函数生成一个下拉列表以选择特定选项。与上述函数相比，此函数的输入和存储的输出值相同。
• checkbox()：当用户选中复选框时，checkbox 变量被分配一个布尔值 True。

在这里，我们看到了我们创建的所有选择元素。单击 Dropdown Select，出现下拉操作，允许我们选择其中一个选项。这些只是我们研究过的部分元素。NiceGui 提供了广泛的元素以在各种场景中使用。

而且 NiceGui 支持不同 UI 元素之间的绑定值，允许无缝集成。

ui.label("Value Bindings")

with ui.row():
    radio1 = ui.radio([1, 2, 3], value=1).props('inline')
    toggle = ui.toggle({1: 'A', 2: 'B', 3: 'C'}).props('inline').bind_value(radio1, 'value')

ui.run()

在上面的代码中，我们使用 ui.row() 元素将两个元素（radio 和 toggle）水平分组。要将它们垂直分组，我们可以使用 ui.column()。toggle() 函数包含变量 bind_values()，它将单选选项连接到切换选项。

在上面的图片中，我们可以清楚地看到两个 UI 元素之间的值绑定。同样，bind_value() 函数能够在 NiceGUI 提供的不同 UI 元素中工作。

3、用户输入和值绑定

允许用户在 UI 中输入文本或数字数据的功能。

ui.input(label='Text',
         on_change=lambda e: text_input.set_text('输入文本: ' + e.value))
text_input = ui.label()

ui.number(label='Number', value=3.1415, format='%.2f',
          on_change=lambda e: number_input.set_text('输入数字: ' + str(e.value)))
number_input = ui.label()

ui.run()

上面代码中的函数包括：

• input()：使用此函数时，将创建一个空文本框，用户可以在其中键入数据。它有一个名为“ label ”的变量，它告诉用户它期望的输入类型。每当用户在输入框中输入内容时，ui.label() 的 .set_text() 函数就会激活并在屏幕上显示键入的文本。
• number()：此函数的工作方式与 input() 函数类似，唯一的区别是此函数接受数字而不是文本

代码运行时，将产生以下输出：

4、数据元素和图表

通过 NiceGui显示表格数据。

columns = [
    {'name': 'Name', 'label': 'Name', 'field': 'Name', 'required': True, 'align': 'center'},
    {'name': 'Sex', 'label': 'Sex', 'field': 'Sex'},
    {'name': 'Age', 'label': 'Age', 'field': 'Age'}
]
rows = [
    {'Name': '张三', 'Sex': "男", 'Age': 22},
    {'Name': '吴梅', 'Sex': "女", 'Age': 15},
    {'Name': '沈静', 'Sex': "女", 'Age': 25},
    {'Name': '王五', 'Sex': "男", 'Age': 18},
]

ui.table(title='Person Info', columns=columns, rows=rows, row_key='Name')

ui.run()

要显示表格，请在列列表中指定列名。每列由列表中的字典表示。包括每列的名称、标签和字段值（通常所有列都相同）。可以根据需要提供额外的键值对。

例如，“required:True”键值对确保名称列需要添加到表中的任何新元素的值。“align”:”center” 将整个行对齐到该列名称下的居中对齐方式。

接下来是行列表。行列表是包含上述列值的字典列表。这里使用字段名称，我们在字典中提供field:value对。然后使用 ui.table() 函数，我们将表格显示到 UI。在这里我们可以给表格命名。row_key 的列名包含唯一值。

运行此代码将给出以下输出：

带有 NiceGui的 Pandas DataFrame

使用 table() 函数本身可以显示 Pandas 数据。

data = pd.DataFrame(data={'Name': ["张三", "吴梅"], 'Age': [22, 15]})
ui.table(
    columns=[{'name': column, 'label': column, 'field': column} for column in data.columns],
    rows=data.to_dict('records'),
)

ui.run()

使用 NiceGUI 在屏幕上显示图形

使用 NiceGUI 中的 pyplot() 函数，它在 UI 上显示 matplotlib 图形。

import matplotlib
import numpy
from nicegui import ui

with ui.pyplot(figsize=(3, 2)):
    x = numpy.linspace(0.0, 10000.0, 10)
    y = numpy.log(x)
    matplotlib.pyplot.title('Log Graph')
    matplotlib.pyplot.plot(x, y, '-')

ui.run()

在这里，我们使用 with 命令，然后使用 ui.pyplot() 函数。我们甚至将图的大小传递给函数。

现在，在with下面，我们编写通过matplotlib绘制图形的代码。这里我们编写了一个简单的图，其中x轴包含从0到10000的值，步长为10，y轴包含它们的对数值。

代码运行时的输出将是:

结论

开发人员使用 NiceGui（一种 Python Web 框架）来创建网站应用程序。其提供了必要的工具来开发一个完整的网站，所有的前端部分都完全在 Python 中。我们甚至看到了 NiceGUI 的不同元素以及如何接受用户输入。最后，我们通过绑定值了解了我们可以在不同的 UI 元素之间进行绑定的方法。