概览
@citisen/dsh-font
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **只处理写死的尺寸。** 界面缩放只作用于样式表里以 px 写死的文字,刻意不动展示级大字号和装饰性字形尺寸,因此 150% 并不等于整个界面的等比 1.5 倍。 - **正文字号会盖过 `ui-theme` 的字号设置项。** 两者都写 `--dsh-content-font-size`,后写者生效,而本插件在设置变化时总会写。请只用其中一个。 - **字体不会被安装。** 只有浏览器或操作系统能解析到的字体名才会生效;插件不打包也不下载 webfont,因此写错名字只会静默回退到列表末尾的通用字体。 - **逐元素盖章的开销与 DOM 规模成正比。** 缩放扫描对每个元素只测量一次并缓存结果,之后按 DOM 变化增量盖章,因此开销有界——但在超长会话里并非免费。 - **代码字重不能按区域分别设置。** 它一次作用于所有代码区域,覆盖范围是 `pre`、`code` 以及类名里带 `code` 的元素——因此组件自己在代码块里设的字重(语法高亮、加粗的 diff 行)同样会被覆盖。界面字重同理,只是范围相反:只有会继承字重的那部分界面文字跟着变,设计系统写死字重的标签、按钮保持原样。字体族没有的字重浏览器仍会合成,封闭列表和"本机没有这个字面"的提示只是把它挡在选择之外。 - **查询语言是本插件自己的约定,不是 CSS。** 它只存在于这一行的两个字体框里,存储的仍然是合法的 CSS `font-family` 列表加上一个 `font-weight` 数字,所以关掉插件不会有残留。末尾的词算字重还是算名字的一部分,由已加载的字体目录决定,所以本身就以字重词结尾的真实字体族(`Book Antiqua`、`Franklin Gothic Medium`)只有在目录里确实列出了这一整名时才会保持原样——这两个词都在探测列表里,因此正常都能保住;而列表之外的同类名字在拒绝字体权限提示时可能被拆开,用引号可以明确表达"这是名字"。 - **界面字重的平移是固定公式,不是重新设计。** 标题按"出厂字重 +(界面字重 − 400)"平移并封顶在 900,所以界面字重设到 900 时所有阶梯都会撞到同一个上限。 - **输入框不等于设置值。** 存储的是插件对查询的序列化结果(加了引号、字重词落在生效字体族后面);框里显示的是你的文本,只要这一行还在就原样保留。重新加载页面时会用两个存储值重建输入框,所以你删掉的字重词可能又出现,拼写也可能和你写的不一样。 - **设置项只有中英两种文案**,与官方内置的语言对一致。
