Text Field

A text field whose label folds up as you type. A button clears it, a check draws itself once it is valid, and the hint gives way to the error.

View the code Ask your AI

Forms No dependencies inputformvalidationlabel Added Oct 2026

/anim/text-field/ Fullscreen

With your AI

Just ask.

Say it to your AI. It gets the exact code below, not its best guess, and knows where it goes.

Restyle my contact form fields with Kodza Text Field.

Not plugged in yet?

claude mcp add -t http kodza https://kodza.dev/api/mcp

Also in Codex, Cursor and VS Code.

kodza-text-field.html

<div class="kodza-field">
  <label class="kodza-field__box">
    <input class="kodza-field__input" type="email" name="email" placeholder=" " autocomplete="email" required data-error="That does not look like an email.">
    <span class="kodza-field__label">Email</span>
    <svg class="kodza-field__check" viewBox="0 0 16 16" aria-hidden="true"><path d="M3.5 8.5l3 3 6-7" pathLength="1"/></svg>
  </label>
  <button class="kodza-field__clear" type="button" tabindex="-1" aria-label="Clear the field"><svg viewBox="0 0 16 16" aria-hidden="true"><path d="M5 5l6 6M11 5l-6 6"/></svg></button>
  <p class="kodza-field__note"><span class="kodza-field__hint">We only write when something ships.</span><span class="kodza-field__error" aria-live="polite"></span></p>
</div>

<div class="kodza-field">
  <label class="kodza-field__box">
    <span class="kodza-field__prefix">kodza.dev/</span>
    <input class="kodza-field__input" type="text" name="handle" placeholder=" " autocomplete="username" required pattern="[a-z0-9\-]+" minlength="2" data-error="Lowercase letters, digits and dashes only.">
    <span class="kodza-field__label">Username</span>
    <svg class="kodza-field__check" viewBox="0 0 16 16" aria-hidden="true"><path d="M3.5 8.5l3 3 6-7" pathLength="1"/></svg>
  </label>
  <button class="kodza-field__clear" type="button" tabindex="-1" aria-label="Clear the field"><svg viewBox="0 0 16 16" aria-hidden="true"><path d="M5 5l6 6M11 5l-6 6"/></svg></button>
  <p class="kodza-field__note"><span class="kodza-field__hint">Lowercase, no spaces. Like your variable names.</span><span class="kodza-field__error" aria-live="polite"></span></p>
</div>

<div class="kodza-field">
  <label class="kodza-field__box">
    <input class="kodza-field__input" type="text" name="plan" placeholder=" " value="Free, forever" disabled>
    <span class="kodza-field__label">Plan</span>
  </label>
  <p class="kodza-field__note"><span class="kodza-field__hint">There is no other plan.</span></p>
</div>

kodza-text-field.css

/* Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license */
/* Kodza — Text Field
   A text field whose label sits inside it, then folds up above the text as soon as you type or
   focus it. A button clears it, a check draws itself once the value is valid, and the hint
   gives way to the error message (from data-error) when it is not, without anything moving.
   A prefix (kodza.dev/) slides in with the label. The clear button stays out of the Tab order
   (from the keyboard, select all and delete), so Tab always leaves the field. Errors are monochrome by default: an icon and
   a message, never colour alone (set --kz-field-error to use a red).
   Everything is tuned with the --kz-field-* variables. */
.kodza-field {
  --kz-field-bg: #ffffff;
  --kz-field-fg: #0a0a0a;
  --kz-field-muted: rgba(10, 10, 10, 0.6);
  --kz-field-line: rgba(10, 10, 10, 0.14);
  --kz-field-line-hover: rgba(10, 10, 10, 0.3);
  --kz-field-focus: #0a0a0a;
  --kz-field-error: #0a0a0a;
  --kz-field-disabled: rgba(10, 10, 10, 0.04);
  --kz-field-height: 56px;
  --kz-field-radius: 12px;
  --kz-field-pad: 16px;
  --kz-field-ease: cubic-bezier(0.22, 1, 0.36, 1);

  position: relative;
  display: grid;
  gap: 8px;
  width: 100%;
  max-width: 420px;
  color: var(--kz-field-fg);
}

