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

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

<!-- UTSAPIJSON.loadFontFace.param -->

DCloud-yyl's avatar
DCloud-yyl 已提交
7
#### 注意事项  
W
wanganxp 已提交
8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
- 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 已提交
25

D
DCloud_LXH 已提交
26 27 28 29 30 31 32 33 34 35 36 37
<!-- UTSAPIJSON.loadFontFace.returnValue -->

<!-- UTSAPIJSON.loadFontFace.example -->

<!-- UTSAPIJSON.loadFontFace.compatibility -->

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

<!-- UTSAPIJSON.load-font-face.example -->

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

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