【kivy screenmanager】FallOutTransition 使用效果及語法｜Kivy基礎用法

2026/01/07 更新2026/01/07 發佈閱讀 9 分鐘

本篇開始:

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

【本篇說明】】在Kivy這個第三方函式庫(框架)裡面，其中screenmanager模組內建許多類別可以控制轉場效果(Transition)，今天分享其中的 FallOutTransition ，它的視覺效果是：當切換螢幕時，目前的畫面像是「掉進背景」，逐漸向中間縮小而消失，同時以顯現出新畫面。

先在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, FallOutTransition
from kivy.properties import ObjectProperty

Window.size = (290,550)

class FirstPage(Screen):
    pass

class SecondPage(Screen):
    pass

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

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、FallOutTransition類別

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

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

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

7.在Manager類別裡面，創建變數tra，使其為ObjectProperty類，並繼承FallOutTransition類，代表現在screen轉換模式為FallOutTransition

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

▲說明:main.py程式碼

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

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

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

加入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程式碼

執行 Python檔案

請點擊網址觀看影片:

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

▲如影片1:舊畫面向中心位置消失、(預設)轉換時間不到1秒

可改變轉換時間(註:無法改變轉換方向)

以下.py程式碼:

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

Window.size = (290,550)

class FirstPage(Screen):
    pass

class SecondPage(Screen):
    pass

class Manager(ScreenManager):
    # 這邊更改，加入duration參數
    tra = ObjectProperty(FallOutTransition(duration=3))

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