ant-design/docs/spec/font.zh-CN.md

94 lines
4.9 KiB
Markdown
Raw Normal View History

2016-03-31 14:17:09 +08:00
---
docs: v5 site upgrade (#38328) * build: try to use dumi as doc tool * docs: migrate demo structure to dumi way * refactor: use type export & import * docs: migrate demo previewer to dumi * docs: create empty layout & components * docs: apply custom rehype plugin * docs: create empty extra pages * docs: Add Banner component * chore: move theme tsconfig.json * docs: home page init * docs: migrate header (#37896) * docs: header * docs: update * docs: home init * clean up * test: fix site lint * chore: tsc ignore demo * chore: dumi demo migrate script * chore: cards * docs: home layout * docs: Update locale logic * docs: fix getLink logic * chore: fix ci (#37899) * chore: fix ci * ci: remove check-ts-demo * ci: preview build * test: ignore demo.tsx * chore: update script * test: update snapshot * test: update node and image test * chore: add .surgeignore * docs: layout providers (#37908) * docs: add components sidebar (#37923) * docs: sidebar * docs: update docs title * docs: update design doc * chore: code clean * docs: handle changelog page * docs: add title * docs: add subtitle * docs: active header nav * chore: code clean * docs: overview * chore: code clean * docs: update intl (#37918) * docs: update intl * chore: code clean * docs: update favicons * chore: update testPathIgnorePatterns * chore: code clean * chore: code clean * chore: copy 404.html (#37996) * docs: Home page theme picker * chore: Update migrate script * docs: home page update * docs: theme editor style * docs: theme lang * chore: update migrate.js * docs: fix demo (#38094) * chore: update migrate.js * docs: update md * docs: update demo * test: fix snapshot * chore: move debug to code attr in migrate script * chore: update md Co-authored-by: PeachScript <scdzwyxst@gmail.com> * feat: overview page * feat: Migrate `404` page (#38118) * feat: migrate IconSearch component (#37916) * feat<site/IconSearch>: copy IconDisplay from site to .dumi * feat<site/IconSearch>: change docs of icon * feat<site/IconSearch>: tweak * feat<site/IconSearch>: use useIntl instead of injectIntl * feat<site/IconSearch>: fix ts type error * feat<site/IconSearch>: use intl.formatMessage to render text * docs: Adjust home btn sizw * docs: Update doc * feat: v5 site overview page (#38131) * feat: site * fix: fix * feat: v5 site overview page * fix: fix path * fix: fix * fix: fix * docs: fix margin logic * feat: v5 site change-log page (#38137) * feat: v5 site change-log page (#38162) * docs: site redirect to home pag * docs: theme picker * docs: use react-intl from dumi (#38183) * docs: Theme Picker * docs: update dumi config * docs: home back fix * docs: picker colorful * docs: locale of it * docs: update components desc * docs: site of links * docs: update components list * docs: update desc * feat: Migrate `DemoWrapper` component (#38166) * feat: Migrate `DemoWrapper` component * feat: remove invalid comments and add comment for `key` prop * docs: FloatButton pure panel * chore: update demo * chore: update dumi config * Revert "chore: update demo" This reverts commit 028265d3ba5987df5f13c3e9d42cf76cb1812b2e. * chore: test logic adjust to support cnpm modules * chore: add locale alias * docs: /index to / * docs: add locale redirect head script * chore: adjust compact * docs: fix missing token * feat: compact switch * chore: code clean * docs: update home * docs: fix radius token * docs: hash of it * chore: adjust home page * docs: Add background map * docs: site theme bac logic * docs: avatar * docs: update logo color * docs: home banner * docs: adjust tour size * docs: purepanl update * docs: transfooter * docs: update banner gif * docs: content (#38361) * docs: title & EditButton * docs: content * chore: fix toc * docs: resource page * docs: transform resource data from hast * docs: filename & Resource Card * chore: enable prerender * chore: remove less * docs: toc style * chore: fix lint * docs: fix Layout page * docs: fix CP page * chore: update demos * docs: workaround for export dynamic html * chore: enable demo eslint * docs: table style * fix: header shadow * chore: update snapshot * fix: toc style * docs: add title * docs: Adjust site * feat: helmet * docs: site css * fix: description * feat: toc debug * docs: update config-provider * feat: use colorPanel * fix: colorPanel value * feat: anchor ink ball style * feat: apply theme editor * fix: code block style * chore: update demo * chore: fix lint * chore: code clean * chore: update snapshot * feat: ts2js * chore: description * docs: site ready for ssr includes: - move client render logic to useEffect in site theme - extract antd cssinjs to a single css file like bisheng - workaround to support react@18 pipeableStream for emotion * chore: bump testing lib * docs: font size of title * chore: remove react-sortable-hoc * chore: update snapshot * chore: update script Co-authored-by: PeachScript <scdzwyxst@gmail.com> Co-authored-by: MadCcc <1075746765@qq.com> Co-authored-by: zqran <uuxnet@gmail.com> Co-authored-by: TrickyPi <530257315@qq.com> Co-authored-by: lijianan <574980606@qq.com>
2022-11-09 12:28:04 +08:00
group: 全局样式
2017-12-22 17:49:38 +08:00
order: 3
2018-03-12 13:43:56 +08:00
title: 字体
2016-03-31 14:17:09 +08:00
---
2017-12-25 22:15:35 +08:00
字体是体系化界面设计中最基本的构成之一。
2015-08-04 16:54:08 +08:00
我们的用户通过文本来理解内容和完成工作科学的字体系统将大大提升用户的阅读体验及工作效率。Ant Design 字体方案,是基于「动态秩序」的设计原则,结合了自然对数以及音律的规则得出的,再经过了大量的蚂蚁中后台产品验证之后,推荐给大家。在中后台视觉体系中定义字体系统,我们建议从下面五个方面出发:
2017-03-13 11:42:11 +08:00
2017-12-25 22:15:35 +08:00
1. 字体家族
2018-01-08 19:47:15 +08:00
2. 主字体
3. 字阶与行高
4. 字重
5. 字体颜色
2017-03-13 11:42:11 +08:00
2016-03-14 16:18:06 +08:00
---
2015-08-04 16:54:08 +08:00
## 字体家族
2018-01-12 22:56:13 +08:00
优秀的字体系统首先是要选择合适的字体家族。Ant Design 的字体家族中优先使用系统默认的界面字体,同时提供了一套利于屏显的备用字体库,来维护在不同平台以及浏览器的显示下,字体始终保持良好的易读性和可读性,体现了友好、稳定和专业的特性。
2015-08-04 16:54:08 +08:00
2017-03-13 11:42:11 +08:00
```css
@font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial,
'Noto Sans', sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol',
'Noto Color Emoji';
2017-03-13 11:42:11 +08:00
```
2015-08-04 16:54:08 +08:00
2018-08-04 11:33:35 +08:00
> 参考自 https://www.smashingmagazine.com/2015/11/using-system-ui-fonts-practical-guide/ 和 http://markdotto.com/2018/02/07/github-system-fonts/
2015-08-04 16:54:08 +08:00
2018-08-04 11:33:35 +08:00
另外,在中后台系统中,数字经常需要进行纵向对比展示,我们单独将数字的字体 [font-variant-numeric](https://www.fonts.com/content/learning/fontology/level-3/numbers/proportional-vs-tabular-figures) 设置为 `tabular-nums`,使其为等宽字体。
2017-03-31 13:45:16 +08:00
2018-08-04 11:33:35 +08:00
> 参考 https://stackoverflow.com/questions/32660748/how-to-use-apples-new-san-francisco-font-on-a-webpage#comment78509178_32660790
2017-03-31 13:45:16 +08:00
2017-12-25 22:15:35 +08:00
## 主字体
我们基于电脑显示器阅读距离50 cm以及最佳阅读角度0.3)对 Ant Design 的主字体进行了一次升级,从原先的 12 上升至 14以保证在多数常用显示器上的用户阅读效率最佳。
2018-11-22 22:31:48 +08:00
<div style="text-align:center;margin:40px 0;">
<img width="600" src="https://gw.alipayobjects.com/zos/rmsportal/yriUFbqOPtVniYYiikfb.png">
2017-12-25 22:15:35 +08:00
</div>
## 字阶与行高
2015-08-04 16:54:08 +08:00
2017-12-25 22:15:35 +08:00
字阶和行高决定着一套字体系统的动态与秩序之美。字阶是指一系列有规律的不同尺寸的字体。行高可以理解为一个包裹在字体外面的无形的盒子。
2017-03-13 11:42:11 +08:00
2018-11-22 22:31:48 +08:00
<div style="text-align:center;margin:40px 0;">
<img width="600" src="https://gw.alipayobjects.com/zos/rmsportal/xpykKKFJQorFJltdXkie.png">
2017-12-25 22:15:35 +08:00
</div>
2017-03-13 11:42:11 +08:00
2017-12-25 22:15:35 +08:00
Ant Design 受到 5 音阶以及自然律的启发定义了 10 个不同尺寸的字体以及与之相对应的行高。
2017-03-13 11:42:11 +08:00
2018-11-22 22:31:48 +08:00
<img src="https://gw.alipayobjects.com/zos/rmsportal/iFjgfIBExksqCqGMwUlw.png">
2017-03-13 11:42:11 +08:00
2017-12-25 22:15:35 +08:00
在 Ant Design 的视觉体系中,我们建议的主要字体为 14与之对应的行高为 22。其余的字阶的选择可根据具体情况进行自由的定义。建议在一个系统设计中展示型页面除外字阶的选择尽量控制在 3-5 种之间,保持克制的原则。
2017-03-13 11:42:11 +08:00
2017-12-25 22:15:35 +08:00
## 字重
2017-03-13 11:42:11 +08:00
字重的选择同样基于秩序、稳定、克制的原则。多数情况下,只出现 regular 以及 medium 的两种字体重量,分别对应代码中的 400 和 500。在英文字体加粗的情况下会采用 semibold 的字体重量,对应代码中的 600。
2017-12-25 22:15:35 +08:00
2017-12-26 23:20:28 +08:00
<div class="font-samples">
<div>
<img src="https://gw.alipayobjects.com/zos/rmsportal/orIVrEOZIpjMbqZGiXEi.png" />
2017-12-25 22:15:35 +08:00
</div>
2017-12-26 23:20:28 +08:00
<div>
<img src="https://gw.alipayobjects.com/zos/rmsportal/sasWhUzTGjlZKftukraH.png" />
2017-12-25 22:15:35 +08:00
</div>
2017-12-26 23:20:28 +08:00
<div>
<img src="https://gw.alipayobjects.com/zos/rmsportal/QqxifAZlISrSUwnlonyx.png" />
2017-12-25 22:15:35 +08:00
</div>
</div>
<style>
2017-12-26 23:20:28 +08:00
.font-samples {
display: flex;
2017-12-25 22:15:35 +08:00
}
</style>
2017-03-13 11:42:11 +08:00
## 字体颜色
<ImagePreview>
<img class="preview-img" alt="字体颜色" src="https://gw.alipayobjects.com/mdn/rms_08e378/afts/img/A*PdFFQr2NXyUAAAAAAAAAAAAAARQnAQ">
</ImagePreview>
2017-12-25 22:15:35 +08:00
2018-11-22 22:31:48 +08:00
文本颜色如果和背景颜色太接近就会难以阅读。考虑到无障碍设计的需求,我们参考了 WCAG 的标准,将正文文本、标题和背景色之间保持在了 7:1 以上的 AAA 级对比度。
2017-12-25 22:15:35 +08:00
## 建议
2017-03-13 11:42:11 +08:00
字体系统的构建,是「动态秩序之美」的第一步。在实际的设计中,我们还有三点建议:
2015-08-04 16:54:08 +08:00
2017-12-25 22:15:35 +08:00
1. **建立体系化的设计思路:**在同一个系统的 UI 设计中先建立体系化的设计思路,对主、次、辅助、标题、展示等类别的字体做统一的规划,再落地到具体场景中进行微调。建立体系化的设计思路有助于强化横向字体落地的一致性,提高字体应用的性价比,减少不必要的样式浪费。
1. **少即是多:**在视觉展现上能够用尽量少的样式去实现设计目的。避免毫无意义的使用大量字阶、颜色、字重强调视觉重点或对比关系。
1. **尝试让字体像音符一样跳跃:**在需要拉开差距的时候可以尝试在字阶表中跳跃地选择字体大小,会令字阶之间产生一种微妙的韵律感。