Preview and view tooltip

Author: Maxteabag

sqlit/app.py

@@ -285,6 +285,7 @@ class SSMSTUI(
         Binding("j", "tree_cursor_down", "Down", show=False),
         Binding("k", "tree_cursor_up", "Up", show=False),
         Binding("v", "view_cell", "View cell", show=False),
+        Binding("V", "view_cell_full", "View cell full", show=False),
         Binding("u", "edit_cell", "Update cell", show=False),
         Binding("h", "results_cursor_left", "Left", show=False),
         Binding("j", "results_cursor_down", "Down", show=False),

sqlit/keymap.py

@@ -126,6 +126,7 @@ def get_action_keys(self) -> list[ActionKeyDef]:
             ActionKeyDef("y", "copy_context", "query_normal"),
             # Results
             ActionKeyDef("v", "view_cell", "results"),
+            ActionKeyDef("V", "view_cell_full", "results"),
             ActionKeyDef("y", "copy_context", "results"),
             ActionKeyDef("Y", "copy_row", "results"),
             ActionKeyDef("a", "copy_results", "results"),

sqlit/state_machine.py

@@ -899,7 +899,8 @@ class ResultsFocusedState(State):
     help_category = "Results"
 
     def _setup_actions(self) -> None:
-        self.allows("view_cell", key="v", label="View cell", help="View selected cell")
+        self.allows("view_cell", key="v", label="View cell", help="Preview cell (tooltip)")
+        self.allows("view_cell_full", key="V", label="View full", help="View full cell value")
         self.allows("edit_cell", key="u", label="Update cell", help="Update cell (generate UPDATE)")
         self.allows("copy_context", key="y", label="Copy cell", help="Copy selected cell")
         self.allows("copy_row", key="Y", label="Copy row", help="Copy selected row")
@@ -921,15 +922,16 @@ def get_display_bindings(self, app: SSMSTUI) -> tuple[list[DisplayBinding], list
             left.append(DisplayBinding(key="v", label="View error", action="view_cell"))
             left.append(DisplayBinding(key="y", label="Copy error", action="copy_context"))
         else:
-            left.append(DisplayBinding(key="v", label="View cell", action="view_cell"))
+            left.append(DisplayBinding(key="v", label="Preview", action="view_cell"))
+            left.append(DisplayBinding(key="V", label="View", action="view_cell_full"))
             left.append(DisplayBinding(key="u", label="Update", action="edit_cell"))
             left.append(DisplayBinding(key="y", label="Copy cell", action="copy_context"))
             left.append(DisplayBinding(key="Y", label="Copy row", action="copy_row"))
             left.append(DisplayBinding(key="a", label="Copy all", action="copy_results"))
         left.append(DisplayBinding(key="x", label="Clear", action="clear_results"))
         left.append(DisplayBinding(key="/", label="Filter", action="results_filter"))
 
-        seen.update(["view_cell", "copy_context", "copy_row", "copy_results", "clear_results", "results_filter"])
+        seen.update(["view_cell", "view_cell_full", "copy_context", "copy_row", "copy_results", "clear_results", "results_filter"])
 
         right: list[DisplayBinding] = []
         if self.parent:

sqlit/ui/mixins/results.py

@@ -74,6 +74,64 @@ def fmt(value: object) -> str:
         return "\n".join(lines)
 
     def action_view_cell(self: AppProtocol) -> None:
+        """Show/hide tooltip preview of the selected cell at the cell position."""
+        from textual.geometry import Offset
+        from textual.widgets._tooltip import Tooltip
+
+        table = self.results_table
+        if table.row_count <= 0:
+            self.notify("No results", severity="warning")
+            return
+        try:
+            # Get the tooltip widget from the screen
+            screen = self.screen
+            try:
+                tooltip_widget = screen.get_child_by_type(Tooltip)
+            except Exception:
+                return
+
+            current_coord = table.cursor_coordinate
+
+            # Check if tooltip is already showing for this cell - toggle it off
+            tooltip_coord = getattr(self, "_tooltip_cell_coord", None)
+            tooltip_showing = getattr(self, "_tooltip_showing", False)
+            if tooltip_showing and tooltip_coord == current_coord:
+                tooltip_widget.display = False
+                self._tooltip_cell_coord = None
+                self._tooltip_showing = False
+                return
+
+            # Get cell value directly (always show, regardless of truncation)
+            value = table.get_cell_at(current_coord)
+            if value is None:
+                value = "NULL"
+            tooltip_content = str(value)
+
+            # Position at bottom-right of table content area
+            scrollbar_h = table.scrollbar_size_horizontal
+            scrollbar_v = table.scrollbar_size_vertical
+            screen_x = table.region.x + table.region.width - scrollbar_v
+            screen_y = table.region.y + table.region.height - scrollbar_h - 1
+
+            # Update and position the tooltip
+            tooltip_widget.display = True
+            tooltip_widget.absolute_offset = Offset(screen_x, screen_y)
+            tooltip_widget.update(tooltip_content)
+
+            # Apply CSS offsets to make tooltip expand left and up from anchor
+            tooltip_widget.styles.offset = ("-100%", "-100%")
+
+            # Track which cell the tooltip is showing for
+            self._tooltip_cell_coord = current_coord
+            self._tooltip_showing = True
+
+            # Clear _tooltip_widget so mouse movement won't clear this tooltip
+            # (the _maybe_clear_tooltip check compares current widget to _tooltip_widget)
+            screen._tooltip_widget = None
+        except Exception:
+            pass
+
+    def action_view_cell_full(self: AppProtocol) -> None:
         """View the full value of the selected cell inline."""
         from ...widgets import InlineValueView
 

sqlit/widgets.py

@@ -36,7 +36,18 @@ def _on_key(self, event: Key) -> None:
 
 
 class SqlitDataTable(FastDataTable):
-    """FastDataTable with correct header behavior when show_header is False."""
+    """FastDataTable with correct header behavior when show_header is False.
+
+    Disables hover tooltips - use 'v' key to preview cell values instead.
+    """
+
+    # Track if a manual tooltip is being shown (via 'v' key)
+    _manual_tooltip_active: bool = False
+
+    def _set_tooltip_from_cell_at(self, coordinate: Any) -> None:
+        """Override to disable hover tooltips entirely."""
+        # Don't set tooltip on hover - we handle this manually via 'v' key
+        pass
 
     def action_copy_selection(self) -> None:
         """Copy selection to clipboard, guarding against empty tables."""