Kivy - 文件语法



Kivy 框架提供了一种简洁且声明式的方法来定义窗口小部件的结构和外观,使用 Kivy 语言(也称为 **Kv 语言**)。它是一种声明式语言,专门用于构建 Kivy 应用程序中的用户界面。其主要优点是可以将 UI 设计与用 Python 编写的应用程序逻辑分离。

UI 设计定义在一个文本文件中,该文件必须具有“.kv”扩展名。它包含应用程序窗口中窗口小部件的分层序列。该文件采用树状结构,显示窗口小部件之间的父子兄弟关系。在每个窗口小部件下方,指定其属性、事件和事件处理程序。

**kv** 设计语言在创建“.kv”文件时规定以下约定,以便 Python 和 Kivy 框架能够识别和加载相应的窗口小部件结构:

  • 文件名必须小写

  • 它必须与应用程序中的主类匹配。此类继承自 App 类。

  • 如果类名以“app”或“App”结尾(例如,**HelloApp**),则“.kv”文件必须排除其名称中的“app”。这意味着,对于 HelloApp 类,“.kv”文件的文件名必须为“hello.kv”。

  • “.kv”文件必须与 Python 应用程序文件(.py)位于同一文件夹中。

使用“.kv”文件时,App 类不会覆盖 build() 方法。只需使用 pass 语句声明一个类就足够了。当调用 run() 方法时,Kivy 会自动从相应的“.kv”文件加载 UI。

让我们首先从 HelloApp 类中删除 build() 方法:

示例

from kivy.app import App
class HelloApp(App):
   pass
app = HelloApp()
app.run()

用户界面定义在同一文件夹中的“hello.kv”文件中。我们有一个垂直方向的顶级 BoxLayout,在其下方放置了两个标签。将以下脚本另存为“hello.kv”文件

BoxLayout:
   orientation: 'vertical'
   Label:
      text: 'Python Kivy Tutorial'
      font_size: '30pt'
   Label:
      text: 'From TutorialsPoint'
      font_size: '50'
      color: (1,0,0,1)

现在,如果您运行“hello.py”程序,它将生成以下输出:

输出

kivy file syntax

在后面的章节中,我们将学习如何在“.kv”文件中向窗口小部件添加事件处理程序。

广告