Merge pull request #6546 from Textualize/ansi-opacity

text opacity change

Author: willmcgugan

CHANGELOG.md

@@ -5,21 +5,26 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
-## Unreleased 
+## [8.2.7] - 2026-05-19 
 
 ### Added
 
-- Added support for Kitty key protocol "Report all keys as escape codes" which enabled alt+backspace on Warp
-- Added support for detecting separate modifier keys for terminals that support the Kitty key protocol
-- Added `TEXTUAL_DISABLE_KITTY_KEY` env var to disable Kitty key protocol support (debug aid).
+- Added support for Kitty key protocol "Report all keys as escape codes" which enabled alt+backspace on Warp https://github.com/Textualize/textual/pull/6544
+- Added support for detecting separate modifier keys for terminals that support the Kitty key protocol https://github.com/Textualize/textual/pull/6544
+- Added `TEXTUAL_DISABLE_KITTY_KEY` env var to disable Kitty key protocol support (debug aid). https://github.com/Textualize/textual/pull/6544
 
 ### Changed
 
-- Undo/redo/copy/cut/paste in TextArea will now work with cmd+ on supported terminals
-- In TextArea, ctrl+u will now delete a newline if the cursor is at the start
-- in TextArea alt+delete is now bound to delete word right
+- Undo/redo/copy/cut/paste in TextArea will now work with cmd+ on supported terminals https://github.com/Textualize/textual/pull/6543
+- In TextArea, ctrl+u will now delete a newline if the cursor is at the start https://github.com/Textualize/textual/pull/6543
+- in TextArea alt+delete is now bound to delete word right https://github.com/Textualize/textual/pull/6543
+- Text opacity applied to an ansi theme will now set the dim attribute if the opacity is < 50% https://github.com/Textualize/textual/pull/6546
 
-## [8.2.6] - 2026-04-13
+### Fixed
+
+- Fixed text opacity with ANSI themes creating RGB colors.  https://github.com/Textualize/textual/pull/6546
+
+## [8.2.6] - 2026-05-13
 
 ### Fixed
 
@@ -3459,6 +3464,7 @@ https://textual.textualize.io/blog/2022/11/08/version-040/#version-040
 - New handler system for messages that doesn't require inheritance
 - Improved traceback handling
 
+[8.2.7]: https://github.com/Textualize/textual/compare/v8.2.6...v8.2.7
 [8.2.6]: https://github.com/Textualize/textual/compare/v8.2.5...v8.2.6
 [8.2.5]: https://github.com/Textualize/textual/compare/v8.2.4...v8.2.5
 [8.2.4]: https://github.com/Textualize/textual/compare/v8.2.3...v8.2.4

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "textual"
-version = "8.2.6"
+version = "8.2.7"
 homepage = "https://github.com/Textualize/textual"
 repository = "https://github.com/Textualize/textual"
 documentation = "https://textual.textualize.io/"

src/textual/_styles_cache.py

@@ -112,6 +112,7 @@ def render_widget(self, widget: Widget, crop: Region) -> list[Strip]:
 
         base_background, background = widget.background_colors
         styles = widget.styles
+        app = widget.app
         strips = self.render(
             styles,
             widget.region.size,
@@ -139,7 +140,8 @@ def render_widget(self, widget: Widget, crop: Region) -> list[Strip]:
             padding=styles.padding,
             crop=crop,
             opacity=widget.opacity,
-            ansi_theme=widget.app.ansi_theme,
+            ansi_theme=app.ansi_theme,
+            native_ansi=app.native_ansi_color,
         )
 
         if widget.auto_links:
@@ -173,6 +175,7 @@ def render(
         crop: Region | None = None,
         opacity: float = 1.0,
         ansi_theme: TerminalTheme = DEFAULT_TERMINAL_THEME,
+        native_ansi: bool = False,
     ) -> list[Strip]:
         """Render a widget content plus CSS styles.
 
@@ -191,6 +194,7 @@ def render(
             filters: Additional post-processing for the segments.
             opacity: Widget opacity.
             ansi_theme: Theme for ANSI colors.
+            native_ansi: Use native ANSI colors?
 
         Returns:
             Rendered lines.
@@ -227,6 +231,7 @@ def render(
                     border_subtitle,
                     opacity,
                     ansi_theme,
+                    native_ansi,
                 )
                 self._cache[y] = strip
             else:
@@ -273,6 +278,7 @@ def render_line(
         border_subtitle: tuple[Content, Color, Color, Style] | None,
         opacity: float,
         ansi_theme: TerminalTheme,
+        native_ansi: bool,
     ) -> Strip:
         """Render a styled line.
 
