docs/widgets/placeholder.md
!!! tip "Added in version 0.6.0"
A widget that is meant to have no complex functionality. Use the placeholder widget when studying the layout of your app before having to develop your custom widgets.
The placeholder widget has variants that display different bits of useful information. Clicking a placeholder will cycle through its variants.
The example below shows each placeholder variant.
=== "Output"
```{.textual path="docs/examples/widgets/placeholder.py"}
```
=== "placeholder.py"
```python
--8<-- "docs/examples/widgets/placeholder.py"
```
=== "placeholder.tcss"
```css
--8<-- "docs/examples/widgets/placeholder.tcss"
```
| Name | Type | Default | Description |
|---|---|---|---|
variant | str | "default" | Styling variant. One of default, size, text. |
This widget posts no messages.
This widget has no bindings.
This widget has no component classes.
::: textual.widgets.Placeholder options: heading_level: 2