Guatemala Codigo Unico De Identificacion View
GuatemalaCodigoUnicoDeIdentificacionView is a headless read-only display of Guatemala's Código Único de Identificación (CUI), Guatemala's government-issued personal identifier. It renders as a <span> with an accessible label. It is the read-only companion to GuatemalaCodigoUnicoDeIdentificacionInput.
Status: beta — implemented and unit-tested in all seven frameworks; not yet exercised in a composed flow.
Example
GuatemalaCodigoUnicoDeIdentificacionView
Show demo markup
<div class="guatemala-codigo-unico-de-identificacion-view" aria-label="a read-only display of Guatemala's Código Único de Identificación (CUI)">GuatemalaCodigoUnicoDeIdentificacionView</div>
Usage example
<GuatemalaCodigoUnicoDeIdentificacionView label="GuatemalaCodigoUnicoDeIdentificacionView example"
>Content</GuatemalaCodigoUnicoDeIdentificacionView
>
Show Svelte source
// In your Svelte component:
import GuatemalaCodigoUnicoDeIdentificacionView from "lily-design-system-svelte-headless/components/GuatemalaCodigoUnicoDeIdentificacionView/GuatemalaCodigoUnicoDeIdentificacionView.svelte";
<GuatemalaCodigoUnicoDeIdentificacionView>
<!-- content -->
</GuatemalaCodigoUnicoDeIdentificacionView>
Usage
<SummaryList>
<SummaryListItem term="Código Único de Identificación (CUI)">
<GuatemalaCodigoUnicoDeIdentificacionView
label="Código Único de Identificación (CUI)"
value="{value}"
/>
</SummaryListItem>
</SummaryList>
Props
value: string (default: "") — the identifier to display
label: string (optional) — hidden text naming the value, in a .screen-reader-span. Leave it out when a visible caption names the value
...restProps: any — additional HTML attributes spread onto the <span>
ARIA
- No ARIA on the root: a plain
<span> cannot be named. A visible caption names the value, or label renders as hidden text in a .screen-reader-span
When to Use
- Use to display a stored Código Único de Identificación (CUI) from Guatemala 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
guatemala-codigo-unico-de-identificacion-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 .guatemala-codigo-unico-de-identificacion-view class hook.
Testing
- Verify renders a
<span> with the correct class
- Verify the
value prop is rendered as text content
- Verify
label renders as hidden text, and that the root has no aria-label
Domain Knowledge
Thirteen digits, written 4-5-4 on the DPI card: eight assigned in sequence, one check digit, then two for the department and two for the municipality of birth (RENAP). RENAP does not publish the check-digit formula; open-source validators use weights 2 to 9 over the first eight digits, modulo 11, but that is not confirmed by the registry.
Where to find it: Printed on the front of the Documento Personal de Identificación (DPI) issued by RENAP, and given at birth registration.
Security and privacy
A national identifier is personal data, and often a key to other records.
- The view shows exactly the text it is given; it does not mask. Pass the masked form (for example the last four characters) wherever the full number is not needed, and render the full number only to someone entitled to it.
- Do not log the value, put it in a URL or query string, or send it to analytics or an error tracker.
- Text on screen can be read over a shoulder and is kept by screenshots and screen recordings; treat a page that shows it as sensitive.
Related components
guatemala-codigo-unico-de-identificacion-input — an input for entering Guatemala's Código Único de Identificación (CUI)
summary-list-item — one key-value pair in a summary list
References
Lily™ and Lily Design System™ are trademarks.
Implementation Notes
- Renders as
<span>
- Format: Thirteen digits, written 4-5-4 on the DPI card: eight assigned in sequence, one check digit, then two for the department and two for the municipality of birth (RENAP). RENAP does not publish the check-digit formula; open-source validators use weights 2 to 9 over the first eight digits, modulo 11, but that is not confirmed by the registry.
- Provides accessible name via the
label prop
- Companion to GuatemalaCodigoUnicoDeIdentificacionInput
Canonical contract
Generated from this component's canonical metadata — the machine-checked source the implementations are held to.
Metadata
- Component: guatemala-codigo-unico-de-identificacion-view
- PascalCase: GuatemalaCodigoUnicoDeIdentificacionView
- Description: a read-only display of Guatemala's Código Único de Identificación (CUI)
- Status: beta — implemented and unit-tested in all seven frameworks; not yet exercised in a composed flow
- HTML tag: <span>
- CSS class: .guatemala-codigo-unico-de-identificacion-view
- Interactive: no
ARIA
- No ARIA. A plain
<span> cannot be named: aria-label is prohibited on it, and most screen readers drop it. A visible caption names the value, or the optional label renders as hidden text
Keyboard
Props
value: string (default: "") — the identifier to display label: string (optional) — hidden text naming the value, in a .screen-reader-span. Leave it out when a visible caption names the value ...restProps: any additional HTML attributes spread onto the root