# Ripple checkbox

> When you tick it, a ring of colour spreads out around the box and fades, like a drop in water.

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

## Where to use it

A ripple is a good fit for settings screens where every row is a checkbox: notification preferences in an account page, “Email me about new orders” in a shop admin or the alerts of a banking app. The spreading ring shows which row you just changed. A ripple checkbox in HTML and CSS.

The ripple fades on its own and does not repeat, so it does not bother anyone on long lists. If your rows are packed tightly, give them a little extra spacing so the ring has room to breathe.

## Code

### HTML

```html
<label class="uv-ck2r"><input type="checkbox"><span class="bx"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"><path d="M5 12.5l4.5 4.5L19 7.5" pathLength="1"/></svg><em></em></span>Notifications</label>
```

### CSS

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

.uv-ck2r {
  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: .7em;
  cursor: pointer;
  user-select: none;
  font-weight: 500;
}

.uv-ck2r input {
  position: absolute;
  opacity: 0;
  width: 0;
  height: 0;
  pointer-events: none;
}

.uv-ck2r .bx {
  position: relative;
  display: grid;
  place-items: center;
  width: 1.5em;
  height: 1.5em;
  border-radius: .45em;
  box-shadow: inset 0 0 0 2px color-mix(in srgb,var(--fg) 22%,transparent);
  transition: all calc(0.28s / var(--k)) cubic-bezier(.25,.1,.25,1);
}

.uv-ck2r svg {
  width: 1em;
  height: 1em;
  color: #fff;
}

.uv-ck2r svg path {
  stroke-dasharray: 1;
  stroke-dashoffset: 1;
  transition: stroke-dashoffset calc(0.3s / var(--k)) cubic-bezier(.25,.1,.25,1);
}

.uv-ck2r em {
  position: absolute;
  inset: -.3em;
  border-radius: .7em;
  box-shadow: 0 0 0 0 var(--c1);
  opacity: 0;
}

.uv-ck2r:hover .bx {
  box-shadow: inset 0 0 0 2px var(--c1);
}

.uv-ck2r input:checked + .bx {
  background: var(--c1);
  box-shadow: inset 0 0 0 2px var(--c1);
}

.uv-ck2r input:checked + .bx svg path {
  stroke-dashoffset: 0;
}

.uv-ck2r input:checked + .bx em {
  animation: uv-ck2r calc(0.65s / var(--k)) cubic-bezier(.25,.1,.25,1);
}

@keyframes uv-ck2r {
  0% {
    opacity: .5;
    box-shadow: 0 0 0 0 var(--c1);
  }
  100% {
    opacity: 0;
    box-shadow: 0 0 0 .9em var(--c1);
  }
}
```

### React

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

const css = `
.uv-ck2r {
  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: .7em;
  cursor: pointer;
  user-select: none;
  font-weight: 500;
}

.uv-ck2r input {
  position: absolute;
  opacity: 0;
  width: 0;
  height: 0;
  pointer-events: none;
}

.uv-ck2r .bx {
  position: relative;
  display: grid;
  place-items: center;
  width: 1.5em;
  height: 1.5em;
  border-radius: .45em;
  box-shadow: inset 0 0 0 2px color-mix(in srgb,var(--fg) 22%,transparent);
  transition: all calc(0.28s / var(--k)) cubic-bezier(.25,.1,.25,1);
}

.uv-ck2r svg {
  width: 1em;
  height: 1em;
  color: #fff;
}

.uv-ck2r svg path {
  stroke-dasharray: 1;
  stroke-dashoffset: 1;
  transition: stroke-dashoffset calc(0.3s / var(--k)) cubic-bezier(.25,.1,.25,1);
}

.uv-ck2r em {
  position: absolute;
  inset: -.3em;
  border-radius: .7em;
  box-shadow: 0 0 0 0 var(--c1);
  opacity: 0;
}

.uv-ck2r:hover .bx {
  box-shadow: inset 0 0 0 2px var(--c1);
}

