mirror of
https://github.com/Textualize/textual.git
synced 2025-10-17 02:38:12 +03:00
Update reference for min/max width/height.
This commit is contained in:
@@ -1,30 +1,60 @@
|
||||
# Min-width
|
||||
|
||||
The `min-width` rules sets a minimum width for a widget.
|
||||
The `min-width` rule sets a minimum width for a widget.
|
||||
|
||||
## Syntax
|
||||
|
||||
```
|
||||
min-width: <SCALAR>;
|
||||
```
|
||||
--8<-- "docs/snippets/syntax_block_start.md"
|
||||
min-width: <a href="../css_types/scalar.md"><scalar></a>;
|
||||
--8<-- "docs/snippets/syntax_block_end.md"
|
||||
|
||||
The `min-width` rule accepts a [`<scalar>`](../css_types/scalar.md) that defines a lower bound for the [`width`](./width.md) of a widget.
|
||||
That is, the width of a widget is never allowed to be under `min-width`.
|
||||
|
||||
### Values
|
||||
|
||||
--8<-- "docs/snippets/type_syntax/scalar.md"
|
||||
|
||||
## Example
|
||||
|
||||
The example below shows some placeholders with their width set to `50%`.
|
||||
Then, we set `min-width` individually on each placeholder.
|
||||
|
||||
=== "Output"
|
||||
|
||||
```{.textual path="docs/examples/styles/min_width.py"}
|
||||
```
|
||||
|
||||
=== "min_width.py"
|
||||
|
||||
```py
|
||||
--8<-- "docs/examples/styles/min_width.py"
|
||||
```
|
||||
|
||||
=== "min_width.css"
|
||||
|
||||
```css hl_lines="13"
|
||||
--8<-- "docs/examples/styles/min_width.css"
|
||||
```
|
||||
|
||||
1. This won't affect the placeholder because its width is larger than the minimum width.
|
||||
|
||||
## CSS
|
||||
|
||||
```sass
|
||||
|
||||
/* Set a minimum width of 10 cells */
|
||||
/* Set the minimum width to 10 rows */
|
||||
min-width: 10;
|
||||
|
||||
/* Set a minimum width of 25% of the screen width */
|
||||
min-width: 25vw;
|
||||
/* Set the minimum width to 25% of the viewport width */
|
||||
min-width: 25vh;
|
||||
```
|
||||
|
||||
## Python
|
||||
|
||||
```python
|
||||
# Set the minimum width to 10 cells
|
||||
# Set the minimum width to 10 rows
|
||||
widget.styles.min_width = 10
|
||||
|
||||
# Set the minimum width to 25% of the screen width
|
||||
widget.styles.min_width = "25vw"
|
||||
# Set the minimum width to 25% of the viewport width
|
||||
widget.styles.min_width = "25vh"
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user