/* The box: the whole thing is the label, so a click anywhere focuses the input */
.kodza-field__box {
  position: relative;
  display: flex;
  align-items: flex-end;
  box-sizing: border-box;
  height: var(--kz-field-height);
  padding: 0 var(--kz-field-pad) 9px;
  border-radius: var(--kz-field-radius);
  background: var(--kz-field-bg);
  box-shadow: inset 0 0 0 1px var(--kz-field-line);
  cursor: text;
  transition: box-shadow 0.25s ease;
}

.kodza-field__box:hover {
  box-shadow: inset 0 0 0 1px var(--kz-field-line-hover);
}

.kodza-field__box:focus-within {
  box-shadow: inset 0 0 0 1.5px var(--kz-field-focus), 0 0 0 4px var(--kz-field-disabled);
}

.kodza-field__input {
  flex: 1;
  min-width: 0;
  height: 22px;
  padding: 0;
  border: 0;
  background: none;
  color: inherit;
  font: inherit;
  font-size: 15px;
  line-height: 22px;
  outline: none;
}

/* The label: inside the box at rest, folded up above the text once focused or filled */
.kodza-field__label {
  position: absolute;
  top: 50%;
  left: var(--kz-field-pad);
  color: var(--kz-field-muted);
  font-size: 15px;
  line-height: 1;
  white-space: nowrap;
  pointer-events: none;
  transform: translateY(-50%);
  transform-origin: left top;
  transition: transform 0.35s var(--kz-field-ease), color 0.25s ease;
}

.kodza-field__box:focus-within .kodza-field__label,
.kodza-field__input:not(:placeholder-shown) ~ .kodza-field__label {
  color: var(--kz-field-muted);
  transform: translateY(-18px) scale(0.8);
}

/* A prefix waits with the label, then comes in */
.kodza-field__prefix {
  flex: none;
  color: var(--kz-field-muted);
  font-size: 15px;
  line-height: 22px;
  opacity: 0;
  transform: translateX(-4px);
  transition: opacity 0.25s ease, transform 0.35s var(--kz-field-ease);
}

.kodza-field__box:focus-within .kodza-field__prefix,
.kodza-field__box:has(.kodza-field__input:not(:placeholder-shown)) .kodza-field__prefix {
  opacity: 1;
  transform: none;
}

/* The check: drawn once the value is valid */
.kodza-field__check {
  position: absolute;
  top: 50%;
  right: var(--kz-field-pad);
  width: 16px;
  height: 16px;
  fill: none;
  stroke: var(--kz-field-fg);
  stroke-width: 1.8;
  stroke-linecap: round;
  stroke-linejoin: round;
  stroke-dasharray: 1;
  stroke-dashoffset: 1;
  transform: translateY(-50%);
  transition: stroke-dashoffset 0.4s var(--kz-field-ease);
}

.kodza-field__input[aria-invalid="false"]:not(:placeholder-shown) ~ .kodza-field__check {
  stroke-dashoffset: 0;
  transition-delay: 0.1s;
}

/* The clear button: in when there is something to clear (and no check to show) */
.kodza-field__clear {
  position: absolute;
  top: calc(var(--kz-field-height) / 2 - 14px);
  right: 10px;
  display: grid;
  place-items: center;
  width: 28px;
  height: 28px;
  padding: 0;
  border: 0;
  border-radius: 50%;
  background: var(--kz-field-disabled);
  color: var(--kz-field-muted);
  white-space: nowrap;
  cursor: pointer;
  opacity: 0;
  transform: scale(0.6);
  visibility: hidden;
  transition: opacity 0.2s ease, transform 0.3s var(--kz-field-ease), visibility 0s linear 0.3s, color 0.2s ease;
}

.kodza-field__clear svg {
  width: 12px;
  height: 12px;
  fill: none;
  stroke: currentColor;
  stroke-width: 1.8;
  stroke-linecap: round;
}

.kodza-field__clear:hover {
  color: var(--kz-field-fg);
}

