【kivy screenmanager】SlideTransition 的語法｜Kivy基礎用法

2025/12/31 更新2025/12/31 發佈閱讀 9 分鐘

本篇開始:

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

【本篇說明】在kivy這個第三方函式庫裡面，其中screenmanager模組內有許多類別可以控制轉場效果(Transition)，今天分享其中的 SlideTransition，示範如何使screen螢幕切換時產生左右滑動(slide)的視覺效果。

1.先在main.py主程式寫下程式碼

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

from kivy.app import App
from kivy.core.window import Window
from kivy.uix.screenmanager import Screen, ScreenManager, SlideTransition
from kivy.properties import ObjectProperty

Window.size = (290,550)

class FirstPage(Screen):
    pass

class SecondPage(Screen):
    pass

class Manager(ScreenManager):
    tra = ObjectProperty(SlideTransition())

class main(App):
    def build(self):
        return Manager()
    
if __name__ == "__main__":
    main().run()

▲說明:

1.從kivy.app模組，導入App類別

2.從kivy.core.window模組，導入Window類別 (為了調整視窗大小)

3.從kivy.uix.screenmanager模組，導入Screen、ScreenManager、SlideTransition類別

4.設定畫面大小為 (290,550)，可參考:【kivy window】視窗大小原來可以自己決定!

5.定義FirstPage、SecondPage類，使其繼承Screen類別的屬性及方法(函式)

6.定義Manager類，使其繼承ScreenManager類別的屬性及方法(函式)

7.在Manager類別裡面，創建變數tra，使其為ObjectProperty類，值為SlideTransition()，代表現在screen轉換模式為SlideTransition

8.定義main類，使其繼承App類，創建函式build()，並回傳Manager類別內容

▲說明:main.py程式碼

2.在VSCode新增(kivy)檔案，取名 main.kv

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

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

3.加入main.kv內容

以下.kv程式碼:(在vscode編輯kivy檔案，取名為main.kv，以下簡稱.kv)

<FirstPage>
    name: 'firstpage'

    BoxLayout:
        Button:
            text: 'go to secondpage'
            on_release: root.manager.current = 'secondpage' 
    
<SecondPage>
    name: 'secondpage'

    BoxLayout:
        Button:
            text: 'go to firstpage'
            on_release: root.manager.current = 'firstpage'   

<Manager>
    transition: root.tra
    FirstPage:
    SecondPage:

▲說明:

1.在<firstpage>裡面加入 name參數，並使其等於 'firstpage'

2.加入Button物件，使用觸發函式on_release，並呼叫 manager.current函式，用來決定目前screen呈現為secondpage，可參考:【kivy Button】經常使用的Button(按鈕)語法

3.在<SecondPage>裡面加入 name參數，並使其等於 'secondpage'

4.加入Button物件，使用觸發函式on_release，並呼叫 manager.current函式，用來決定目前screen呈現為firstpage

5.在<Manager>裡面加入transition、FirstPage 以及SecondPage

6.並在transition參數等於根物件(也就是Manager類別)的tra變數

▲說明:main.kv程式碼

4.執行 Python檔案

https://drive.google.com/drive/folders/1wwi7Ow__Yh0s55gvFiOFlucGm2OdKhE4?usp=sharing

▲如影片1:預設為向左滑動、轉換時間1秒

5.可改變滑動方向、轉換時間

以下.py程式碼:

from kivy.app import App
from kivy.core.window import Window
from kivy.uix.screenmanager import Screen, ScreenManager, SlideTransition
from kivy.properties import ObjectProperty

Window.size = (290,550)

class FirstPage(Screen):
    pass

class SecondPage(Screen):
    pass

class Manager(ScreenManager):
    # 這邊更改
    tra = ObjectProperty(SlideTransition(duration=3, direction='right'))

class main(App):
    def build(self):
        return Manager()
    
if __name__ == "__main__":
   main().run()