Skip to content

Character Count Ring

A copy-paste form states component in pure HTML, CSS & vanilla JS. Zero dependencies, framework-agnostic, MIT-licensed.

Form StatesHTMLJavaScriptCSSany framework

92 / 120

Copy into your project

HTML
<div class="nuda-fs2-char-ring">
  <label for="fs2-bio" class="nuda-fs2-char-ring__label">Bio</label>
  <div class="nuda-fs2-char-ring__field">
    <textarea id="fs2-bio" class="nuda-fs2-char-ring__input" maxlength="120"
              aria-describedby="fs2-bio-count">Design engineer who ships small, obsessive details.</textarea>
    <svg class="nuda-fs2-char-ring__ring is-warn" viewBox="0 0 36 36" aria-hidden="true">
      <circle class="nuda-fs2-char-ring__track" cx="18" cy="18" r="15.5" />
      <circle class="nuda-fs2-char-ring__bar" cx="18" cy="18" r="15.5" />
    </svg>
  </div>
  <p id="fs2-bio-count" class="nuda-fs2-char-ring__count" aria-live="polite">92 / 120</p>
</div>
<!-- JS: on input, update stroke-dashoffset (circumference * (1 - remaining/max)),
     swap .is-warn past 75% and .is-danger past 92%, and update the count text. -->
JavaScript
/* Character Count Ring — drives the ring fill + count from input length. */
(function () {
  var wrap = document.querySelector('.nuda-fs2-char-ring');
  if (!wrap) return;
  var textarea = wrap.querySelector('.nuda-fs2-char-ring__input');
  var ring = wrap.querySelector('.nuda-fs2-char-ring__ring');
  var bar = wrap.querySelector('.nuda-fs2-char-ring__bar');
  var count = wrap.querySelector('.nuda-fs2-char-ring__count');
  var max = parseInt(textarea.getAttribute('maxlength'), 10) || 120;
  var circumference = 2 * Math.PI * 15.5;

  function update() {
    var len = textarea.value.length;
    var ratio = Math.min(len / max, 1);
    bar.style.strokeDashoffset = String(circumference * (1 - ratio));
    ring.classList.remove('is-warn', 'is-danger');
    if (ratio >= 0.92) ring.classList.add('is-danger');
    else if (ratio >= 0.75) ring.classList.add('is-warn');
    count.textContent = len + ' / ' + max;
  }

  textarea.addEventListener('input', update);
  update();
})();
CSS
.nuda-fs2-char-ring {
  width: 100%;
  max-width: 270px;
  display: flex;
  flex-direction: column;
  gap: 6px;
  font-family: ui-sans-serif,system-ui,sans-serif;
}

.nuda-fs2-char-ring__label {
  font-size: 12px;
  font-weight: 600;
  color: #cfcfcf;
}

.nuda-fs2-char-ring__field {
  position: relative;
}

.nuda-fs2-char-ring__input {
  width: 100%;
  min-height: 64px;
  padding: 10px 40px 10px 12px;
  background: #161616;
  border: 1px solid rgba(255,255,255,.12);
  border-radius: 9px;
  color: #fafafa;
  font-size: 12px;
  font-family: inherit;
  resize: vertical;
  box-sizing: border-box;
  transition: border-color .2s;
}

.nuda-fs2-char-ring__input:focus-visible {
  outline: 2px solid #e4ff54;
  outline-offset: 2px;
  border-color: #e4ff54;
}

.nuda-fs2-char-ring__ring {
  position: absolute;
  right: 9px;
  top: 9px;
  width: 22px;
  height: 22px;
  transform: rotate(-90deg);
}

.nuda-fs2-char-ring__track {
  fill: none;
  stroke: rgba(255,255,255,.1);
  stroke-width: 3;
}

.nuda-fs2-char-ring__bar {
  fill: none;
  stroke: #e4ff54;
  stroke-width: 3;
  stroke-linecap: round;
  stroke-dasharray: 97.4;
  stroke-dashoffset: 24;
  transition: stroke-dashoffset .3s ease,stroke .3s ease;
}

.nuda-fs2-char-ring__ring.is-warn .nuda-fs2-char-ring__bar {
  stroke: #f5c451;
}

.nuda-fs2-char-ring__ring.is-danger .nuda-fs2-char-ring__bar {
  stroke: #ff8080;
  animation: _nuda-fs2charring-pulse 1.2s ease-in-out infinite;
}

.nuda-fs2-char-ring__count {
  margin: 0;
  align-self: flex-end;
  font-size: 11px;
  color: #777;
}

@keyframes _nuda-fs2charring-pulse {
  0%,100% {
    opacity: 1;
  }
  50% {
    opacity: .55;
  }
}

@media (prefers-reduced-motion:reduce) {
  .nuda-fs2-char-ring__ring.is-danger .nuda-fs2-char-ring__bar {
    animation: none !important;
  }
}

How to use Character Count Ring

Paste the HTML where you need it and the CSS into a global stylesheet (or a <style> tag). Every class is prefixed nuda- so it never collides with Tailwind or your own styles. Tweak the CSS custom properties to match your design system.

Works in React, Vue, Svelte, Astro, Next.js, Nuxt, Laravel Blade, Django, Rails — or a single .html file. No npm install, no build step.

More form states components

← Browse all NudaUI components