【kivy screenmanager】WipeTransition 使用效果及語法

本篇開始:

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

【本篇說明】在Kivy這個第三方函式庫(框架)裡面，其中screenmanager模組內建許多類別可以控制轉場效果(Transition)，今天分享其中的 WipeTransition ，它的視覺效果：當切換螢幕時，目前的畫面像是用「掃過(擦拭)」的方式來移除，然後顯現出新畫面。

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, WipeTransition
from kivy.properties import ObjectProperty

Window.size = (290,550)

class FirstPage(Screen):
    pass

class SecondPage(Screen):
    pass

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

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

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

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

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

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

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/18HAaltbVgWGkMCI_eYrDtnS0kaduINcg?usp=sharing

▲如影片1:舊畫面像是用擦拭方式消失、(預設)轉換時間不到1秒，看不太出來效果

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

以下.py程式碼:

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

Window.size = (290,550)

class FirstPage(Screen):
    pass

class SecondPage(Screen):
    pass

class Manager(ScreenManager):
    # 這邊更改，加入duration參數
    tra = ObjectProperty(WipeTransition(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/18HAaltbVgWGkMCI_eYrDtnS0kaduINcg?usp=sharing

▲如影片2:轉換時間4秒

6.本篇小結

了解WipeTransition的基本語法，以"擦拭"方式轉換screen(畫面)，並加入參數(duration)來改變轉場時間。

本篇結束:

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