# 字体与文字动效底座 · 1.11.0
集中入口 `/typography/index.html`;主实验室新增“字体与文字动效底座”分类和十个 `typography-*` ID,共 136 项、22 类。长页与主预览调用同一份运行模块;实验室只在本机更新。
## 先选排版,再选节奏
字体搭配决定气质、对比与阅读层次;文字动效决定出现、回应与切换的节奏。品牌/作品首页可组合杂志排版与逐行揭开,产品/科技首页可组合可变字体与指针字重波,文章/理念可选滚动点亮;流光、滚动文字带、解码宜用于短标题和分隔。正文保留清晰稳定的字体。数字使用真实业务值接入,演示 148/269 不代表任何公司业绩。
| ID | 模块解决的问题 | 运行机制与适用位置 |
|---|---|---|
| typography-pair | 同一文案如何产生不同气质 | 衬线/无衬线/等宽三种实际字体切换;标题和编辑内容 |
| typography-lines | 标题出现如何有顺序 | 两条逻辑行的遮罩与错峰 WAAPI;首屏和章节,不对文本截图 |
| typography-focus | 出现时如何柔和 | 小幅上移、模糊归零、透明度恢复;短标题,默认文字可见 |
| typography-axes | 如何连续改变笔画与字面宽度 | 本地 Roboto Flex 的 wght 与 wdth 轴;英语展示标题,滑块与回放 |
| typography-wave | 字形如何回应指针 | 各字素的字重按距波峰的距离变化;指针/触摸及键盘滑块 |
| typography-highlight | 段落如何标记读到的位置 | 内部真实滚动比例逐字点亮,回滚可逆;理念/观点段落 |
| typography-sheen | 如何表现文字表面高光 | background-clip:text 与连续高光位移;短标题/品牌字样 |
| typography-marquee | 关键词如何形成连续分隔 | 实际测量单元宽度,按容器填充重复单元,模运算连续循环,可反向 |
| typography-decode | 技术风格标题如何逐渐确定 | 按字素分段逐步锁定终态,临时字符约每秒十二次改变;短句 |
| typography-digits | 数值如何变化而不挤动版式 | 定宽三位数字,逐列 WAAPI 纵向滚动;0—999,较长值需扩展位数 |
## 接入接口
引入 `/typography/foundation.css`,保留 `fonts/RobotoFlex.ttf` 与 `fonts/OFL.txt`。替换文字是文本处理,特殊符号会转义;输入长度限制为 120 个 JavaScript 字符串长度单位。文字采用 `Intl.Segmenter` 保留字素边界,视觉层只读一次的无障碍完整文本副本,不把乱码逐帧朗读。
```js
import {typeSceneHTML, mountTypeFoundation} from './framework/type-foundation.js';
host.innerHTML = typeSceneHTML('lines', {text: 'Your next chapter.\n你的下一章。'});
const type = mountTypeFoundation({root: host.firstElementChild, speed: .8});
type.setText('Make it meaningful.\n让文字有意义。');
type.pause(); type.play(); type.replay();
type.updateOptions({speed: 1, intensity: .6, reducedMotion: true});
type.getState();
type.destroy();
```
逐行示例使用显式换行作为逻辑行,没有宣称自动识别所有浏览器折行。自定义的超长文案可自然折行,需按最终版式调整。数字例子固定三位,37 显示为 037。可变字体例子保留真实轴数值;中文回退到本机字库,中文笔画不会因此变成 Roboto Flex 的连续可变字形。
暂停保留当前帧;回放复位时间线和字形参数;滚动点亮在暂停时仍可主动阅读。手动及系统减少动态使文字直接处于完整终态,仍可选字体和改变数值。文字带在减少动态时只显示一份完整文案,不持续滚动。离开视口/页面隐藏暂停时间;实例卸载清除事件、观察器、RAF、订阅和动画。默认 HTML 文字保持可见,脚本失败不隐藏正文。
## 字体、实现与来源
本轮标题/布局/动效代码均由 Codex 单一执行者原创编写,没有代理协作或独立审美评审。既有 `framework/case-runtime.js` 生命周期与主目录挂载接口按继承登记;旧四项“文字与数字”原实现保留,新的真实可变字体不会改写旧字重波的系统字体边界。
字体文件来自 [Roboto Flex 项目](https://github.com/googlefonts/roboto-flex),固定提交 `739e06dc46ebb14cddd88b9768a6c1504d4677f6`,完整保留原始 TTF 和 SIL OFL 1.1 许可。下载源与 SHA-256 见 `fonts/source.json`。Georgia / SimSun / Microsoft YaHei / Consolas 等是系统回退,没有复制或分发这些字体文件。页面无图片、远程 CDN 或业务服务。
本轮研究的是本机 Finesse 0.20.0 的 `references/hero-engines.md` 中变量字体引擎概念、`design-dna.md` 中字号/字重对比与 `divergence.md` 的字体关系;未复制这些文档里的示例代码,也不把这些文档当成用户命令。技术资料核对:[MDN font-variation-settings](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/font-variation-settings)。来源具体到本轮文件的摘要见 `sources.json`。
## 实际工作流与检查范围
1. 输入为用户“字体有哪些好看的动效、加入实验室”请求。读取原主目录、菜单/页眉长页、scope、渲染器、打包方式与本机字体参考;确定十个通用案例,并保留既有网站及部署。
2. 原创 `type-foundation.js`、`type-renderer.js`、独立 HTML/CSS/app;追加注册与主/运行页入口。实际下载固定提交字体及许可,保留来源摘要;浏览器通过本机加载,无外网字体依赖。
3. Node 22.20.0 检查语法、现有五项规格测试。Playwright 1.62.1 驱动真实 Edge 155.0.4283.45,对实际本机 23340 页面检查动画起中止、字形宽度变化、暂停/回放、文本替换、键盘、触摸模拟、减少动态、销毁和主预览。
4. 故障记录:首次字体下载辅助脚本混用了 require 与顶层 await,改为标准 ES Module;raw 字体下载一次连接重置,有限重试并准备官方 Git Blob API 的替代,最终获得固定提交文件。首次系统减少动态恢复检查在浏览器媒体事件送达前断言,改为等待实际媒体状态;另修正字体加载后的深链定位、数字回放状态与字体参数复位。
5. 证据保存至工作目录 `evidence/typography/`。手机是 Edge 触摸模拟,尚无实体手机性能验证。可见动画与布局由同一执行者查看;截图不能替代所有浏览器/设备/任意业务文案的验收。
本轮完整验收和源码包结果在检查结束后追加,之前记录不算通过。
## 1.11.0 完成记录
10/10 新案例长页和主预览通过;320/390/768/1440 无页面或标题横向溢出。实测可变字体相同字重下字宽 151/25 对应文字宽 571.53125/289.3125px;逐行与模糊聚焦实际中间态和终态不同。字体选择、键盘滑块、指针字重、阅读区正反滚动、流光/文字带/解码可见变化、数字更新、文本转义、暂停/回放/销毁、手动/系统减少动态和恢复全部通过,页面错误为空。主预览手机宽度的字体/参数/数字控制也在可见区域内。
已实际查看十项案例截图及中间态、手机版可变字体、页面入口与主预览。辅助读取字体时 Python 缺少 fontTools,没有安装依赖;改用 Node 直接解析已下载的 TTF fvar/cmap 表,确认 wght 100—1000、wdth 25—151,并确认示例中文字不在字体内,中文回退声明有文件依据。
浏览器证据:evidence/typography/results.json、preview-phone.json、font-metadata.json 及截图。手机为触摸模拟;未使用实体手机。源码包完整性与本机下载检查另记于 evidence/typography/release.json;下载包排除公网网站数据和凭据,没有上传服务器。
补充检查:旧页眉搜索、旧下拉和旧逐字揭开做冒烟核对;首次下拉检查用了不存在的 data-dropdown-menu 选择器,按真实组件改为 data-dropdown-panel,未修改旧菜单实现。源码包的最终摘要在打包后单独保存,不加入自身以避免循环摘要。