For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/llms-full.txt, and this page is available as Markdown at https://rickyshin93.github.io/tao-ui/components/statistic.md.
v0.0.57
  • English
  • Statistic

    Data Display@rockshin/tao-ui

    Highlights numeric values, formatted metrics and elapsed time.

    This native tao-ui component follows the public API of Ant Design 6.7.0. Appearance, theme tokens and Semantic DOM customization belong to tao-ui; configure themes with TaoProvider.

    Numeric strings preserve large values; precision truncates decimal digits. Timer supports countdown/countup and the legacy Countdown alias.

    When to use

    Use a clear title and unit so the value can be understood without surrounding context.

    Examples

    Values and units

    Active users
    12,345
    Completion
    93.5%
    Balance
    $1,842.60
    TSX

    Precision and separators

    Precise string
    12,345,678,901,234,567,890.98
    Custom grouping
    1 234 567,89
    TSX

    Custom formatting and value render

    Storage used
    1.5 GB
    TSX

    Loading state

    Monthly total
    TSX

    Countdown with completion

    Time remaining
    -

    Running

    TSX

    Elapsed time

    Session duration
    -
    TSX

    Regional formatting

    Regional grouping, decimal symbols and digits inherit TaoProvider.locale.numberLocale; set locale="fr-FR" on this component to override it. Explicit separators and custom formatters take precedence. Numeric input keeps canonical ASCII strings and precision while displaying localized digits.

    API

    Statistic

    PropertyDescriptionTypeDefault Value
    localeBCP 47 locale. Defaults to the provider's number locale.string | undefined-