연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.
chinese_font_library
chinese_font_library 意在优化中文字体的跨平台渲染,目前支持:
Sponsor
本项目由 庞征博引 赞助:把复杂主题拆成一篇篇 5–10 分钟的阅读,边读边问,按自己的节奏慢慢学懂。
Requirements
chinese_font_library
Flutter
Dart
1.3.0
>=3.41.0
>=3.11.0
1.2.0
>=3.22.0
>=2.19.0
Flutter 3.41 起,框架会自动把 TextStyle.fontWeight 映射到可变字体的 wght 轴,
本包也随之改用 FontWeight.value,因此 FontWeight(550) 这类非整百字重不再被向下取整。
Install
dependencies:
chinese_font_library: ^1.3.0
Features
多字重的渲染
Flutter 使用的系统默认字体多为西文字体,因此不同平台下的中文字体通常渲染为 normal 字重或 bold 字重,且 bold 字重为计算后得到的字重,并非原生 bold 字重,严重影响观感。
解决方案为使用 .useSystemChineseFont() 修改已有的 textStyle:
Text (
'你好世界 hello world' ,
style: const TextStyle (fontWeight: FontWeight .w100).useSystemChineseFont (),
)
或者使用 .useSystemChineseFont() 修改已有的 textTheme:
return MaterialApp (
theme: ThemeData (
textTheme: yourCustomTextTheme.useSystemChineseFont (Brightness .light),
),
);
也可以使用 .useSystemChineseFont() 修改已有的 themeData:
return MaterialApp (
theme: yourCustomThemeData.useSystemChineseFont (Brightness .light),
);
动态加载字体
如果您不满足于系统内置的中文字体,想使用自己精选的中文字体,而中文字体通常体积较大,放在安装包中并非最佳选择。
解决方案为通过网络动态加载字体,仅需下载一次:
DynamicFont .url (
fontFamily: 'CustomFontFromWeb' ,
url:
'https://raw.githubusercontent.com/LastMonopoly/chinese_font_library/master/example/assets/SmileySans-Oblique.ttf' ,
).load ();
也支持从 asset 与本地文件加载:
DynamicFont .asset (fontFamily: 'CustomFont' , key: 'assets/MyFont.ttf' ).load ();
DynamicFont .file (fontFamily: 'CustomFont' , filepath: '/path/to/MyFont.ttf' ).load ();
Results
Roadmap
如有任何意见或建议,请在 Github 上联系我。(❔ 表示尚未在真机上验证)
iOS
华为 鸿蒙
小米 miui
macOS
Windows
Web html
荣耀
Vivo
Oppo
Linux
✔️
✔️
✔️
✔️
✔️
✔️
✔️
✔️
✔️
❔
Reference
Flutter 小技巧之玩转字体渲染和问题修复
Contributions
LiTang0908