.kodza-field:has(.kodza-field__box:focus-within .kodza-field__input:not(:placeholder-shown)) .kodza-field__clear,
.kodza-field:has(.kodza-field__input:not(:placeholder-shown)):focus-within .kodza-field__clear {
  opacity: 1;
  transform: none;
  visibility: visible;
  transition-delay: 0s;
}

/* While the clear button shows, the check steps aside */
.kodza-field:focus-within .kodza-field__check {
  opacity: 0;
}

.kodza-field__clear:focus-visible {
  outline: 2px solid var(--kz-field-focus);
  outline-offset: 2px;
}

/* The note: the hint and the error share one line, and swap */
.kodza-field__note {
  display: grid;
  margin: 0;
  padding: 0 2px;
  overflow: hidden;
  font-size: 13px;
  line-height: 1.4;
}

.kodza-field__hint,
.kodza-field__error {
  grid-area: 1 / 1;
  transition: opacity 0.25s ease, transform 0.4s var(--kz-field-ease);
}

.kodza-field__hint {
  color: var(--kz-field-muted);
}

.kodza-field__error {
  display: flex;
  align-items: center;
  gap: 6px;
  color: var(--kz-field-error);
  font-weight: 500;
  opacity: 0;
  transform: translateY(100%);
}

.kodza-field__error::before {
  content: "";
  flex: none;
  width: 14px;
  height: 14px;
  background: currentColor;
  -webkit-mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Ccircle cx='8' cy='8' r='6.5' fill='none' stroke='black' stroke-width='1.5'/%3E%3Cpath d='M8 4.5v4.2M8 10.9v.1' stroke='black' stroke-width='1.6' stroke-linecap='round'/%3E%3C/svg%3E") center / contain no-repeat;
  mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Ccircle cx='8' cy='8' r='6.5' fill='none' stroke='black' stroke-width='1.5'/%3E%3Cpath d='M8 4.5v4.2M8 10.9v.1' stroke='black' stroke-width='1.6' stroke-linecap='round'/%3E%3C/svg%3E") center / contain no-repeat;
}

/* Invalid (judged when the visitor leaves the field, then live while they fix it): a firmer
   outline, and the error replaces the hint */
.kodza-field:has(.kodza-field__input[aria-invalid="true"]) .kodza-field__box {
  box-shadow: inset 0 0 0 1.5px var(--kz-field-error);
}

.kodza-field:has(.kodza-field__input[aria-invalid="true"]) .kodza-field__hint {
  opacity: 0;
  transform: translateY(-100%);
}

.kodza-field:has(.kodza-field__input[aria-invalid="true"]) .kodza-field__error {
  opacity: 1;
  transform: none;
}

/* Disabled */
.kodza-field__box:has(.kodza-field__input:disabled) {
  background: var(--kz-field-disabled);
  box-shadow: none;
  color: var(--kz-field-muted);
  cursor: not-allowed;
}

.kodza-field__input:disabled {
  cursor: not-allowed;
}

@media (prefers-reduced-motion: reduce) {
  .kodza-field__box,
  .kodza-field__label,
  .kodza-field__prefix,
  .kodza-field__check,
  .kodza-field__clear,
  .kodza-field__hint,
  .kodza-field__error {
    transition-duration: 0.01ms !important;
    transition-delay: 0s !important;
  }
}

/* Theming example — on a dark background:
.dark-section .kodza-field {
  --kz-field-bg: #161616;
  --kz-field-fg: #f2f2f0;
  --kz-field-muted: rgba(242, 242, 240, 0.62);
  --kz-field-line: rgba(255, 255, 255, 0.14);
  --kz-field-line-hover: rgba(255, 255, 255, 0.3);
  --kz-field-focus: #f2f2f0;
  --kz-field-error: #f2f2f0;
  --kz-field-disabled: rgba(255, 255, 255, 0.06);
}
*/

/* kodza-guard 2e819d51de55 — generated by Kodza, do not edit.
   Theme guard: keeps a site's own CSS (WordPress themes, Bootstrap, CSS resets…) off this
   component. :not(#_) is always true and weighs as much as an id, so these lines win over
   theme rules made of classes and tags. Customise the component through its --kz-* variables. */

/* What the browser gives, where the component sets it only in some states: at the lowest weight, so its own rules below put it back */

