Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
uni-app
提交
d4eab49c
U
uni-app
项目概览
DCloud
/
uni-app
通知
702
Star
38703
Fork
3642
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
7
列表
看板
标记
里程碑
合并请求
1
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
uni-app
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
7
Issue
7
列表
看板
标记
里程碑
合并请求
1
合并请求
1
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
d4eab49c
编写于
11月 17, 2019
作者:
W
wanganxp
提交者:
GitHub
11月 17, 2019
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Update font.md
上级
c9b07644
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
53 addition
and
47 deletion
+53
-47
docs/api/ui/font.md
docs/api/ui/font.md
+53
-47
未找到文件。
docs/api/ui/font.md
浏览文件 @
d4eab49c
### uni.loadFontFace(Object object)
动态加载网络字体。文件地址需为下载类型。
注意:
1.
引入中文字体,体积过大时会发生错误,建议抽离出部分中文,减少体积,或者用图片替代
2.
字体链接必须是https。
3.
字体链接必须是同源下的,或开启了cors支持,微信小程序的域名是servicewechat.com
4.
canvas等原生组件不支持使用接口添加的字体
5.
工具里提示 Faild to load font可以忽略
**平台差异说明**
|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序|
|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
|1.9.0+
[
自定义组件编译模式
](
https://ask.dcloud.net.cn/article/35843
)
|x|基础库 2.1.0+|x|x|x|x|
**参数说明**
|属性|类型|默认值|必填|说明|
|:-|:-|:-|:-|:-|
|family|String||是|定义的字体名称|
|source|String||是|字体资源的地址。建议格式为 TTF 和 WOFF,WOFF2 在低版本的iOS上会不兼容。|
|desc|Object||否|可选的字体描述符|
|success|Function||否|接口调用成功的回调函数|
|fail|Function||否|接口调用失败的回调函数|
|complete|Function||否|接口调用结束的回调函数(调用成功、失败都会执行)|
**Object.desc 的结构**
|属性|类型|默认值|必填|说明|
|:-|:-|:-|:-|:-|
|style|String|normal|否|字体样式,可选值为 normal / italic / oblique|
|weight|String|normal|否|字体粗细,可选值为 normal / bold / 100 / 200../ 900|
|variant|String|normal|否|设置小型大写字母的字体显示文本,可选值为 normal / small-caps / inherit|
**代码示例**
```
javascript
uni
.
loadFontFace
({
family
:
'
Bitstream Vera Serif Bold
'
,
source
:
'
url("https://sungd.github.io/Pacifico.ttf")
'
,
success
()
{
console
.
log
(
'
success
'
)
}
})
```
动态加载字体。
注意:
1.
引入中文字体,体积过大时会发生错误,建议抽离出部分中文,减少体积,或者用图片替代
2.
微信小程序端只支持网络字体,字体链接必须是https。App支持网络或本地的字体。
3.
微信小程序端字体链接必须是同源下的,或开启了cors支持,微信小程序的域名是servicewechat.com
4.
canvas等原生组件不支持使用接口添加的字体
5.
微信工具里提示 Faild to load font可以忽略
**平台差异说明**
|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序|
|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
|1.9.0+|x|基础库 2.1.0+|x|x|x|x|
App端非自定义组件模式不支持此API。
**参数说明**
|属性|类型|默认值|必填|说明|
|:-|:-|:-|:-|:-|
|family|String||是|定义的字体名称|
|source|String||是|字体资源的地址。建议格式为 TTF 和 WOFF,WOFF2 在低版本的iOS上会不兼容。|
|desc|Object||否|可选的字体描述符|
|success|Function||否|接口调用成功的回调函数|
|fail|Function||否|接口调用失败的回调函数|
|complete|Function||否|接口调用结束的回调函数(调用成功、失败都会执行)|
**Object.desc 的结构**
|属性|类型|默认值|必填|说明|
|:-|:-|:-|:-|:-|
|style|String|normal|否|字体样式,可选值为 normal / italic / oblique|
|weight|String|normal|否|字体粗细,可选值为 normal / bold / 100 / 200../ 900|
|variant|String|normal|否|设置小型大写字母的字体显示文本,可选值为 normal / small-caps / inherit|
**代码示例**
```
javascript
uni
.
loadFontFace
({
family
:
'
Bitstream Vera Serif Bold
'
,
source
:
'
url("https://sungd.github.io/Pacifico.ttf")
'
,
success
()
{
console
.
log
(
'
success
'
)
}
})
```
**Tips**
插件市场有加载字体的例子:
[
https://ext.dcloud.net.cn/plugin?id=954
](
https://ext.dcloud.net.cn/plugin?id=954
)
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录