mirror of
https://github.com/Textualize/textual.git
synced 2025-10-17 02:38:12 +03:00
45 lines
1.4 KiB
Markdown
45 lines
1.4 KiB
Markdown
# TextLog
|
|
|
|
A TextLog is a widget which displays scrollable content that may be appended to in realtime.
|
|
|
|
Call [TextLog.write][textual.widgets.TextLog.write] with a string or [Rich Renderable](https://rich.readthedocs.io/en/latest/protocol.html) to write content to the end of the TextLog. Call [TextLog.clear][textual.widgets.TextLog.clear] to clear the content.
|
|
|
|
- [X] Focusable
|
|
- [ ] Container
|
|
|
|
## Example
|
|
|
|
The example below shows each placeholder variant.
|
|
|
|
=== "Output"
|
|
|
|
```{.textual path="docs/examples/widgets/text_log.py" press="_,H,i"}
|
|
```
|
|
|
|
=== "text_log.py"
|
|
|
|
```python
|
|
--8<-- "docs/examples/widgets/text_log.py"
|
|
```
|
|
|
|
|
|
|
|
## Reactive Attributes
|
|
|
|
| Name | Type | Default | Description |
|
|
| ----------- | ------ | ------- | ------------------------------------------------------------ |
|
|
| `highlight` | `bool` | `False` | Automatically highlight content. |
|
|
| `markup` | `bool` | `False` | Apply Rich console markup. |
|
|
| `max_lines` | `int` | `None` | Maximum number of lines in the log or `None` for no maximum. |
|
|
| `min_width` | `int` | 78 | Minimum width of renderables. |
|
|
| `wrap` | `bool` | `False` | Enable word wrapping. |
|
|
|
|
## Messages
|
|
|
|
This widget sends no messages.
|
|
|
|
|
|
## See Also
|
|
|
|
* [TextLog](../api/text_log.md) code reference
|