Skip to content

Improve reference floating window visibility and keyboard navigation #1554

@BitCalSaul

Description

@BitCalSaul

Feature description

Feature Request: Improve reference floating window visibility and keyboard navigation

First of all, thank you for the excellent gh reference feature — it is very useful to quickly inspect function references.

I have two small usability suggestions that might further improve the experience:

1. Configurable / clearer floating window colors

Currently, the reference floating window background color is very close to the editor background, which makes it difficult to distinguish the popup from the main buffer, especially in darker themes.
Would it be possible to expose options (or presets) to customize the floating window colors (background, border, or highlight group) so users can make it more visually distinct?

2. Keyboard navigation into the floating window

At the moment, the floating window shows how many references exist, but to inspect the actual code, I must use the mouse to click into the popup.
It would be much more convenient if we could move focus into the floating window using keyboard navigation (e.g. <C-h/j/k/l> or a dedicated keybinding), so we can scroll and inspect references without leaving the keyboard.

Overall, the feature is already great — these changes would mainly improve accessibility and keyboard-driven workflows.

Thank you for your time and for maintaining this project!

Additional information

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions