# Sliding number stepper

> Plus and minus buttons around a number that slides in from above or below as it changes.

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

## Where to use it

A quantity stepper is at home next to anything you buy more than one of: the cart of an online shop, tickets for a concert or the number of guests in a table booking. The number rolls up or down as it changes, and the minus switches off at one. A quantity input in HTML, CSS and a little JavaScript.

The demo stops at 99; set the maximum to your real stock so nobody orders what you cannot send. The buttons are round and fairly big, so leave them that size on phones where fingers need room.

## Code

### HTML

```html
<div class="uv-in2q"><button class="mn">−</button><span class="nm"><b>1</b></span><button class="pl">+</button></div>
```

### CSS

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

.uv-in2q {
  font-family: -apple-system,BlinkMacSystemFont,"SF Pro Text","Inter",system-ui,sans-serif;
  font-size: var(--s);
  color: var(--fg);
  -webkit-tap-highlight-color: transparent;
  display: inline-flex;
  align-items: center;
  gap: .2em;
  padding: .35em;
  border-radius: 999px;
  background: color-mix(in srgb,var(--fg) 6%,transparent);
}

.uv-in2q button {
  font-family: -apple-system,BlinkMacSystemFont,"SF Pro Text","Inter",system-ui,sans-serif;
  display: grid;
  place-items: center;
  width: 2.3em;
  height: 2.3em;
  font-size: calc(var(--s) * 1.1);
  font-weight: 500;
  color: var(--fg);
  background: var(--bg);
  border: 0;
  border-radius: 50%;
  cursor: pointer;
  box-shadow: 0 2px 6px rgba(0,0,0,.09);
  transition: all calc(0.3s / var(--k)) cubic-bezier(.34,1.56,.64,1);
}

.uv-in2q button:hover {
  color: var(--c1);
  scale: 1.08;
}

.uv-in2q button:active {
  scale: .9;
}

.uv-in2q button:disabled {
  opacity: .35;
  cursor: not-allowed;
  scale: 1;
}

.uv-in2q .nm {
  position: relative;
  display: grid;
  place-items: center;
  width: 2.6em;
  height: 2.3em;
  overflow: hidden;
  font-variant-numeric: tabular-nums;
  font-weight: 650;
}

.uv-in2q .nm b {
  position: absolute;
}

.uv-in2q .nm b.up {
  animation: uv-in2q-u calc(0.35s / var(--k)) cubic-bezier(.25,.1,.25,1);
}

.uv-in2q .nm b.dn {
  animation: uv-in2q-d calc(0.35s / var(--k)) cubic-bezier(.25,.1,.25,1);
}

@keyframes uv-in2q-u {
  from {
    transform: translateY(1.4em);
    opacity: 0;
  }
  to {
    transform: none;
    opacity: 1;
  }
}

@keyframes uv-in2q-d {
  from {
    transform: translateY(-1.4em);
    opacity: 0;
  }
  to {
    transform: none;
    opacity: 1;
  }
}
```

### JavaScript

```js
document.querySelectorAll(".uv-in2q").forEach(el => {
  let n=1;const b=el.querySelector(".nm b"),mn=el.querySelector(".mn");const set=(v,up)=>{if(v<1||v>99)return;n=v;b.textContent=n;b.className=up?"up":"dn";mn.disabled=n<=1};el.querySelector(".pl").addEventListener("click",()=>set(n+1,true));mn.addEventListener("click",()=>set(n-1,false));set(1,true)
});
```

### React

```tsx
// @ts-nocheck: setup() es JavaScript del DOM sin tipos, el mismo de la pestaña JS.
import { useEffect, useRef, type CSSProperties } from "react";

const css = `
.uv-in2q {
  font-family: -apple-system,BlinkMacSystemFont,"SF Pro Text","Inter",system-ui,sans-serif;
  font-size: var(--s);
  color: var(--fg);
  -webkit-tap-highlight-color: transparent;
  display: inline-flex;
  align-items: center;
  gap: .2em;
  padding: .35em;
  border-radius: 999px;
  background: color-mix(in srgb,var(--fg) 6%,transparent);
}

.uv-in2q button {
  font-family: -apple-system,BlinkMacSystemFont,"SF Pro Text","Inter",system-ui,sans-serif;
  display: grid;
  place-items: center;
  width: 2.3em;
  height: 2.3em;
  font-size: calc(var(--s) * 1.1);
  font-weight: 500;
  color: var(--fg);
  background: var(--bg);
  border: 0;
  border-radius: 50%;
  cursor: pointer;
  box-shadow: 0 2px 6px rgba(0,0,0,.09);
  transition: all calc(0.3s / var(--k)) cubic-bezier(.34,1.56,.64,1);
}

.uv-in2q button:hover {
  color: var(--c1);
  scale: 1.08;
}

.uv-in2q button:active {
  scale: .9;
}

.uv-in2q button:disabled {
  opacity: .35;
  cursor: not-allowed;
  scale: 1;
}

.uv-in2q .nm {
  position: relative;
  display: grid;
  place-items: center;
  width: 2.6em;
  height: 2.3em;
  overflow: hidden;
  font-variant-numeric: tabular-nums;
  font-weight: 650;
}

.uv-in2q .nm b {
  position: absolute;
}

.uv-in2q .nm b.up {
  animation: uv-in2q-u calc(0.35s / var(--k)) cubic-bezier(.25,.1,.25,1);
}

.uv-in2q .nm b.dn {
  animation: uv-in2q-d calc(0.35s / var(--k)) cubic-bezier(.25,.1,.25,1);
}

@keyframes uv-in2q-u {
  from {
    transform: translateY(1.4em);
    opacity: 0;
  }
  to {
    transform: none;
    opacity: 1;
  }
}

@keyframes uv-in2q-d {
  from {
    transform: translateY(-1.4em);
    opacity: 0;
  }
  to {
    transform: none;
    opacity: 1;
  }
}
`;

