Skip to content

Visually display customizable search keyboard shortcut to user #2391

Description

@vhscom

Feature request

Problem or desire

#2278 added keyboard shortcuts for search and, I believe, collapsing the sidebar. In order to make it easier for users to discover keyboard shortcuts associated with search I'd like the ability to display a kbd key combo so users can quickly find it like:

Screenshot 2024-03-27 at 11 25 41 AM

Proposal

Add and style a presentational keyboard shortcut key for sighted users. If there's more than one keyboard shortcut for search, allow the user to pick one keyboard option to display to the user.

Implementation

Something like:

<kbd class="keyboard-shortcut"><span class="keyboard-shortcut-keys">⌘</span>K</kbd>

Activity

  1. jhildenbiddle commented on Jun 16, 2024

    @jhildenbiddle
    Member

    Hi @vhscom.

    A keyboard shortcut icon was added in #2278 (issue) / #2279 (PR). It currently shows a forward slash. You can review this on our develop branch preview. This feature will not be available publicly until Docsify v5 is released.

    <kbd title="Press / to search">/</kbd>

    FYI, both Command+K and Control+K work as well as search shortcuts. I opted to display / because it is a single keystroke and universal across operating systems. Conditionally displaying ⌘ K for macOS or ⌃ K for other operating systems require OS detection which I was hoping to avoid. That said, I'm not opposed to making the switch since Command/Control+K is more common.

  2. linked a pull request that will close this issuefeat: v5 style overhaul #2469on Jul 19, 2024
  3. jhildenbiddle commented on Jul 19, 2024

    @jhildenbiddle
    Member

    This issue has been addressed by PR #2469. The changes will be available when Docsify v5 is released.

    CleanShot 2024-07-19 at 11 42 05@2x

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions