load-font-face.md 1.2 KB
Newer Older
D
DCloud_LXH 已提交
1 2 3 4
## uni.loadFontFace(options) @loadfontface

<!-- UTSAPIJSON.loadFontFace.description -->

D
DCloud_LXH 已提交
5 6
<!-- UTSAPIJSON.loadFontFace.compatibility -->

D
DCloud_LXH 已提交
7 8
<!-- UTSAPIJSON.loadFontFace.param -->

D
DCloud_LXH 已提交
9 10 11
<!-- UTSAPIJSON.loadFontFace.returnValue -->

#### 注意事项
W
wanganxp 已提交
12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28
- app-ios平台加载字体一定是全局生效,不支持通过global属性设置为非全局生效
- family属性指定自定义字体路径时,必须使用`url()`包裹。可能某些平台不包裹也可以生效,但标准规范是包裹,按标准写法才能全端生效。如下:
```uts
uni.loadFontFace({
  global: true,
  family: 'UniFontFamily',
  source: "url('/static/font/uni.ttf')", //需使用url方法包裹。本地字体请放在/static目录下,否则打包时不会把字体文件打进去。也支持网络字体
  success() {
    console.log('global loadFontFace uni.ttf success')
  },
  fail(error) {
    console.warn('global loadFontFace uni.ttf fail', error.errMsg)
  },
})
```

不同平台支持的字体格式不同,另见[css字体](../css/font-family.md)
DCloud-yyl's avatar
DCloud-yyl 已提交
29

D
DCloud_LXH 已提交
30 31 32 33 34 35
<!-- UTSAPIJSON.loadFontFace.example -->

<!-- UTSAPIJSON.loadFontFace.tutorial -->

<!-- UTSAPIJSON.general_type.name -->

DCloud-yyl's avatar
DCloud-yyl 已提交
36
<!-- UTSAPIJSON.general_type.param -->