@@ -289,6 +295,8 @@ def render_line(
             border_title: Optional tuple of (title, color, background, style).
             border_subtitle: Optional tuple of (subtitle, color, background, style).
             opacity: Opacity of line.
+            ansi_theme: ANSI theme.
+            native_ansi: Use native ANSI colors?
 
         Returns:
             A line of segments.
@@ -450,7 +458,9 @@ def post(segments: Iterable[Segment]) -> Iterable[Segment]:
                 line = Strip.blank(content_width, inner.rich_style)
 
             if (text_opacity := styles.text_opacity) != 1.0:
-                line = TextOpacity.process_segments(line, text_opacity, ansi_theme)
+                line = TextOpacity.process_segments(
+                    line, text_opacity, ansi_theme, native_ansi
+                )
             if pad_left or pad_right:
                 line = line_post(line_pad(line, pad_left, pad_right, inner.rich_style))
             else:

src/textual/renderables/text_opacity.py

@@ -56,6 +56,7 @@ def process_segments(
         segments: Iterable[Segment],
         opacity: float,
         ansi_theme: TerminalTheme,
+        native_ansi: bool = False,
     ) -> Iterable[Segment]:
         """Apply opacity to segments.
 
@@ -64,6 +65,7 @@ def process_segments(
             opacity: Opacity to apply.
             ansi_theme: Terminal theme.
             background: Color of background.
+            native_ansi: Allow ANSI colors.
 
         Returns:
             Segments with applied opacity.
@@ -82,21 +84,67 @@ def process_segments(
         elif opacity == 1:
             yield from segments
         else:
-            filter = ANSIToTruecolor(ansi_theme)
-            for segment in filter.apply(list(segments), TRANSPARENT):
-                # use Tuple rather than tuple so Python 3.7 doesn't complain
-                text, style, control = cast(Tuple[str, Style, object], segment)
-                if not style:
-                    yield segment
-                    continue
-
-                color = style.color
-                bgcolor = style.bgcolor
-                if color and color.triplet and bgcolor and bgcolor.triplet:
-                    color_style = _get_blended_style_cached(bgcolor, color, opacity)
-                    yield _Segment(text, style + color_style)
-                else:
-                    yield segment
+            if native_ansi:
+                # Special case for native ANSI
+                # Without RGB we can't accurately calculate the foreground color
+                DIM = Style(dim=True)
+                filter = ANSIToTruecolor(ansi_theme)
+                segments_ = list(segments)
+                for original_segment, segment in zip(
+                    segments_, filter.apply(segments_, TRANSPARENT)
+                ):
+                    if original_segment.style is not None:
+                        text, style, control = original_segment
+                        if (
+                            style is not None
+                            and style.bgcolor is not None
+                            and style.bgcolor.is_default
+                        ):
+                            # If the opacity is less than or equal to 50%, then set the dim attribute
+                            if style.color is not None and opacity <= 0.5:
+                                yield Segment(text, style + DIM, control)
+                            else:
+                                yield original_segment
+                            continue
+                    # use Tuple rather than tuple so Python 3.7 doesn't complain
+                    text, style, control = segment
+                    if not style:
+                        yield segment
+                        continue
+
+                    color = style.color
+                    bgcolor = style.bgcolor
+                    if (
+                        color is not None
+                        and color.triplet
+                        and bgcolor
+                        and bgcolor.triplet
+                    ):
+                        color_style = _get_blended_style_cached(bgcolor, color, opacity)
+                        yield _Segment(text, style + color_style)
+                    else:
+                        yield segment
+            else:
+                filter = ANSIToTruecolor(ansi_theme)
+                for segment in filter.apply(list(segments), TRANSPARENT):
+                    # use Tuple rather than tuple so Python 3.7 doesn't complain
+                    text, style, control = segment
+                    if not style:
+                        yield segment
+                        continue
+
+                    color = style.color
+                    bgcolor = style.bgcolor
+                    if (
+                        color is not None
+                        and color.triplet
+                        and bgcolor
+                        and bgcolor.triplet
+                    ):
+                        color_style = _get_blended_style_cached(bgcolor, color, opacity)
+                        yield _Segment(text, style + color_style)
+                    else:
+                        yield segment
 
     def __rich_console__(
         self, console: Console, options: ConsoleOptions

tests/snapshot_tests/__snapshots__/test_snapshots/test_text_opacity_native_ansi.svg

@@ -4913,3 +4913,26 @@ async def on_mount(self) -> None:
             self.theme = "dracula"
 
     assert snap_compare(MDApp())
+
+
+def test_text_opacity_native_ansi(snap_compare) -> None:
+    """Test that text-opacity with ansi themes doesn't produce RGB colors.
+
+    Textual can't calculate text opacity with ANSI colors. As a compromize a text-opacity of 50% or less
+    sets the dim attribute on the style.
+
+    You should see 10 labels for wach level of opacity. For opacity 50% and under, the labels
+    should be dimmed.
+    """
+
+    class TApp(App):
+
+        def on_load(self) -> None:
+            self.theme = "ansi-dark"
+
+        def compose(self) -> ComposeResult:
+            for n in range(11):
+                yield (label := Label(f"Text Opacity {n*10}%"))
+                label.styles.text_opacity = f"{n * 10}%"
+
+    assert snap_compare(TApp())