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

本篇開始:

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

【本篇說明】在Kivy這個第三方函式庫(框架)裡面，其中screenmanager模組內建許多類別可以控制轉場效果(transition)，其中的 FadeTransition ，它的視覺效果:當切換螢幕時，新畫面會在原地出現，以「淡入淡出」的方式，適用場景:通常在不同功能切換時，例如從設定頁面跳回主頁。

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

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

Window.size = (290,550)

class FirstPage(Screen):
    pass

class SecondPage(Screen):
    pass

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

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

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

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

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

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

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/1pSXcBXtauPKBURd72AVclh6BuhwoYuRX?usp=sharing

▲如影片1:新畫面在原地出現、(預設)轉換時間不到1秒

5.可改變轉換時間(註:不支援方向轉換設定)

以下.py程式碼:

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

Window.size = (290,550)

class FirstPage(Screen):
    pass

class SecondPage(Screen):
    pass

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

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

▲說明:main.py程式碼

【說明】加入duration參數，轉換時間為4(s)

請點擊網址觀看影片:

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

▲如影片2:加入duration參數，轉換時間為4(s)

6.本篇小結

了解FadeTransition的基本語法，從原地位置以"淡出"及"淡入"方式轉換screen(畫面)，並透過參數(duration)可改變切換時間。

本篇結束:

在自學路上遇到困難是很正常的事，只要堅持到底，相信就會有所成果，期勉大家一同努力。