:where(.kodza-field__box):not(#_) {
  color: revert;
}

:where(.kodza-field__clear):not(#_) {
  outline: revert;
  outline-offset: revert;
}

/* What the browser gives, on everything the component leaves to it */

.kodza-field:not(#_),
.kodza-field__label:not(#_),
.kodza-field__hint:not(#_),
.kodza-field__error:not(#_),
.kodza-field__prefix:not(#_) {
  box-sizing: revert;
}

.kodza-field__box:not(#_) {
  border: revert;
  margin: revert;
  outline: revert;
  text-decoration: revert;
  list-style: revert;
  float: revert;
  outline-offset: revert;
  appearance: revert;
  max-width: revert;
  max-height: revert;
  font-family: revert;
  font-size: revert;
  font-weight: revert;
  font-style: revert;
  line-height: revert;
  letter-spacing: revert;
  text-transform: revert;
  text-underline-offset: revert;
  text-align: revert;
  text-indent: revert;
  text-shadow: revert;
  vertical-align: revert;
}

.kodza-field__input:not(#_) {
  margin: revert;
  border-radius: revert;
  text-decoration: revert;
  transition: revert;
  list-style: revert;
  box-sizing: revert;
  float: revert;
  position: revert;
  box-shadow: revert;
  outline-offset: revert;
  appearance: revert;
  max-width: revert;
  max-height: revert;
  letter-spacing: revert;
  text-transform: revert;
  text-underline-offset: revert;
  text-align: revert;
  text-indent: revert;
  text-shadow: revert;
  vertical-align: revert;
  white-space: revert;
  min-height: revert;
}

.kodza-field__check:not(#_) {
  border: revert;
  margin: revert;
  padding: revert;
  border-radius: revert;
  outline: revert;
  text-decoration: revert;
  list-style: revert;
  box-sizing: revert;
  float: revert;
  background-color: revert;
  background-image: revert;
  box-shadow: revert;
  outline-offset: revert;
  appearance: revert;
  max-width: revert;
  max-height: revert;
  color: revert;
  font-family: revert;
  font-size: revert;
  font-weight: revert;
  font-style: revert;
  line-height: revert;
  letter-spacing: revert;
  text-transform: revert;
  text-underline-offset: revert;
  text-align: revert;
  text-indent: revert;
  text-shadow: revert;
  vertical-align: revert;
}

.kodza-field__clear:not(#_) {
  margin: revert;
  text-decoration: revert;
  list-style: revert;
  box-sizing: revert;
  float: revert;
  box-shadow: revert;
  appearance: revert;
  max-width: revert;
  max-height: revert;
  font-family: revert;
  font-size: revert;
  font-weight: revert;
  font-style: revert;
  line-height: revert;
  letter-spacing: revert;
  text-transform: revert;
  text-underline-offset: revert;
  text-align: revert;
  text-indent: revert;
  text-shadow: revert;
  vertical-align: revert;
  min-height: revert;
}

.kodza-field__note:not(#_) {
  border: revert;
  border-radius: revert;
  outline: revert;
  text-decoration: revert;
  transition: revert;
  list-style: revert;
  box-sizing: revert;
  float: revert;
  position: revert;
  background-color: revert;
  background-image: revert;
  box-shadow: revert;
  outline-offset: revert;
  appearance: revert;
  max-width: revert;
  max-height: revert;
  color: revert;
  font-family: revert;
  font-weight: revert;
  font-style: revert;
  letter-spacing: revert;
  text-transform: revert;
  text-underline-offset: revert;
  text-align: revert;
  text-indent: revert;
  text-shadow: revert;
  vertical-align: revert;
}

.kodza-field__clear svg:where(:not([class*="kodza-"])):not(#_) {
  border: revert;
  margin: revert;
  padding: revert;
  border-radius: revert;
  outline: revert;
  text-decoration: revert;
  transition: revert;
  list-style: revert;
  box-sizing: revert;
  float: revert;
  position: revert;
  background-color: revert;
  background-image: revert;
  box-shadow: revert;
  outline-offset: revert;
  appearance: revert;
  max-width: revert;
  max-height: revert;
  color: revert;
  font-family: revert;
  font-size: revert;
  font-weight: revert;
  font-style: revert;
  line-height: revert;
  letter-spacing: revert;
  text-transform: revert;
  text-underline-offset: revert;
  text-align: revert;
  text-indent: revert;
  text-shadow: revert;
  vertical-align: revert;
}

.kodza-field__input:not(#_):where(:not([hidden])),
.kodza-field__check:not(#_):where(:not([hidden])),
.kodza-field__clear svg:where(:not([class*="kodza-"])):not(#_):where(:not([hidden])) {
  display: revert;
}

.kodza-field__input:not(#_):where([hidden]),
.kodza-field__check:not(#_):where([hidden]),
.kodza-field__clear svg:where(:not([class*="kodza-"])):not(#_):where([hidden]) {
  display: none;
}

.kodza-field__error:not(#_)::before {
  box-sizing: revert;
}

/* The component's own rules, one step stronger: real buttons and fields, what it sets on tags themes style (links, lists, headings, images…), and the root width (a theme may narrow it, never widen it) */

.kodza-field:not(#_) {
  width: min(100%, 420px);
}

.kodza-field__box:not(#_) {
  position: relative;
  display: flex;
  box-sizing: border-box;
  padding: 0 var(--kz-field-pad) 9px;
  border-radius: var(--kz-field-radius);
  background: var(--kz-field-bg);
  box-shadow: inset 0 0 0 1px var(--kz-field-line);
  transition: box-shadow 0.25s ease;
}

.kodza-field__box:hover:not(#_) {
  box-shadow: inset 0 0 0 1px var(--kz-field-line-hover);
}

.kodza-field__box:focus-within:not(#_) {
  box-shadow: inset 0 0 0 1.5px var(--kz-field-focus), 0 0 0 4px var(--kz-field-disabled);
}

.kodza-field__input:not(#_) {
  flex: 1;
  min-width: 0;
  height: 22px;
  padding: 0;
  border: 0;
  background: none;
  color: inherit;
  font: inherit;
  font-size: 15px;
  line-height: 22px;
  outline: none;
}

.kodza-field__check:not(#_) {
  position: absolute;
  transition: stroke-dashoffset 0.4s var(--kz-field-ease);
}

.kodza-field__input[aria-invalid="false"]:not(:placeholder-shown) ~ .kodza-field__check:not(#_) {
  transition-delay: 0.1s;
}

.kodza-field__clear:not(#_) {
  position: absolute;
  top: calc(var(--kz-field-height) / 2 - 14px);
  right: 10px;
  display: grid;
  place-items: center;
  width: 28px;
  height: 28px;
  padding: 0;
  border: 0;
  border-radius: 50%;
  background: var(--kz-field-disabled);
  color: var(--kz-field-muted);
  white-space: nowrap;
  cursor: pointer;
  opacity: 0;
  transform: scale(0.6);
  visibility: hidden;
  transition: opacity 0.2s ease, transform 0.3s var(--kz-field-ease), visibility 0s linear 0.3s, color 0.2s ease;
}

.kodza-field__clear:hover:not(#_) {
  color: var(--kz-field-fg);
}

.kodza-field:has(.kodza-field__box:focus-within .kodza-field__input:not(:placeholder-shown)) .kodza-field__clear:not(#_),
.kodza-field:has(.kodza-field__input:not(:placeholder-shown)):focus-within .kodza-field__clear:not(#_) {
  opacity: 1;
  transform: none;
  visibility: visible;
  transition-delay: 0s;
}

.kodza-field__clear:focus-visible:not(#_) {
  outline: 2px solid var(--kz-field-focus);
  outline-offset: 2px;
}

.kodza-field__note:not(#_) {
  display: grid;
  margin: 0;
  padding: 0 2px;
  font-size: 13px;
  line-height: 1.4;
}

.kodza-field:has(.kodza-field__input[aria-invalid="true"]) .kodza-field__box:not(#_) {
  box-shadow: inset 0 0 0 1.5px var(--kz-field-error);
}

.kodza-field__box:has(.kodza-field__input:disabled):not(#_) {
  background: var(--kz-field-disabled);
  box-shadow: none;
  color: var(--kz-field-muted);
}

.kodza-field__input:disabled:not(#_) {
  cursor: not-allowed;
}

@media (prefers-reduced-motion: reduce) {
  .kodza-field__box:not(#_),
  .kodza-field__check:not(#_) {
    transition-duration: 0.01ms !important;
    transition-delay: 0s !important;
  }
}

@media (prefers-reduced-motion: reduce) {
  .kodza-field__clear:not(#_) {
    transition-duration: 0.01ms !important;
    transition-delay: 0s !important;
  }
}

kodza-text-field.js

// Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license
// Kodza — Text Field
// Wires the hint and the error to the input (aria-describedby, ids made here), writes the
// error message (data-error, or the browser's own) when the value is invalid, and clears the
// field from its button. The folding label, the check and the swaps are CSS.
(() => {
  const SELECTOR = '.kodza-field';
  let uid = 0;

  // One instance. Everything it starts is tied to `signal`, so kodza:destroy stops it all
  function mount(root, signal) {
    const input = root.querySelector('.kodza-field__input');
    const hint = root.querySelector('.kodza-field__hint');
    const error = root.querySelector('.kodza-field__error');
    const clear = root.querySelector('.kodza-field__clear');
    if (!input) return;
    const prefix = `kodza-field-${++uid}`;
    const described = [];
    if (hint) described.push((hint.id = `${prefix}-hint`));
    if (error) described.push((error.id = `${prefix}-error`));
    if (described.length) input.setAttribute('aria-describedby', described.join(' '));

    const check = () => {
      if (!error) return;
      const bad = !input.validity.valid;
      error.textContent = bad ? input.dataset.error || input.validationMessage : '';
      input.setAttribute('aria-invalid', String(bad));
    };
    // Judged when the visitor leaves the field, then live while they fix it
    input.addEventListener('blur', check, { signal });
    input.addEventListener('input', () => input.getAttribute('aria-invalid') === 'true' && check(), { signal });
    input.addEventListener('invalid', check, { signal });

    clear?.addEventListener('click', () => {
      input.value = '';
      input.dispatchEvent(new Event('input', { bubbles: true }));
      if (error) error.textContent = '';
      input.removeAttribute('aria-invalid');
      input.focus();
    }, { signal });
  }

  // Kodza lifecycle, the same in every component: `kodza:init` starts the instances inside
  // event.detail.root (the whole page by default), `kodza:destroy` stops them and puts their
  // markup back. For themes and apps that swap content without a page load.
  const instances = new WeakMap();
  const find = (scope = document) => [scope, ...scope.querySelectorAll(SELECTOR)].filter((el) => el.matches?.(SELECTOR));
  const init = (scope) => find(scope).forEach((root) => {
    if (root.classList.contains('is-ready')) return; // already running, maybe from another copy of this script
    const controller = new AbortController();
    instances.set(root, { controller, html: root.innerHTML, attrs: [...root.attributes].map((a) => [a.name, a.value]) });
    mount(root, controller.signal);
    root.classList.add('is-ready');
  });
  const destroy = (scope) => find(scope).forEach((root) => {
    const instance = instances.get(root);
    if (!instance) return;
    instances.delete(root);
    instance.controller.abort();
    [...root.attributes].forEach((a) => root.removeAttribute(a.name));
    instance.attrs.forEach(([name, value]) => root.setAttribute(name, value));
    root.innerHTML = instance.html;
  });
  document.addEventListener('kodza:init', (event) => init(event.detail?.root));
  document.addEventListener('kodza:destroy', (event) => destroy(event.detail?.root));
  init();
  // Loaded in <head>, the script runs before the markup exists: once more when it is parsed
  if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', () => init(), { once: true });
})();

TextField.tsx

'use client';
// Kodza — Text Field, for React. From https://kodza.dev/components/text-field/
// Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license
// Next to this file: text-field.css and text-field.js, the component's CSS and JS from Kodza, as they are.
// Yours to edit: the markup is plain JSX below.
// The script changes this markup once React has rendered it (it adds layers, splits text, moves
// nodes), so React must not patch it afterwards. When a prop changes, the key gives React a fresh
// element: kodza:destroy stops the script on the old one, kodza:init starts it on the new one.
import { useRef, useEffect, type ComponentPropsWithoutRef, type ComponentRef, type CSSProperties } from 'react';
import './text-field.css';

export type TextFieldProps = Omit<ComponentPropsWithoutRef<'div'>, "children" | "vars"> & {
  /** Settings, as CSS variables on the root */
  vars?: {
    /** default: #ffffff */
    "--kz-field-bg"?: string | number;
    /** default: #0a0a0a */
    "--kz-field-fg"?: string | number;
    /** default: rgba(10, 10, 10, 0.6) */
    "--kz-field-muted"?: string | number;
    /** default: rgba(10, 10, 10, 0.14) */
    "--kz-field-line"?: string | number;
    /** default: rgba(10, 10, 10, 0.3) */
    "--kz-field-line-hover"?: string | number;
    /** default: #0a0a0a */
    "--kz-field-focus"?: string | number;
    /** default: #0a0a0a */
    "--kz-field-error"?: string | number;
    /** default: rgba(10, 10, 10, 0.04) */
    "--kz-field-disabled"?: string | number;
    /** default: 56px */
    "--kz-field-height"?: string | number;
    /** default: 12px */
    "--kz-field-radius"?: string | number;
    /** default: 16px */
    "--kz-field-pad"?: string | number;
    /** default: cubic-bezier(0.22, 1, 0.36, 1) */
    "--kz-field-ease"?: string | number;
  };
  className?: string;
};

export function TextField({ vars, className, style, ...rest }: TextFieldProps) {
  const ref = useRef<ComponentRef<'div'>>(null);
  const classes = ["kodza-field", className].filter(Boolean).join(' ');
  // Everything the markup is made of: when it changes, React gets a fresh element (see the top)
  const key = JSON.stringify([classes, vars, style, rest]);

  // Starts the script on this element once React has rendered it, stops it when it goes
  useEffect(() => {
    const root = ref.current;
    let live = true;
    // @ts-ignore: a plain script, no types to find
    import('./text-field.js').then(() => {
      if (live) document.dispatchEvent(new CustomEvent('kodza:init', { detail: { root } }));
    });
    return () => {
      live = false;
      document.dispatchEvent(new CustomEvent('kodza:destroy', { detail: { root } }));
    };
  }, [key]);

  return (
    <div key={key} {...rest} className={classes} style={{ ...vars, ...style } as CSSProperties} ref={ref}>
      <label className="kodza-field__box">
        <input className="kodza-field__input" type="email" name="email" placeholder=" " autoComplete="email" required data-error="That does not look like an email." />
        {' '}
        <span className="kodza-field__label">Email</span>
        {' '}
        <svg className="kodza-field__check" viewBox="0 0 16 16" aria-hidden="true">
          <path d="M3.5 8.5l3 3 6-7" pathLength="1" />
        </svg>
      </label>
      {' '}
      <button className="kodza-field__clear" type="button" tabIndex={-1} aria-label="Clear the field">
        <svg viewBox="0 0 16 16" aria-hidden="true">
          <path d="M5 5l6 6M11 5l-6 6" />
        </svg>
      </button>
      <p className="kodza-field__note">
        <span className="kodza-field__hint">We only write when something ships.</span>
        <span className="kodza-field__error" aria-live="polite" />
      </p>
    </div>
  );
}

Checked

Checked before you paste.

Robots poked at it before you did. Every component goes through the same checks, and again each time it changes.

What ranLast run Oct 19, 2026

Accessibilityaxe-core 4.10.2: the WCAG 2.1 A and AA rules, plus best practices. 0 issues

KeyboardThe Tab key gets there, and the focus ring shows when it does. Passed

Reduced motionTurn on reduced motion and what moved just appears. Nothing loops. Passed

Light and darkThe same checks on both themes, contrast included. Passed

WordPressPasted into Twenty Twenty-Five, Twenty Twenty-One, Astra, Blocksy, GeneratePress, Hello Elementor, Kadence and OceanWP. Nothing to flag. 8 / 8 themes

Robots checked this. A human with VoiceOver hasn't yet.