// Interacción en JavaScript del DOM: la misma que en la pestaña JS.
// eslint-disable-next-line @typescript-eslint/no-explicit-any
function setup(el: any) {
  let n=1;const b=el.querySelector(".nm b"),mn=el.querySelector(".mn");const set=(v,up)=>{if(v<1||v>99)return;n=v;b.textContent=n;b.className=up?"up":"dn";mn.disabled=n<=1};el.querySelector(".pl").addEventListener("click",()=>set(n+1,true));mn.addEventListener("click",()=>set(n-1,false));set(1,true)
}

export default function In2Qty() {
  const ref = useRef<HTMLDivElement>(null);

  useEffect(() => {
    const el = ref.current?.firstElementChild;
    return el ? setup(el) : undefined;
  }, []);

  return (
    <>
      <style>{css}</style>
      <div
        ref={ref} style={{
          "--c1": "#0071e3",
          "--c2": "#8ec5ff",
          "--s": "16px",
          "--k": "1",
          "--fg": "#1d1d1f",
          "--bg": "#f5f5f7",
        } as CSSProperties}
      >
        <div className="uv-in2q"><button className="mn">−</button><span className="nm"><b>1</b></span><button className="pl">+</button></div>
      </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 “Sliding number stepper” block (Inputs) from AIMRAN Library to my project.

## What it is
Plus and minus buttons around a number that slides in from above or below as it changes.

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

## 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
// @ts-nocheck: setup() es JavaScript del DOM sin tipos, el mismo de la pestaña JS.
import { useEffect, useRef, type CSSProperties } from "react";

const css = `
.uv-in2q {
  font-family: -apple-system,BlinkMacSystemFont,"SF Pro Text","Inter",system-ui,sans-serif;
  font-size: var(--s);
  color: var(--fg);
  -webkit-tap-highlight-color: transparent;
  display: inline-flex;
  align-items: center;
  gap: .2em;
  padding: .35em;
  border-radius: 999px;
  background: color-mix(in srgb,var(--fg) 6%,transparent);
}

.uv-in2q button {
  font-family: -apple-system,BlinkMacSystemFont,"SF Pro Text","Inter",system-ui,sans-serif;
  display: grid;
  place-items: center;
  width: 2.3em;
  height: 2.3em;
  font-size: calc(var(--s) * 1.1);
  font-weight: 500;
  color: var(--fg);
  background: var(--bg);
  border: 0;
  border-radius: 50%;
  cursor: pointer;
  box-shadow: 0 2px 6px rgba(0,0,0,.09);
  transition: all calc(0.3s / var(--k)) cubic-bezier(.34,1.56,.64,1);
}

.uv-in2q button:hover {
  color: var(--c1);
  scale: 1.08;
}

.uv-in2q button:active {
  scale: .9;
}

.uv-in2q button:disabled {
  opacity: .35;
  cursor: not-allowed;
  scale: 1;
}

.uv-in2q .nm {
  position: relative;
  display: grid;
  place-items: center;
  width: 2.6em;
  height: 2.3em;
  overflow: hidden;
  font-variant-numeric: tabular-nums;
  font-weight: 650;
}

.uv-in2q .nm b {
  position: absolute;
}

.uv-in2q .nm b.up {
  animation: uv-in2q-u calc(0.35s / var(--k)) cubic-bezier(.25,.1,.25,1);
}

.uv-in2q .nm b.dn {
  animation: uv-in2q-d calc(0.35s / var(--k)) cubic-bezier(.25,.1,.25,1);
}

@keyframes uv-in2q-u {
  from {
    transform: translateY(1.4em);
    opacity: 0;
  }
  to {
    transform: none;
    opacity: 1;
  }
}

@keyframes uv-in2q-d {
  from {
    transform: translateY(-1.4em);
    opacity: 0;
  }
  to {
    transform: none;
    opacity: 1;
  }
}
`;

// Interacción en JavaScript del DOM: la misma que en la pestaña JS.
// eslint-disable-next-line @typescript-eslint/no-explicit-any
function setup(el: any) {
  let n=1;const b=el.querySelector(".nm b"),mn=el.querySelector(".mn");const set=(v,up)=>{if(v<1||v>99)return;n=v;b.textContent=n;b.className=up?"up":"dn";mn.disabled=n<=1};el.querySelector(".pl").addEventListener("click",()=>set(n+1,true));mn.addEventListener("click",()=>set(n-1,false));set(1,true)
}

export default function In2Qty() {
  const ref = useRef<HTMLDivElement>(null);

  useEffect(() => {
    const el = ref.current?.firstElementChild;
    return el ? setup(el) : undefined;
  }, []);

  return (
    <>
      <style>{css}</style>
      <div
        ref={ref} style={{
          "--c1": "#0071e3",
          "--c2": "#8ec5ff",
          "--s": "16px",
          "--k": "1",
          "--fg": "#1d1d1f",
          "--bg": "#f5f5f7",
        } as CSSProperties}
      >
        <div className="uv-in2q"><button className="mn">−</button><span className="nm"><b>1</b></span><button className="pl">+</button></div>
      </div>
    </>
  );
}
```

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