Datatype前端集成教程:Next.js、Astro、Vite等6种框架一次配置全搞定

原创2026-10-11 13:40:131,419 阅读

Datatype前端集成教程:Next.js、Astro、Vite等6种框架一次配置全搞定

Datatype 是一款能把纯文本直接渲染成图表的开源可变字体(variable font)。在网页正文里写 {l:20,45,60,55,80,95},浏览器就会自动把它显示成一条迷你折线图——全程零 JavaScript,只靠 OpenType 连字替换实现。本教程带你完成 Datatype 前端集成:从字体文件放置位置到 CSS 加载,覆盖 Next.js、Astro、Vite、SvelteKit、Eleventy 和原生 HTML 共 6 种前端框架,一次配置全搞定。

Datatype 可变字体宣传图,展示文本转图表效果

Datatype 是什么:一行文本变成一张图

传统做法要引入 ECharts、Chart.js 等图表库,动辄几十 KB 的 JavaScript。而 Datatype 的思路完全不同:图表就是文字,数据表达式由字体里的连字字形画出来。

它支持三种图表语法:

语法 图表类型 示例
{b:...} 柱状图,最多 20 个值 {b:15,45,80,30,60,90}
{l:...} 迷你折线图,最多 20 个点 {l:10,40,25,70,50,90}
{p:...} 饼图/百分比圆环 {p:75}

数值范围都是 0–100。字体还带有两条可变轴:wght(字重 100–900)和 wdth(宽度 50–150),可以像调字号一样调"图表粗细和疏密"。

通用集成三步法:所有框架都适用

无论用哪个框架,核心都是同样的三步,后面各框架章节只是"字体文件放哪里"的区别:

第 1 步:拿到字体文件。 推荐直接使用仓库中已构建好的 WOFF2 可变字体:fonts/variable/ 目录下的 Datatype[wdth,wght].woff2(仅约 73 KB,包含全部 15 个字重/宽度实例)。

第 2 步:声明 @font-face 加载字体:

@font-face {
  font-family: 'Datatype';
  src: url('/fonts/Datatype.woff2') format('woff2');
  font-weight: 100 900;
  font-stretch: 50% 150%;
  font-display: swap;
}

第 3 步:开启连字,这是图表渲染的关键开关:

.chart {
  font-family: 'Datatype', sans-serif;
  font-feature-settings: 'liga' 1, 'calt' 1;
  font-variant-ligatures: common-ligatures contextual;
  letter-spacing: 0; /* 字距会破坏字形对齐,必须设为 0 */
}

之后在 HTML 里这样写就能出图:

<p>本季度销售 <span class="chart">{l:20,45,60,55,80,95}</span> 持续上涨。</p>

完整细节可查阅仓库自带的官方集成指南:docs/integrations.html。

6 种框架的具体配置

Next.js 配置:用 next/font/local 零依赖加载

把 Datatype.woff2 放到项目根目录的 fonts/ 下,在 app/layout.js 中:

import localFont from 'next/font/local'

const datatype = localFont({
  src: './fonts/Datatype.woff2',
  variable: '--font-datatype',
  weight: '100 900',
  display: 'swap',
})

CSS 里直接用变量:

.chart {
  font-family: var(--font-datatype), sans-serif;
  font-feature-settings: 'liga' 1, 'calt' 1;
}

next/font/local 会自动优化字体加载与子集化,是 Next.js 项目推荐方式。

Astro 配置:布局文件里写全局样式

将字体放入 public/fonts/,在 src/layouts/Layout.astro 中:

<style is:global>
  @font-face {
    font-family: 'Datatype';
    src: url('/fonts/Datatype.woff2') format('woff2');
    font-weight: 100 900;
    font-display: swap;
  }
  .chart {
    font-family: 'Datatype', sans-serif;
    font-feature-settings: 'liga' 1, 'calt' 1;
  }
</style>

is:global 保证样式对所有页面生效,Astro 的静态输出也天然适合图表字体这类纯 CSS 方案。

Vite / React / Vue 配置:public 目录 + 全局 CSS

字体放到 public/fonts/(Vite 会原样输出到站点根路径),在入口 CSS(如 src/styles.css)中加入上面"通用三步法"的 @font-face 和 .chart 规则即可。React、Vue 项目无需任何额外依赖。

SvelteKit 配置:static 目录 + app.css

把字体复制到 static/fonts/,在 src/app.css 中声明 @font-face 与 .chart 类,用法与其他框架一致。

Eleventy (11ty) 配置:加一条 passthrough 规则

Eleventy 不会自动拷贝字体文件,在 .eleventy.js 中告诉它:

module.exports = function (eleventyConfig) {
  eleventyConfig.addPassthroughCopy("src/fonts");
};

字体放进 src/fonts/,再按通用方法写 CSS 即可。

原生 HTML / 静态站配置:一个文件全部搞定

不需要构建工具?把 Datatype.woff2 放到 fonts/ 目录,在 <head> 里内联样式:

<style>
  @font-face {
    font-family: 'Datatype';
    src: url('fonts/Datatype.woff2') format('woff2');
    font-weight: 100 900;
    font-stretch: 50% 150%;
  }
  .chart {
    font-family: 'Datatype', sans-serif;
    font-feature-settings: 'liga' 1, 'calt' 1;
    letter-spacing: 0;
  }
</style>

这就是 README.md 中 Quick Start 的最小示例,可直接复制使用。

调一调可变轴:图表也能"变粗变宽"

Datatype 的可变轴让同一组数据可以呈现不同"密度":

.chart-bold   { font-weight: 600; font-stretch: 75%; }  /* 密集粗线条,适合仪表盘 */
.chart-light  { font-weight: 300; font-stretch: 150%; }  /* 稀疏细线条,适合正文点缀 */

也可以用 font-variation-settings: 'wdth' 75, 'wght' 600; 精确指定。⚠️ 注意 Safari 的坑:若使用 font-variation-settings,必须把所有轴写在同一条声明里,Safari 不会合并分开写的轴。

三种图表的实际效果

柱状图(Bar)——适合季度指标、多类别对比:

Datatype 柱状图可变字体渲染效果展示

迷你折线图(Sparkline)——适合趋势、监控面板:

Datatype 折线图可变字体渲染效果展示

饼图(Pie)——单值百分比,从空圆到满圆:

Datatype 饼图可变字体渲染效果展示

三者放进数据表格,就是一个零图表库的迷你 dashboard:

Datatype 字体在股票行情表格中的前端集成示例

常见问题排查清单

现象 原因 解决办法
显示 {l:20,45} 原始文本 连字未开启 确认 .chart 上写了 font-feature-settings: 'liga' 1, 'calt' 1;
图表元素之间有缝隙 字距干扰对齐 设置 letter-spacing: 0;
Safari 中可变轴无效 轴声明被拆分 用 font-weight + font-stretch,或把全部轴合并到一条 font-variation-settings
字体没加载 路径写错 打开 DevTools Network 面板检查 woff2 请求是否 404

另外建议在 <head> 中预加载字体提升体验:

<link rel="preload" href="/fonts/Datatype.woff2" as="font" type="font/woff2" crossorigin>

更多资源

Datatype 采用 SIL Open Font License 1.1 开源协议(见 OFL.txt),可自由用于商业项目。现在把 woff2 拖进你的项目,三行 CSS 就能让文本"活"成图表。

登录后查看全文
datatype