# Keyboard shortcut tooltip

> Shows the action plus its shortcut, and the key dips slightly as if someone had just pressed it.

- Category: [Tooltips](https://library.aimran.es/components/tooltips)
- Built with: HTML + CSS
- Live editor: https://library.aimran.es/blocks/uv-tip-key
- Library: AIMRAN Library (https://library.aimran.es), free, no sign-up, by Aimran Oukham

## Where to use it

Handy wherever people live on the keyboard: the search button of a documentation site, the “Send” button of an email client, the export action in a design app. Hover and the label fades in with a ⌘ K key that gives a little press. A keyboard shortcut tooltip teaches shortcuts without anyone opening a help page.

Show the right key for each system: ⌘ on Mac, Ctrl on Windows, which a couple of lines of JavaScript can swap. And only add it to actions that really have a shortcut. If people try it and nothing happens, they stop trusting the hints.

## Code

### HTML

```html
<button class="uv-tk">Search<span>Search this page<kbd>⌘ K</kbd></span></button>
```

### CSS

```css
.uv-tk {
  --c1: #0071e3;
  --c2: #8ec5ff;
  --s: 16px;
  /* tamaño */
  --k: 1;
  /* velocidad */
  --fg: #1d1d1f;
  /* texto */
  --bg: #f5f5f7;
  /* fondo */
}

.uv-tk {
  font-family: -apple-system,BlinkMacSystemFont,"SF Pro Text","Inter",system-ui,sans-serif;
  font-size: var(--s);
  font-weight: 600;
  border: 0;
  cursor: pointer;
  color: var(--fg);
  background: color-mix(in srgb,var(--fg) 7%,transparent);
  position: relative;
  padding: .8em 1.25em;
  border-radius: .8em;
}

.uv-tk span {
  position: absolute;
  z-index: 5;
  padding: .65em .85em;
  border-radius: .75em;
  font-size: .76em;
  font-weight: 550;
  line-height: 1.25;
  white-space: nowrap;
  pointer-events: none;
  color: var(--bg);
  background: var(--fg);
  box-shadow: 0 12px 35px rgba(0,0,0,.2);
  opacity: 0;
  left: 50%;
  bottom: calc(100% + .75em);
  display: flex;
  align-items: center;
  gap: .8em;
  transform: translate(-50%,.6em);
  filter: blur(5px);
  transition: all calc(0.35s / var(--k)) cubic-bezier(.25,.1,.25,1);
}

.uv-tk kbd {
  padding: .3em .5em;
  border-radius: .4em;
  color: var(--bg);
  background: color-mix(in srgb,var(--bg) 18%,transparent);
  box-shadow: inset 0 -2px color-mix(in srgb,var(--bg) 30%,transparent);
}

.uv-tk:hover span,.uv-tk:focus-visible span {
  opacity: 1;
  filter: blur(0);
  transform: translate(-50%,0);
}

.uv-tk:hover kbd {
  animation: uv-tk-hit calc(0.45s / var(--k)) cubic-bezier(.34,1.56,.64,1);
}

@keyframes uv-tk-hit {
  50% {
    transform: translateY(2px);
    box-shadow: none;
  }
}
```

### React

```tsx
import type { CSSProperties } from "react";

const css = `
.uv-tk {
  font-family: -apple-system,BlinkMacSystemFont,"SF Pro Text","Inter",system-ui,sans-serif;
  font-size: var(--s);
  font-weight: 600;
  border: 0;
  cursor: pointer;
  color: var(--fg);
  background: color-mix(in srgb,var(--fg) 7%,transparent);
  position: relative;
  padding: .8em 1.25em;
  border-radius: .8em;
}

.uv-tk span {
  position: absolute;
  z-index: 5;
  padding: .65em .85em;
  border-radius: .75em;
  font-size: .76em;
  font-weight: 550;
  line-height: 1.25;
  white-space: nowrap;
  pointer-events: none;
  color: var(--bg);
  background: var(--fg);
  box-shadow: 0 12px 35px rgba(0,0,0,.2);
  opacity: 0;
  left: 50%;
  bottom: calc(100% + .75em);
  display: flex;
  align-items: center;
  gap: .8em;
  transform: translate(-50%,.6em);
  filter: blur(5px);
  transition: all calc(0.35s / var(--k)) cubic-bezier(.25,.1,.25,1);
}

.uv-tk kbd {
  padding: .3em .5em;
  border-radius: .4em;
  color: var(--bg);
  background: color-mix(in srgb,var(--bg) 18%,transparent);
  box-shadow: inset 0 -2px color-mix(in srgb,var(--bg) 30%,transparent);
}

.uv-tk:hover span,.uv-tk:focus-visible span {
  opacity: 1;
  filter: blur(0);
  transform: translate(-50%,0);
}

.uv-tk:hover kbd {
  animation: uv-tk-hit calc(0.45s / var(--k)) cubic-bezier(.34,1.56,.64,1);
}

@keyframes uv-tk-hit {
  50% {
    transform: translateY(2px);
    box-shadow: none;
  }
}
`;

export default function TipKey() {
  return (
    <>
      <style>{css}</style>
      <div
        style={{
          "--c1": "#0071e3",
          "--c2": "#8ec5ff",
          "--s": "16px",
          "--k": "1",
          "--fg": "#1d1d1f",
          "--bg": "#f5f5f7",
        } as CSSProperties}
      >
        <button className="uv-tk">Search<span>Search this page<kbd>⌘ K</kbd></span></button>
      </div>
    </>
  );
}
```

## Prompt for AI assistants

Paste this into ChatGPT, Claude, Cursor, v0 or Lovable to adapt the block to your stack (Tailwind, Vue, Svelte…):

````text
I want to add the “Keyboard shortcut tooltip” block (Tooltips) from AIMRAN Library to my project.

## What it is
Shows the action plus its shortcut, and the key dips slightly as if someone had just pressed it.

## Chosen settings
- Main color: #0071e3
- Secondary color: #8ec5ff
- Size: 16px (from 12 to 24px)
- Speed: 1x (from 0.5 to 2x)
- Text: "Search this page"

## What I need
1. Add it to my project with the same look and animation as the reference code: same sizes, colours, radii, shadows, timings and easing.
2. It is built with plain HTML and CSS (the reference wraps it in a React component with its CSS). If my project uses something else (Vue, Svelte, Astro, plain HTML…), translate it without losing any behaviour. If I use Tailwind, turn the styles into classes; if not, keep the CSS in its own file.
3. Expose the settings above as props (or CSS variables) with those values as defaults.
4. Make it work well on phones: nothing that depends only on hover, touch targets of at least 44 px and no overflow on 320 px screens.
5. Make it look right in light and dark mode.
6. Keep it accessible: semantic HTML, roles and aria-* where needed, visible focus and keyboard support.
7. Respect prefers-reduced-motion: with reduced motion, no big animations but the same end result.

## Reference code
```tsx
import type { CSSProperties } from "react";

const css = `
.uv-tk {
  font-family: -apple-system,BlinkMacSystemFont,"SF Pro Text","Inter",system-ui,sans-serif;
  font-size: var(--s);
  font-weight: 600;
  border: 0;
  cursor: pointer;
  color: var(--fg);
  background: color-mix(in srgb,var(--fg) 7%,transparent);
  position: relative;
  padding: .8em 1.25em;
  border-radius: .8em;
}

.uv-tk span {
  position: absolute;
  z-index: 5;
  padding: .65em .85em;
  border-radius: .75em;
  font-size: .76em;
  font-weight: 550;
  line-height: 1.25;
  white-space: nowrap;
  pointer-events: none;
  color: var(--bg);
  background: var(--fg);
  box-shadow: 0 12px 35px rgba(0,0,0,.2);
  opacity: 0;
  left: 50%;
  bottom: calc(100% + .75em);
  display: flex;
  align-items: center;
  gap: .8em;
  transform: translate(-50%,.6em);
  filter: blur(5px);
  transition: all calc(0.35s / var(--k)) cubic-bezier(.25,.1,.25,1);
}

.uv-tk kbd {
  padding: .3em .5em;
  border-radius: .4em;
  color: var(--bg);
  background: color-mix(in srgb,var(--bg) 18%,transparent);
  box-shadow: inset 0 -2px color-mix(in srgb,var(--bg) 30%,transparent);
}

.uv-tk:hover span,.uv-tk:focus-visible span {
  opacity: 1;
  filter: blur(0);
  transform: translate(-50%,0);
}

.uv-tk:hover kbd {
  animation: uv-tk-hit calc(0.45s / var(--k)) cubic-bezier(.34,1.56,.64,1);
}

@keyframes uv-tk-hit {
  50% {
    transform: translateY(2px);
    box-shadow: none;
  }
}
`;

export default function TipKey() {
  return (
    <>
      <style>{css}</style>
      <div
        style={{
          "--c1": "#0071e3",
          "--c2": "#8ec5ff",
          "--s": "16px",
          "--k": "1",
          "--fg": "#1d1d1f",
          "--bg": "#f5f5f7",
        } as CSSProperties}
      >
        <button className="uv-tk">Search<span>Search this page<kbd>⌘ K</kbd></span></button>
      </div>
    </>
  );
}
```

Give me the complete final code, ready to paste, and tell me in one line where to put it in my project.
````