1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
|
# Opacity
The `opacity` style sets the opacity of a widget.
While terminals are not capable of true opacity, Textual can create an approximation by blending widgets with their background color.
## Syntax
--8<-- "docs/snippets/syntax_block_start.md"
opacity: <a href="../../css_types/number"><number></a> | <a href="../../css_types/percentage"><percentage></a>;
--8<-- "docs/snippets/syntax_block_end.md"
The opacity of a widget can be set as a [`<number>`](../css_types/number.md) or a [`<percentage>`](../css_types/percentage.md).
If given as a number, then `opacity` should be a value between 0 and 1, where 0 is the background color and 1 is fully opaque.
If given as a percentage, 0% is the background color and 100% is fully opaque.
Typically, if you set this value it would be somewhere between the two extremes.
For instance, setting the opacity of a widget to `70%` will make it appear dimmer than surrounding widgets, which could be used to display a *disabled* state.
## Example
This example shows, from top to bottom, increasing opacity values for a label with a border and some text.
When the opacity is zero, all we see is the (black) background.
=== "Output"
```{.textual path="docs/examples/styles/opacity.py"}
```
=== "opacity.py"
```python
--8<-- "docs/examples/styles/opacity.py"
```
=== "opacity.tcss"
```css hl_lines="2 6 10 14 18"
--8<-- "docs/examples/styles/opacity.tcss"
```
## CSS
```css
/* Fade the widget to 50% against its parent's background */
opacity: 50%;
```
## Python
```python
# Fade the widget to 50% against its parent's background
widget.styles.opacity = "50%"
```
## See also
- [`text-opacity`](./text_opacity.md) to blend the color of a widget's content with its background color.
|
