Bharat Aadhaar Input

BharatAadhaarInput is a headless input for entering India's Aadhaar (आधार), India's government-issued personal identifier. It renders as <input type="text"> with autocomplete="off" to protect sensitive identifiers. It is the editable companion to BharatAadhaarView.

Status: beta — implemented and unit-tested in all seven frameworks; not yet exercised in a composed flow.

Implementation Notes

  • Renders as <input type="text">
  • Format: Twelve digits, the first of which is never 0 or 1. The twelfth digit is a check digit computed with the Verhoeff algorithm, a checksum that detects every single-digit error and every adjacent-digit transposition. Issued by the Unique Identification Authority of India (UIDAI).
  • autocomplete="off" to protect sensitive identifiers
  • Supports two-way binding on the value prop
  • Companion to BharatAadhaarView

Props

  • label: string (required) — accessible label via aria-label
  • value: string (default: "") — bindable input value
  • required: boolean (default: false) — form validation
  • disabled: boolean (default: false) — disabled state
  • ...restProps: any — additional HTML attributes spread onto the <input>

Usage

<Field label="Aadhaar (आधार)" required>
  <BharatAadhaarInput label="Aadhaar (आधार)" value={value} required />
  <Hint>Twelve digits, the first of which is never 0 or 1. The twelfth digit is a check digit computed with the Verhoeff algorithm, a checksum that detects every single-digit error and every adjacent-digit transposition. Issued by the Unique Identification Authority of India (UIDAI).</Hint>
  <ErrorMessage>Please enter a valid Aadhaar</ErrorMessage>
</Field>

ARIA

  • aria-label={label} — provides accessible name

When to Use

  • Use in forms collecting India's Aadhaar (आधार).
  • Use in administrative or national-id workflows where the identifier is required.

When Not to Use

  • Do not use for displaying read-only identifiers — use bharat-aadhaar-view instead.
  • Do not use for general text input — use text-input instead.
  • Do not use for other countries' identifiers — use the corresponding country-specific input.

Headless

This headless component ships zero CSS. The consumer provides all styling targeting the .bharat-aadhaar-input class hook.

Testing

  • Verify renders an <input> with the correct class and type="text"
  • Verify aria-label is set from the label prop
  • Verify autocomplete="off"
  • Verify value binding works

Domain Knowledge

Twelve digits, the first of which is never 0 or 1. The twelfth digit is a check digit computed with the Verhoeff algorithm, a checksum that detects every single-digit error and every adjacent-digit transposition. Issued by the Unique Identification Authority of India (UIDAI).

Where to find it: Printed on the Aadhaar letter/card issued by UIDAI, and retrievable through the mAadhaar app and UIDAI's online portal.

Related components

  • bharat-aadhaar-view — a read-only display of India's Aadhaar (आधार)
  • text-input — a single-line text input field <input type="text">

References


Lily™ and Lily Design System™ are trademarks.

Example

BharatAadhaarInput
Show demo markup
<div class="bharat-aadhaar-input" aria-label="an input for entering India's Aadhaar number">BharatAadhaarInput</div>
Usage example
<BharatAadhaarInput label="BharatAadhaarInput example">Content</BharatAadhaarInput>
Show Svelte source
// In your Svelte component:
import BharatAadhaarInput from "lily-design-system-svelte-headless/components/BharatAadhaarInput/BharatAadhaarInput.svelte";

<BharatAadhaarInput>
  <!-- content -->
</BharatAadhaarInput>

Canonical contract

Generated from this component's canonical metadata — the machine-checked source the implementations are held to.

Metadata

  • Component: bharat-aadhaar-input
  • PascalCase: BharatAadhaarInput
  • Description: an input for entering India's Aadhaar (आधार)
  • Status: beta — implemented and unit-tested in all seven frameworks; not yet exercised in a composed flow
  • HTML tag: <input>
  • CSS class: .bharat-aadhaar-input
  • Interactive: yes

ARIA

  • aria-label provides accessible name from label prop
  • required and disabled states conveyed to assistive technology

Keyboard

  • Standard text input keyboard behavior

Props

  • label: string (required) — accessible label via aria-label
  • value: string (default: "") — bindable input value
  • required: boolean (default: false) — form validation
  • disabled: boolean (default: false) — disabled state
  • ...restProps: any additional HTML attributes spread onto the root