Merge pull request #837 from Textualize/table-polish

Table polish

docs/examples/widgets/table.py

@@ -0,0 +1,29 @@
+import csv
+import io
+
+from textual.app import App, ComposeResult
+from textual.widgets import DataTable
+
+CSV = """lane,swimmer,country,time
+4,Joseph Schooling,Singapore,50.39
+2,Michael Phelps,United States,51.14
+5,Chad le Clos,South Africa,51.14
+6,László Cseh,Hungary,51.14
+3,Li Zhuhao,China,51.26
+8,Mehdy Metella,France,51.58
+7,Tom Shields,United States,51.73
+1,Aleksandr Sadovnikov,Russia,51.84"""
+
+
+class TableApp(App):
+    def compose(self) -> ComposeResult:
+        yield DataTable()
+
+    def on_mount(self) -> None:
+        table = self.query_one(DataTable)
+        rows = csv.reader(io.StringIO(CSV))
+        table.add_columns(*next(rows))
+        table.add_rows(rows)
+
+
+app = TableApp()

docs/getting_started.md

@@ -25,13 +25,13 @@ You can install Textual via PyPI.
 If you plan on developing Textual apps, then you should install `textual[dev]`. The `[dev]` part installs a few extra dependencies for development.
 
 ```
-pip install "textual[dev]==0.2.0b4"
+pip install "textual[dev]==0.2.0b5"
 ```
 
 If you only plan on _running_ Textual apps, then you can drop the `[dev]` part:
 
 ```
-pip install textual==0.2.0b4
+pip install textual==0.2.0b5
 ```
 
 !!! important

docs/reference/data_table.md

@@ -0,0 +1 @@
+::: textual.widgets.DataTable

docs/widgets/data_table.md

@@ -1 +1,38 @@
 # DataTable
+
+A data table widget.
+
+- [x] Focusable
+- [ ] Container
+
+## Example
+
+The example below populates a table with CSV data.
+
+=== "Output"
+
+    ```{.textual path="docs/examples/widgets/table.py"}
+    ```
+
+=== "table.py"
+
+    ```python
+    --8<-- "docs/examples/widgets/table.py"
+    ```
+
+
+## Reactive Attributes
+
+| Name            | Type   | Default | Description                        |
+| --------------- | ------ | ------- | ---------------------------------- |
+| `show_header`   | `bool` | `True`  | Show the table header              |
+| `fixed_rows`    | `int`  | `0`     | Number of fixed rows               |
+| `fixed_columns` | `int`  | `0`     | Number of fixed columns            |
+| `zebra_stripes` | `bool` | `False` | Display alternating colors on rows |
+| `header_height` | `int`  | `1`     | Height of header row               |
+| `show_cursor`   | `bool` | `True`  | Show a cell cursor                 |
+
+
+## See Also
+
+* [Table][textual.widgets.DataTable] code reference