tooltip params

Author: willmcgugan

src/textual/widgets/_button.py

@@ -184,6 +184,7 @@ def __init__(
         id: str | None = None,
         classes: str | None = None,
         disabled: bool = False,
+        tooltip: RenderableType | None = None,
     ):
         """Create a Button widget.
 
@@ -194,6 +195,7 @@ def __init__(
             id: The ID of the button in the DOM.
             classes: The CSS classes of the button.
             disabled: Whether the button is disabled or not.
+            tooltip: Optional tooltip.
         """
         super().__init__(name=name, id=id, classes=classes, disabled=disabled)
 
@@ -204,6 +206,8 @@ def __init__(
         self.variant = variant
         self.active_effect_duration = 0.3
         """Amount of time in seconds the button 'press' animation lasts."""
+        if tooltip is not None:
+            self.tooltip = tooltip
 
     def get_content_width(self, container: Size, viewport: Size) -> int:
         try:

src/textual/widgets/_input.py

@@ -257,6 +257,7 @@ def __init__(
         id: str | None = None,
         classes: str | None = None,
         disabled: bool = False,
+        tooltip: RenderableType | None = None,
     ) -> None:
         """Initialise the `Input` widget.
 
@@ -279,6 +280,7 @@ def __init__(
             id: Optional ID for the widget.
             classes: Optional initial classes for the widget.
             disabled: Whether the input is disabled or not.
+            tooltip: Optional tooltip.
         """
         super().__init__(name=name, id=id, classes=classes, disabled=disabled)
 
@@ -335,6 +337,8 @@ def __init__(
 
         if value is not None:
             self.value = value
+        if tooltip is not None:
+            self.tooltip = tooltip
 
     def _position_to_cell(self, position: int) -> int:
         """Convert an index within the value to cell position."""

src/textual/widgets/_option_list.py

@@ -285,6 +285,7 @@ def __init__(
         classes: str | None = None,
         disabled: bool = False,
         wrap: bool = True,
+        tooltip: RenderableType | None = None,
     ):
         """Initialise the option list.
 
@@ -295,6 +296,7 @@ def __init__(
             classes: The CSS classes of the option list.
             disabled: Whether the option list is disabled or not.
             wrap: Should prompts be auto-wrapped?
+            tooltip: Optional tooltip.
         """
         super().__init__(name=name, id=id, classes=classes, disabled=disabled)
 
@@ -361,6 +363,9 @@ def __init__(
         # the state of the option list in regard to its available options.
         self.action_first()
 
+        if tooltip is not None:
+            self.tooltip = tooltip
+
     def get_content_width(self, container: Size, viewport: Size) -> int:
         """Get maximum width of options."""
         console = self.app.console

src/textual/widgets/_radio_set.py

@@ -5,6 +5,7 @@
 from typing import ClassVar, Optional
 
 import rich.repr
+from rich.console import RenderableType
 
 from .. import _widget_navigation
 from ..binding import Binding, BindingType
@@ -121,6 +122,7 @@ def __init__(
         id: str | None = None,
         classes: str | None = None,
         disabled: bool = False,
+        tooltip: RenderableType | None = None,
     ) -> None:
         """Initialise the radio set.
 
@@ -130,6 +132,7 @@ def __init__(
             id: The ID of the radio set in the DOM.
             classes: The CSS classes of the radio set.
             disabled: Whether the radio set is disabled or not.
+            tooltip: Optional tooltip.
 
         Note:
             When a `str` label is provided, a
@@ -148,6 +151,8 @@ def __init__(
             classes=classes,
             disabled=disabled,
         )
+        if tooltip is not None:
+            self.tooltip = tooltip
 
     def _on_mount(self, _: Mount) -> None:
         """Perform some processing once mounted in the DOM."""

src/textual/widgets/_select.py

@@ -298,6 +298,7 @@ def __init__(
         id: str | None = None,
         classes: str | None = None,
         disabled: bool = False,
+        tooltip: RenderableType | None = None,
     ):
         """Initialize the Select control.
 
@@ -315,6 +316,7 @@ def __init__(
             id: The ID of the control in the DOM.
             classes: The CSS classes of the control.
             disabled: Whether the control is disabled or not.
+            tooltip: Optional tooltip.
 
         Raises:
             EmptySelectError: If no options are provided and `allow_blank` is `False`.
@@ -324,6 +326,8 @@ def __init__(
         self.prompt = prompt
         self._value = value
         self._setup_variables_for_options(options)
+        if tooltip is not None:
+            self.tooltip = tooltip
 
     @classmethod
     def from_values(

src/textual/widgets/_toggle_button.py

@@ -7,6 +7,7 @@
 
 from typing import TYPE_CHECKING, ClassVar
 
+from rich.console import RenderableType
 from rich.style import Style
 from rich.text import Text, TextType
 
@@ -130,6 +131,7 @@ def __init__(
         id: str | None = None,
         classes: str | None = None,
         disabled: bool = False,
+        tooltip: RenderableType | None = None,
     ) -> None:
         """Initialise the toggle.
 
@@ -141,13 +143,16 @@ def __init__(
             id: The ID of the toggle in the DOM.
             classes: The CSS classes of the toggle.
             disabled: Whether the button is disabled or not.
+            tooltip: RenderableType | None = None,
         """
         super().__init__(name=name, id=id, classes=classes, disabled=disabled)
         self._button_first = button_first
         # NOTE: Don't send a Changed message in response to the initial set.
         with self.prevent(self.Changed):
             self.value = value
         self._label = self._make_label(label)
+        if tooltip is not None:
+            self.tooltip = tooltip
 
     def _make_label(self, label: TextType) -> Text:
         """Make a `Text` label from a `TextType` value.