Taiwan Guomin Shenfenzheng Tongyi Bianhao View

Props

• value: string (default: "") — the identifier to display
• label: string (required) — accessible label via aria-label
• ...restProps: any — additional HTML attributes spread onto the <span>

ARIA

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

When to Use

• Use to display a stored Taiwan National Identification Card Number read-only.
• Use in summary lists, patient records, audit logs, or detail views.
• Use when the identifier should not be editable in the current context.

When Not to Use

• Do not use for editing identifiers — use taiwan-guomin-shenfenzheng-tongyi-bianhao-input instead.
• Do not use for general text display — use a <span> directly.
• Do not use for other countries' identifiers — use the corresponding country-specific view.

Headless

This headless component ships zero CSS. The consumer provides all styling targeting the .taiwan-guomin-shenfenzheng-tongyi-bianhao-view class hook.

Testing

• Verify renders a <span> with the correct class
• Verify the value prop is rendered as text content
• Verify aria-label is set from the label prop

Domain Knowledge

One uppercase letter for the household-registration office, then nine digits. The first digit is 1 for a male and 2 for a female citizen (8 or 9 for a foreign resident), and the last digit is a check digit. The letter is converted to a two-digit number (A=10, B=11 and so on in the official order A-H, J-N, P-V, X, Y, W, Z, I, O), the eleven resulting digits are multiplied by the weights 1,9,8,7,6,5,4,3,2,1,1, and the sum must be a multiple of 10.

Where to find it: Printed on the National Identification Card (國民身分證) and used for National Health Insurance, banking, tax filing and household registration.

Related components

• taiwan-guomin-shenfenzheng-tongyi-bianhao-input — an input for entering Taiwan's National Identification Card Number
• summary-list-item — one key-value pair in a summary list

References

• Wikipedia: National identification card (Taiwan)

Lily™ and Lily Design System™ are trademarks.

Implementation Notes

• Renders as <span>
• Format: One uppercase letter for the household-registration office, then nine digits. The first digit is 1 for a male and 2 for a female citizen (8 or 9 for a foreign resident), and the last digit is a check digit. The letter is converted to a two-digit number (A=10, B=11 and so on in the official order A-H, J-N, P-V, X, Y, W, Z, I, O), the eleven resulting digits are multiplied by the weights 1,9,8,7,6,5,4,3,2,1,1, and the sum must be a multiple of 10.
• Provides accessible name via the label prop
• Companion to TaiwanGuominShenfenzhengTongyiBianhaoInput