Skip to content

Commit bbe38f7

Browse files
authored
faq entry on Transparent backgrounds (#2319)
* faq entry * word * update to words
1 parent 66a6448 commit bbe38f7

File tree

2 files changed

+25
-0
lines changed

2 files changed

+25
-0
lines changed

FAQ.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@
55
- [Does Textual support images?](#does-textual-support-images)
66
- [How can I fix ImportError cannot import name ComposeResult from textual.app ?](#how-can-i-fix-importerror-cannot-import-name-composeresult-from-textualapp-)
77
- [How can I select and copy text in a Textual app?](#how-can-i-select-and-copy-text-in-a-textual-app)
8+
- [How can I set a translucent app background?](#how-can-i-set-a-translucent-app-background)
89
- [How do I center a widget in a screen?](#how-do-i-center-a-widget-in-a-screen)
910
- [How do I pass arguments to an app?](#how-do-i-pass-arguments-to-an-app)
1011
- [Why do some key combinations never make it to my app?](#why-do-some-key-combinations-never-make-it-to-my-app)
@@ -42,6 +43,16 @@ may expect from the command line. The exact modifier key depends on the terminal
4243

4344
Refer to the documentation for your terminal emulator, if it is not listed above.
4445

46+
<a name="how-can-i-set-a-translucent-app-background"></a>
47+
## How can I set a translucent app background?
48+
49+
Some terminal emulators have a translucent background feature which allows the desktop underneath to be partially visible.
50+
51+
This feature is unlikely to work with Textual, as the translucency effect requires the use of ANSI background colors, which Textual doesn't use.
52+
Textual uses 16.7 million colors where available which enables consistent colors across all platforms and additional effects which aren't possible with ANSI colors.
53+
54+
For more information on ANSI colors in Textual, see [Why no Ansi Themes?](#why-doesnt-textual-support-ansi-themes).
55+
4556
<a name="how-do-i-center-a-widget-in-a-screen"></a>
4657
## How do I center a widget in a screen?
4758

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
---
2+
title: "How can I set a translucent app background?"
3+
alt_titles:
4+
- "Transparent background not working"
5+
- "Translucent background not working"
6+
- "Can't see desktop underneath terminal"
7+
---
8+
9+
Some terminal emulators have a translucent background feature which allows the desktop underneath to be partially visible.
10+
11+
This feature is unlikely to work with Textual, as the translucency effect requires the use of ANSI background colors, which Textual doesn't use.
12+
Textual uses 16.7 million colors where available which enables consistent colors across all platforms and additional effects which aren't possible with ANSI colors.
13+
14+
For more information on ANSI colors in Textual, see [Why no Ansi Themes?](#why-doesnt-textual-support-ansi-themes).

0 commit comments

Comments
 (0)