.uv-ck2r input:checked + .bx {
  background: var(--c1);
  box-shadow: inset 0 0 0 2px var(--c1);
}

.uv-ck2r input:checked + .bx svg path {
  stroke-dashoffset: 0;
}

.uv-ck2r input:checked + .bx em {
  animation: uv-ck2r calc(0.65s / var(--k)) cubic-bezier(.25,.1,.25,1);
}

@keyframes uv-ck2r {
  0% {
    opacity: .5;
    box-shadow: 0 0 0 0 var(--c1);
  }
  100% {
    opacity: 0;
    box-shadow: 0 0 0 .9em var(--c1);
  }
}
`;

export default function Ck2Ripple() {
  return (
    <>
      <style>{css}</style>
      <div
        style={{
          "--c1": "#0071e3",
          "--c2": "#8ec5ff",
          "--s": "16px",
          "--k": "1",
          "--fg": "#1d1d1f",
          "--bg": "#f5f5f7",
        } as CSSProperties}
      >
        <label className="uv-ck2r"><input type="checkbox" /><span className="bx"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="3" strokeLinecap="round" strokeLinejoin="round"><path d="M5 12.5l4.5 4.5L19 7.5" pathLength="1" /></svg><em></em></span>Notifications</label>
      </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 “Ripple checkbox” block (Checkboxes) from AIMRAN Library to my project.

## What it is
When you tick it, a ring of colour spreads out around the box and fades, like a drop in water.

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

## 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-ck2r {
  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: .7em;
  cursor: pointer;
  user-select: none;
  font-weight: 500;
}

.uv-ck2r input {
  position: absolute;
  opacity: 0;
  width: 0;
  height: 0;
  pointer-events: none;
}

.uv-ck2r .bx {
  position: relative;
  display: grid;
  place-items: center;
  width: 1.5em;
  height: 1.5em;
  border-radius: .45em;
  box-shadow: inset 0 0 0 2px color-mix(in srgb,var(--fg) 22%,transparent);
  transition: all calc(0.28s / var(--k)) cubic-bezier(.25,.1,.25,1);
}

.uv-ck2r svg {
  width: 1em;
  height: 1em;
  color: #fff;
}

.uv-ck2r svg path {
  stroke-dasharray: 1;
  stroke-dashoffset: 1;
  transition: stroke-dashoffset calc(0.3s / var(--k)) cubic-bezier(.25,.1,.25,1);
}

.uv-ck2r em {
  position: absolute;
  inset: -.3em;
  border-radius: .7em;
  box-shadow: 0 0 0 0 var(--c1);
  opacity: 0;
}

.uv-ck2r:hover .bx {
  box-shadow: inset 0 0 0 2px var(--c1);
}

.uv-ck2r input:checked + .bx {
  background: var(--c1);
  box-shadow: inset 0 0 0 2px var(--c1);
}

.uv-ck2r input:checked + .bx svg path {
  stroke-dashoffset: 0;
}

.uv-ck2r input:checked + .bx em {
  animation: uv-ck2r calc(0.65s / var(--k)) cubic-bezier(.25,.1,.25,1);
}

@keyframes uv-ck2r {
  0% {
    opacity: .5;
    box-shadow: 0 0 0 0 var(--c1);
  }
  100% {
    opacity: 0;
    box-shadow: 0 0 0 .9em var(--c1);
  }
}
`;

export default function Ck2Ripple() {
  return (
    <>
      <style>{css}</style>
      <div
        style={{
          "--c1": "#0071e3",
          "--c2": "#8ec5ff",
          "--s": "16px",
          "--k": "1",
          "--fg": "#1d1d1f",
          "--bg": "#f5f5f7",
        } as CSSProperties}
      >
        <label className="uv-ck2r"><input type="checkbox" /><span className="bx"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="3" strokeLinecap="round" strokeLinejoin="round"><path d="M5 12.5l4.5 4.5L19 7.5" pathLength="1" /></svg><em></em></span>Notifications</label>
      </div>
    </>
  );
}
```

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