NV Elements Catalog Starters Repo System Themes About Getting Started Changelog Metrics Support Accessibility Contributions Requests Migration Integrations Installation MCP CLI Lint Angular Bundles Extensions Golang Hugo Import Maps Lit NextJS Nuxt Preact React SolidJS Svelte TypeScript Vue Foundations Typography Iconography Themes Design Tokens Size & Space Objects Interactions Support Status Color Animation Fonts Layers Custom Layout Horizontal Vertical Grid Popovers i18n Visualization View Transitions Elements Accordion Alert Avatar Badge Breadcrumb Button Button Group Card Chat Message Checkbox Color Combobox Copy Button Datagrid Integrations Column Action Column Alignment Column Fixed Column width Container Card Display Settings Footer Heatmap Keynav Multi Select Pagination Panel Detail Panel Grid Performance Placeholder Row Action Row Groups Row Sort Scroll Height Single Select Stripe Date Datetime Dialog Divider Dot Drawer Dropdown Dropdown Group Dropzone File Format Datetime Format Number Format Relative Time Forms Validation Actions Control Icon Icon Button Input Input Group Logo Menu Month Notification Page Page Header Page Loader Pagination Panel Progressive Filter Chip Progress Bar Progress Ring Password Preferences Input Pulse Radio Range Resize Handle Search Select Skeleton Sort Button Sparkline Star Rating Steps Switch Tabs Tag Textarea Time Toast Toggletip Toolbar Tooltip Tree Week Patterns Authentication Browse Dashboard Editor Empty States Heatmap Keyboard Shortcut Logging Media Navigation Onboarding Panel Responsive Search Subheader Trend Code Codeblock Monaco Input Diff Input Editor Diff Editor Problems Markdown Markdown CSS Utility Labs Responsive Layout Viewport Container Patterns Forms API Design Properties & Attributes Slots Registration CustomEvents Stateless Composition Styles Packaging Glossary Logs Internal Guidelines Agent Harness Documentation Examples TypeScript Testing Unit Testing Accessibility Testing Lighthouse Testing SSR Testing Visual Testing Troubleshooting Component Creation Internal Examples All Examples

Format Number

beta:  0.1.1 Coverage: unknown Bundle: 10kb Lighthouse: 100 Axe Core Released: 0.0.0
Overview API Examples

A localized number formatter for currencies, percentages, units, and compact notation, backed by Intl.NumberFormat. Provide a currency attribute when formatStyle is currency, and a unit attribute when formatStyle is unit.

1234567.89

Installation
CLI / MCP

Default

Basic decimal formatting with localized grouping separators. Use for inline counts and metrics.

1234567.89

Currency

Currency formatting for monetary values with locale-aware symbols and separators. Use for prices, budgets, and financial totals.

1234.56 1234.56 1234

Percent

Percent formatting for ratios and completion values. Source values should already represent a fraction (such as 0.85 for 85 percent).

0.85 0.126

Unit

Unit formatting for measurements and quantities. Use for distances, storage sizes, or other numeric labels that need a localized unit suffix.

1234.56 2048 22

Notation

Notation presets for scientific, engineering, and compact display. Use compact notation in dashboards or cards where space matters.

1234567 1234567 1234567 1234567

Sign Display

Sign display options for controlling positive and negative indicators. Use 'always' for delta values or 'exceptZero' for change indicators.

42 -42 0 -42

Fraction Digits

Fraction digit control for tuning decimal precision. Use to enforce fixed decimal places in financial or scientific contexts.

1.5 1.567 3

Locale

Explicit locale settings for internationalized number output. Use when the target audience locale differs from the document language or browser default.

1234.56 1234 1234567.89

Number Attribute

Number attribute input for values supplied by JavaScript or bound data. By default, the component formats text content, which also serves as the SSR fallback, and number wins when both are present.

Release Status

All elements and features go through 3 phases of stability, pre-release, beta and stable.

pre-release
Docs Preview API Documentation Fully Themeable
beta
Robust unit test coverages Passed API Review Passed Designer VQA Review Included in library package
stable
No known outstanding AA WCAG issues No known outstanding performance issues Adapts to different screen/container sizes No breaking API changes for at least 90 days