JS字体加载失败或完毕的检测

摘要:对于自定义字体,如果还没有加载完毕,就让 Unicode 字符显示,有可能会显示乱七八糟的字符,过一段时间后才显示映射后的效果。还有就是开发人员希望知道字体文件加载失败的情况,需要在加载异常的时候上报

一、开门见山

对于自定义字体,如果还没有加载完毕,就让 Unicode 字符显示,有可能会显示乱七八糟的字符,过一段时间后才显示映射后的效果。

这样的体验就不太好。

还有就是开发人员希望知道字体文件加载失败的情况,需要在加载异常的时候上报。

上面这两种场景的实现可以使用浏览器原生的 FontFace API。

具体代码如下:

// 兼容性判断,防止 IE 浏览器下报错
if (window.FontFace) {
    var fontFile = new FontFace('Some Font Name', 'url(someFontUrl.woff2)');

    fontFile.load().then(function () {
        console.log('成功');
    }, function (err) {
        console.log('失败:' + err);
    });
}

我专门做了个体验demo,您可以狠狠地点击这里: FontFace load()加载成功失败demo

可以对输入框中的 URL 地址进行字体加载成功与否的判别。


二、了解 FontFace API

FontFace API 相对于把 CSS @font-face 一些不可控的策略搬到了 JS 中,以便我们可以灵活设置。

其支持的一些 API 属性和 @font-face 规则支持的 CSS 属性是一一对应的。

例如:

font-display

其实,上面列表中的最后 3 个CSS属性大家可能没见过,可以参见这篇文章“ ascent-override descent-override line-gap-override一锅端 ”进行了解。

另外,FontFace 接口还有如下一些只读属性和方法:

FontFace.loaded

返回一个 Promise,自定义字体加载完毕或者失败之后触发。感觉有些鸡肋,有了 load() 方法,这个属性有什么用呢?而且此方法根据我的测试,貌似要执行 load() 才有效。

FontFace.status

返回字体的状态,值可能是后面其中之一: "unloaded" , "loading" , "loaded" 或者 "error" 。

FontFace.load()

触发自定义字体加载,可以是 URL 地址,也可以是字体的 buffer 资源,返回值是个 Promise,成功后返回当前 FontFace 对象。

简单的使用示意:

var fontFile = new FontFace('Some Font Name', 'url(someFontUrl.woff2)');

fontFile.load().then(function (fontface) {
    // 打印值是 'Some Font Name'
    console.log(fontface.family);
});

兼容性

除了个别比较新的属性值,FontFace API 的兼容性如下图所示,浏览器2014年就已经支持。



三、鸣金收兵

看了下,还有个名叫 FontFaceSet 的 API,这个 API 一般和 document.fonts 一起使用,主要对文档里面的自定义字体进行批量的处理

以后遇到相关的需求我再做相关的介绍。

另外,如果想要兼容 IE 浏览器,可以使用传统的 XMLHttpRequest GET 请求模拟,onLoad 之后执行相关的处理,示意:

// 传统实现
var xhr = new XMLHttpRequest();
xhr.open('get', 'someFontUrl.woff2');
xhr.onload = function () {
    console.log('加载成功!');
};
xhr.onerror = function () {
    console.log('加载失败!');
};
xhr.send();
本文地址: https://www.zhangxinxu.com/wordpress/?p=10388


本文内容仅供个人学习、研究或参考使用,不构成任何形式的决策建议、专业指导或法律依据。未经授权,禁止任何单位或个人以商业售卖、虚假宣传、侵权传播等非学习研究目的使用本文内容。如需分享或转载,请保留原文来源信息,不得篡改、删减内容或侵犯相关权益。感谢您的理解与支持!

链接: https://shenqiku.cn/article/FLY_11413