mirror of
https://github.com/Textualize/textual.git
synced 2025-10-17 02:38:12 +03:00
196d430582
Textual CSS is better highlighted in SASS code blocks because the SASS parser seems to be more lenient.
86 lines
3.1 KiB
Markdown
86 lines
3.1 KiB
Markdown
# Padding
|
|
|
|
The `padding` rule specifies spacing around the content of a widget.
|
|
|
|
## Syntax
|
|
|
|
--8<-- "docs/snippets/syntax_block_start.md"
|
|
padding: <a href="../../css_types/integer"><integer></a> # one value for all edges
|
|
| <a href="../../css_types/integer"><integer></a> <a href="../../css_types/integer"><integer></a>
|
|
# top/bot left/right
|
|
| <a href="../../css_types/integer"><integer></a> <a href="../../css_types/integer"><integer></a> <a href="../../css_types/integer"><integer></a> <a href="../../css_types/integer"><integer></a>;
|
|
# top right bot left
|
|
|
|
padding-top: <a href="../../css_types/integer"><integer></a>;
|
|
padding-right: <a href="../../css_types/integer"><integer></a>;
|
|
padding-bottom: <a href="../../css_types/integer"><integer></a>;
|
|
padding-left: <a href="../../css_types/integer"><integer></a>;
|
|
--8<-- "docs/snippets/syntax_block_end.md"
|
|
|
|
The `padding` specifies spacing around the _content_ of a widget, thus this spacing is added _inside_ the widget.
|
|
The values of the [`<integer>`](../../css_types/integer) determine how much spacing is added and the number of values define what edges get what padding:
|
|
|
|
- 1 [`<integer>`](../../css_types/integer) sets the same padding for the four edges of the widget;
|
|
- 2 [`<integer>`](../../css_types/integer) set padding for top/bottom and left/right edges, respectively.
|
|
- 4 [`<integer>`](../../css_types/integer) set padding for the top, right, bottom, and left edges, respectively.
|
|
|
|
!!! tip
|
|
|
|
To remember the order of the edges affected by the rule `padding` when it has 4 values, think of a clock.
|
|
Its hand starts at the top and the goes clockwise: top, right, bottom, left.
|
|
|
|
Alternatively, padding can be set for each edge individually through the rules `padding-top`, `padding-right`, `padding-bottom`, and `padding-left`, respectively.
|
|
|
|
## Example
|
|
|
|
This example adds padding around some text.
|
|
|
|
=== "Output"
|
|
|
|
```{.textual path="docs/examples/styles/padding.py"}
|
|
```
|
|
|
|
=== "padding.py"
|
|
|
|
```python
|
|
--8<-- "docs/examples/styles/padding.py"
|
|
```
|
|
|
|
=== "padding.css"
|
|
|
|
```sass
|
|
--8<-- "docs/examples/styles/padding.css"
|
|
```
|
|
|
|
## CSS
|
|
|
|
```sass
|
|
/* Set padding of 1 around all edges */
|
|
padding: 1
|
|
/* Set padding of 2 on the top and bottom edges, and 4 on the left and right */
|
|
padding: 2 4;
|
|
/* Set padding of 1 on the top, 2 on the right,
|
|
3 on the bottom, and 4 on the left */
|
|
padding: 1 2 3 4;
|
|
|
|
padding-top: 1;
|
|
padding-right: 2;
|
|
padding-bottom: 3;
|
|
padding-left: 4;
|
|
```
|
|
|
|
## Python
|
|
|
|
In Python, you cannot set any of the individual `padding` rules `padding-top`, `padding-right`, `padding-bottom`, and `padding-left`.
|
|
|
|
However, you _can_ set padding to a single integer, a tuple of 2 integers, or a tuple of 4 integers:
|
|
|
|
```python
|
|
# Set padding of 1 around all edges
|
|
widget.styles.padding = 1
|
|
# Set padding of 2 on the top and bottom edges, and 4 on the left and right
|
|
widget.styles.padding = (2, 4)
|
|
# Set padding of 1 on top, 2 on the right, 3 on the bottom, and 4 on the left
|
|
widget.styles.padding = (1, 2, 3, 4)
|
|
```
|