Textual Learning4 -- binding and action

一、绑定BINDINGS

1.1 简单介绍：

BINDINGS是一个简单的三元组，可以连结到行动方法（action）

1.2 注意事项：

bindings类变量应该用全大写 -- BINDINGS

变量应该是所有密钥绑定的列表（全部的BINDINGS都应该写在一个BINDINGS里面）

1.3 组成说明：

按键绑定：键位名，要触发的方法，描述文档

按键名就是某键按下后执行想要的动作

该描述是对密钥绑定应该做什么的描述，并且是可读的

动作名称应该与方法的名称匹配

1.4 英文介绍：

A binding can be something as simple as a triple that connects a key to a method

Write in caps lock at the bindings class variable -- BINDINGS

And this quest variable is supposed to be a list of all of your key bindings

We are going to have a triple which is going to consist of 3 things

        (key, action name, description)

        the description is the description of what the key binding is supposed to do and it is readable

        the action name should match the name of your method --- But the action method should begin with action!!!!!!

1.5 例子：

class HelloTest(App):

    BINDINGS = [
        ("o","show_my_screen","Author Info"),
        ("d", "toggle_dark_mode", "Toggle dark mode")
        ]

    def compose(self):
        yield Header(show_clock=True)


    def action_show_my_screen(self):
        self.push_screen(AuthorInfo())

    def action_toggle_dark_mode(self):
        self.dark = not self.dark


if __name__ == "__main__":
    app = HelloTest(css_path="./hello.css", watch_css = True)
    app.run()

1.6 位置说明：

BINDINGS与def都在class app 的里面， 并且与def compose有相同的缩进格（缩进一个Tab键）

二、行动action

2.1 位置说明：

action需要定义，def与compose有相同的缩进格（一个Tab键）

而且不同的action的先后顺序不影响实际程序的执行

2.2 易忽视的点：

在定义action时，action的名称前面必须加action，否则按下按键不会执行action内的东西

错误案例：

    def toggle_dark_mode(self):
        self.dark = not self.dark

正确案例：在前面加action及一个下划线：

    def action_toggle_dark_mode(self):
        self.dark = not self.dark