【kivy property】ObjectProperty屬性的用法｜Kivy基礎用法

2025/12/10 更新2025/12/10 發佈閱讀 7 分鐘

本篇開始:

我的開發環境是win11
python是3.10.7版本
kivy我設定在2.1.0版本
編碼的工具是Visual Studio Code(VS Code)

【本篇說明】在kivy裡面，屬性(property)有分很多種，比如說 NumericProperty、ColorProperty、ObjectProperty、BooleanProperty 等等，這次分享的是 ObjectProperty (字面翻譯為"物件屬性")，專門用來存放物件，也可以用來跟kivy widget綁在一起，方便程式碼撰寫。

以下分享我使用上的基本語法:

寫下固定的程式碼

以下.py程式碼:(在vscode開啟python檔案，取名為main.py，以下簡稱.py)

from kivy.app import App
from kivy.uix.boxlayout import BoxLayout

class firstlayout(BoxLayout):
    pass

class Mainapp(App):
    def build(self):
        return firstlayout()

if __name__ == "__main__":
    Mainapp().run()

▲說明:

1.從 kivy.uix.boxlayout這個模組導入 BoxLayout類別 (如果還沒看過，可參考:【kivy layout】BoxLayout類別基本使用)

2.創建一個class 類別取名為 firstlayout(可自取無限定命名)，然後在()填入 BoxLayout，目的是為了繼承 BoxLayout類別所有特性

3.這邊 kivy language(kv)，我使用的是"相同命名方式"，如果不太懂我說的，可先參考這篇:【kivy language】如何使用 kivy language(kv)

▲說明:main.py程式碼

將屬性及函式寫入main.py

1.以下 main.py程式碼:

from kivy.properties import NumericProperty, ObjectProperty

▲說明:導入所需的屬性

2.改寫 firstlayout類別內容

class firstlayout(BoxLayout):
    a1 = NumericProperty(10)   
    a2 = ObjectProperty()
  
    def btn(self):
        self.a1 += 5

    def on_a1(self, instance, value):
        print("a1屬性值被改變了，為:", value)
        self.a2.text = f'label.text_size is {value}'

▲說明:

1.宣告 a1為10的 NumericProperty，預設值為0

2.宣告 a2為None的ObjectProperty，預設為None

3.定義函式 btn()，()裡面寫 "self"這個必要參數，當呼叫函式會執行: a1 + 5 (原碼也可寫成 self.a1 = self.a1 +5)

4.屬性特有的觸發事件，當屬性值發生改變時，就能觸發函式。命名時必須是on_加上屬性名稱

5.定義函式 on_a1()，()裡面加入 self, instance, value 這3個參數，其中 value為 a1的數值

6.另列印出 a1屬性值來確認，看看是否每次增加5

7.讓 a2的 text參數等於格式化字串

▲說明:main.py程式碼

在 VSCode新增(kivy)檔案，我取名 main.kv，為了符合上面說的"相同命名方式"，並且放在同資料夾內

▲說明:我的是放在以下路徑:桌面-> python-> Kivy-> test

寫入 main.kv程式碼

以下.kv程式碼:(在vscode編輯 main.kv，簡稱.kv)

<firstlayout>:
    orientation: 'vertical'
    a2:b2

    Label:
        id:b2
        text: 'Nothing happen'
        font_size: root.a1

    Button:
        text:'press to change'
        font_size: 30
        on_press: root.btn()