Datatype前端集成教程:Next.js、Astro、Vite等6种框架一次配置全搞定
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 是什么:一行文本变成一张图
传统做法要引入 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)——适合季度指标、多类别对比:
迷你折线图(Sparkline)——适合趋势、监控面板:
饼图(Pie)——单值百分比,从空圆到满圆:
三者放进数据表格,就是一个零图表库的迷你 dashboard:
常见问题排查清单
| 现象 | 原因 | 解决办法 |
|---|---|---|
显示 {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>
更多资源
- 官方集成指南(含 Markdown 插件、React 组件等进阶写法):docs/integrations.html
- 可变字体文件:fonts/variable/
- 15 个静态字重实例(WOFF2):fonts/webfonts/
- 字体源码与构建脚本:sources/,可用
make build从 sources/glyphs/ 的图形定义重新构建 - 开发预览服务器:
make dev启动后访问http://localhost:8080(见 dev/server.py)
Datatype 采用 SIL Open Font License 1.1 开源协议(见 OFL.txt),可自由用于商业项目。现在把 woff2 拖进你的项目,三行 CSS 就能让文本"活"成图表。




