@ecl/animated-numbers

中文文档
5.4.1发布于 2026/11/10EUPL-1.2ESM + CJS近 30 天下载 2797

ECL 动画数字

中文使用文档

ECL 动画数字组件

npm 软件包 : @ecl/animated-numbers

npm install --save @ecl/animated-numbers

参数

  • 与 背景联系 (boolean) (默认: 假) 显示有色背景
  • "满" "活" (boolean) (默认:虚假) 带背景的全宽显示( 网格内置)
  • "反正颜色" (boolean) (默认:真实) 将颜色应用到对应值
  • "边界" (boolean) (默认: 假) 显示每个项目的边框
  • “ 来源 标签” (字符串)(默认为:")在全球源列表前显示标签
  • "来源" (阵列) (默认: []) 全球源引用矩阵( ECL 链接对象或平面字符串)
    • "链接" (对象):ECL链接对象
      • “ 标签” (字符串)(默认: “ ” ) 链接标签
      • "路径" (字符串)(默认为:") 链接 URL 或者说
    • “ 名称”( 字符串)( 默认 : “ ”) 纯文本源
  • “项目” (阵列) (默认:[]):格式:
    • “ 类别”( 字符串)( 默认: “ ”) 值以上的类别标签
    • "icon"(对象)(默认:-) ECL 图标对象
    • "前缀" (字符串)(默认:") 值前显示的文本
    • “ 前缀 标签” (字符串)(默认: “ ”) 前缀的屏幕阅读器文本
    • "值"(字符串)(默认为:") 要显示的主要数值
    • "后缀" (字符串)(默认:") 文本在数值后显示
    • "后缀 标签"(字符串)(默认:"") 后缀的屏幕阅读器文本
    • “描述” (字符串)(默认: “ ” ) 数值以下的描述
    • “ sources label” (字符串)(默认: “ ”) 标签在单个源列表之前显示; 如果不提供则使用全局源标签
    • "源" (阵列)(默认: []) 单个源引用矩阵( ECL 链接对象或平方字符串)
      • "链接" (对象):ECL链接对象
        • “ 标签” (字符串)(默认: “ ” ) 链接标签
        • "路径" (字符串)(默认为:") 链接 URL 或者说
      • “ 名称”( 字符串)( 默认 : “ ”) 纯文本源
  • "超级" (字符串)(默认为:") 额外类(空格分隔)
  • “外部属性” (阵列) (默认: []) 额外属性
    • 名称 (字符串) 属性名称, 如“ 数据测试 ”
    • 值 (字符串) 属性值, 如 : “ data- test-1 ”

示例:

{% include '@ecl/animated-numbers/animated-numbers.html.twig' with {
  counter_color: false,
  sources_label: 'Sources:',
  sources: [
    {
      link: {
        label: 'Eurostat',
        path: exampleLink,
      },
    },
    {
      link: {
        label: 'DG CNECT',
        path: exampleLink,
      },
    },
    {
      link: {
        label: 'Eurostat',
        path: exampleLink,
      },
    },
  ],
  items: [
    {
      category: 'Revenue',
      icon: {
        name: 'users',
        family: 'phosphor',
      },
      prefix: '',
      value: '213',
      suffix: '€',
      description: 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.',
    },
    {
      category: 'Revenue',
      icon: {
        name: 'suffix-eur',
        family: 'phosphor',
      },
      prefix: 'billion',
      value: '888.2',
      suffix: '€',
      description:
        'Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.',
    },
  ],
} %}

版本与发布记录

@ecl/animated-numbers 共发布 14 个版本,首次发布于 2026/04/30;过去 12 个月发布了 14 个版本。

版本发布日期距今
5.4.1latest2026/11/103 天前
5.4.02026/10/2222 天前
5.3.22026/10/081 个月前
5.3.12026/09/211 个月前
5.3.02026/09/151 个月前
5.2.22026/09/082 个月前

关于 @ecl/animated-numbers 的常见问题

@ecl/animated-numbers 是什么?

ECL 动画数字

如何安装 @ecl/animated-numbers?

在项目目录运行 npm install @ecl/animated-numbers,或使用 pnpm add / yarn add / bun add。

@ecl/animated-numbers 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/ecl__animated-numbers 是否存在。

@ecl/animated-numbers 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@ecl/animated-numbers 可以商用吗?

@ecl/animated-numbers 使用 EUPL-1.2 许可。声明的许可为 EUPL-1.2,请阅读许可原文确认使用条件。以上为概括,不构成法律意见,请以许可原文为准。

@ecl/animated-numbers 的下载量有多少?

根据 npm 官方下载统计,@ecl/animated-numbers 在 2026/10/13 – 2026/11/11 这 30 天内被下载 2,797 次,日均约 93 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@ecl/animated-numbers 还在维护吗?

最新版本 5.4.1 发布于 2026/11/10(3 天前);至今共发布 14 个版本,其中过去 12 个月发布了 14 个;首次发布于 2026/04/30。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。