input docs an exampels

docs/examples/guide/input/key01.py

@@ -0,0 +1,21 @@
+from textual.app import App, ComposeResult
+from textual.widgets import TextLog
+from textual import events
+
+
+class InputApp(App):
+    """App to display key events."""
+
+    def compose(self) -> ComposeResult:
+        yield TextLog()
+
+    def on_key(self, event: events.Key) -> None:
+        self.query_one(TextLog).write(event)
+
+    def key_space(self) -> None:
+        self.bell()
+
+
+if __name__ == "__main__":
+    app = InputApp()
+    app.run()

docs/examples/guide/input/key02.css

@@ -0,0 +1,12 @@
+Screen {
+    layout: horizontal;
+}
+
+KeyLogger {
+    width: 1fr;
+    border: blank;
+}
+
+KeyLogger:focus {
+    border: wide $accent;
+}

docs/examples/guide/input/key02.py

@@ -0,0 +1,23 @@
+from textual.app import App, ComposeResult
+from textual.widgets import TextLog
+from textual import events
+
+
+class KeyLogger(TextLog):
+    def on_key(self, event: events.Key) -> None:
+        self.write(event)
+
+
+class InputApp(App):
+    """App to display key events."""
+
+    CSS_PATH = "input02.css"
+
+    def compose(self) -> ComposeResult:
+        yield KeyLogger()
+        yield KeyLogger()
+
+
+if __name__ == "__main__":
+    app = InputApp()
+    app.run()

docs/examples/guide/input/mouse01.css

@@ -0,0 +1,24 @@
+Screen {
+    layers: log ball;
+}
+
+TextLog {
+    layer: log;
+}
+
+PlayArea { 
+    background: transparent;
+    layer: ball;
+    
+}
+Ball {
+    layer: ball;
+    width: auto;
+    height: 1;
+    background: $secondary;
+    border: tall $secondary;    
+    color: $background;
+    box-sizing: content-box;
+    text-style: bold;
+    padding: 0 4;
+}

docs/examples/guide/input/mouse01.py

@@ -0,0 +1,31 @@
+from textual.app import App, ComposeResult
+
+from textual import events
+from textual.layout import Container
+from textual.widgets import Static, TextLog
+
+
+class PlayArea(Container):
+    def on_mount(self) -> None:
+        self.capture_mouse()
+
+    def on_mouse_move(self, event: events.MouseMove) -> None:
+        self.screen.query_one(TextLog).write(event)
+        self.query_one(Ball).offset = event.offset - (8, 2)
+
+
+class Ball(Static):
+    pass
+
+
+class MouseApp(App):
+    CSS_PATH = "mouse01.css"
+
+    def compose(self) -> ComposeResult:
+        yield TextLog()
+        yield PlayArea(Ball("Textual"))
+
+
+if __name__ == "__main__":
+    app = MouseApp()
+    app.run()