mirror of
https://github.com/Textualize/textual.git
synced 2025-10-17 02:38:12 +03:00
Document styles (#785)
* Add docs for CSS variables * Add ref docs for various styles, fix some typos in places
This commit is contained in:
50
docs/styles/layers.md
Normal file
50
docs/styles/layers.md
Normal file
@@ -0,0 +1,50 @@
|
||||
# Layers
|
||||
|
||||
The `layers` property allows you to define an ordered set of layers.
|
||||
These `layers` can later be referenced using the `layer` property.
|
||||
Layers control the order in which widgets are painted on screen.
|
||||
More information on layers can be found in the [guide](../guide/layout.md#layers).
|
||||
|
||||
## Syntax
|
||||
|
||||
```
|
||||
layers: <STRING> ...;
|
||||
```
|
||||
|
||||
## Example
|
||||
|
||||
In the example below, `#box1` is yielded before `#box2`.
|
||||
However, since `#box1` is on the higher layer, it is drawn on top of `#box2`.
|
||||
|
||||
[//]: # (NOTE: the example below also appears in the guide and 'layer.md'.)
|
||||
|
||||
=== "Output"
|
||||
|
||||
```{.textual path="docs/examples/guide/layout/layers.py"}
|
||||
```
|
||||
|
||||
=== "layers.py"
|
||||
|
||||
```python
|
||||
--8<-- "docs/examples/guide/layout/layers.py"
|
||||
```
|
||||
|
||||
=== "layers.css"
|
||||
|
||||
```sass hl_lines="3 15 19"
|
||||
--8<-- "docs/examples/guide/layout/layers.css"
|
||||
```
|
||||
|
||||
## CSS
|
||||
|
||||
```sass
|
||||
/* Bottom layer is called 'below', layer above it is called 'above' */
|
||||
layers: below above;
|
||||
```
|
||||
|
||||
## Python
|
||||
|
||||
```python
|
||||
# Bottom layer is called 'below', layer above it is called 'above'
|
||||
widget.layers = ("below", "above")
|
||||
```
|
||||
Reference in New Issue
Block a user