Method get_selected_text

src/textual/screen.py:963–983

Get text under selection. Returns: Selected text, or `None` if no text was selected.

(self)

            )

    def get_selected_text(self) -> str | None:
        """Get text under selection.

        Returns:
            Selected text, or `None` if no text was selected.
        """
        if not self.selections:
            return None

        widget_text: list[str] = []
        for widget, selection in self.selections.items():
            # Filter out widgets that may have been removed since the text was selected
            if (
                widget.is_attached
                and (selected_text_in_widget := widget.get_selection(selection))
                is not None
            ):
                widget_text.extend(selected_text_in_widget)

        selected_text = "".join(widget_text).rstrip("\n")
        return selected_text

    def action_copy_text(self) -> None:
        """Copy selected text to clipboard."""