[翻译] Webpack 加载字体(Loading Fonts)

译者:zjruan 日期:2017-07-06

原文传送门(Loading Fonts)

From the blog:
renovate - Keep npm dependencies up-to-date - Interview with Rhys Arkins
Register for Augsburg workshop (early July)
Register for Vienna clinics (late July)

加载字体和加载图片差不多,不过它会带来一些特殊的挑战。怎样知道要支持什么字体格式?如果你想完美的支持所有浏览器,那么你需要考虑4种字体格式。

这个问题可以通过决定一套应该接收一流服务的浏览器和平台来解决。区域的可以用系统字体。

通过 Webpack,你可以用好几种方式解决这个问题。 你仍然可以像图像一样使用 url-loaderfile-loader 。 字体测试模式往往比较复杂,但你必须考虑字体文件相关的查找。

canifont helps you to figure out which font formats you should support. It accepts a .browserslistrc definition and then checks font support of each browser based on the definition.

选择一种格式

如果你排除Opera Mini,那么所有浏览器都支持.woff格式。 新版本.woff2 也已经被现代浏览器广泛支持,不失为一个很好的选择。

使用一种格式,你可以使用与图像类似的设置,并且在使用限制选项时依赖 file-loaderurl-loader

{
  test: /\.woff$/,
  loader: 'url-loader',
  options: {
    limit: 50000,
  },
},

一个更复杂的方法来实现类似的结果,包含 .woff2 和其他字体,将最终得到如下代码:

{
  // Match woff2 in addition to patterns like .woff?v=1.1.1.
  test: /\.(woff|woff2)(\?v=\d+\.\d+\.\d+)?$/,
  loader: 'url-loader',
  options: {
    // Limit at 50k. Above that it emits separate files
    limit: 50000,

    // url-loader sets mimetype if it's passed.
    // Without this it derives it from the file extension
    mimetype: 'application/font-woff',

    // Output below fonts directory
    name: './fonts/[name].[ext]',
  },
},

支持多种格式

如果你想确保网站在最大数量的浏览器上看起来不错,你可以使用 file-loader 并忘记内联。另外,这是一个权衡,因为你得到额外的要求,但也许这是正确的举动。 现在你可以用一个加载器配置结束:

{
  test: /\.(ttf|eot|woff|woff2)$/,
  loader: 'file-loader',
  options: {
    name: 'fonts/[name].[ext]',
  },
},

编写CSS定义的方式很重要。 为了确保你从较新的格式中获益,他们应该在最前面定义。 这样浏览器就可以优先选择它们。

@font-face {
  font-family: 'myfontfamily';
  src: url('./fonts/myfontfile.woff2') format('woff2'),
    url('./fonts/myfontfile.woff') format('woff'),
    url('./fonts/myfontfile.eot') format('embedded-opentype'),
    url('./fonts/myfontfile.ttf') format('truetype');
    /* Add other formats as you see fit */
}

MDN discusses the font-family rule in detail.

操作 file-loader 输出路径和 publicPath

如上所述和在 webpack issue tracker中,* file-loader *允许整形输出。 这样,你就可以在根路径下,将字体放入fonts/,图片放入images/

此外,可以操作publicPath并覆盖加载器的默认定义。 以下示例说明了这些技术:

{
  // Match woff2 in addition to patterns like .woff?v=1.1.1.
  test: /\.woff2?(\?v=\d+\.\d+\.\d+)?$/,
  loader: 'url-loader',
  options: {
    limit: 50000,
    mimetype: 'application/font-woff',

    // Output below the fonts directory
    name: './fonts/[name].[ext]',

    // Tweak publicPath to fix CSS lookups to take
    // the directory into account.
    publicPath: '../',
  },
},

基于SVG生成字体文件

如果您喜欢使用基于SVG的字体,则可以使用webfonts-loader将其捆绑为单个字体文件

▼ Take care with SVGs if you have SVG specific image setup in place already. If you want to process font SVGs differently, set their definitions carefully. The Loader Definitions chapter covers alternatives.

Using Font Awesome

上述想法可以应用于Font Awesome。 它是一个允许你使用CSS类引用的高质量字体图标的集合。

项目中集成Font Awesome字体

要将Font Awesome集成到 book project,先安装:

npm install font-awesome --save

Given Font Awesome没有在它的* package.json *文件中定义main字段,你需要通过一个直接的路径而不是一个包名来指向它。

参考Font Awesome如下:

app/index.js

import 'font-awesome/css/font-awesome.css';  
...

Font Awesome也包括Sass和Less版本,但在你还没配置的情况下,这个定义就足够了。

✪ The import could be cleaned up as import 'font-awesome' by setting up a resolve.alias. The Package Consuming Techniques chapter discusses this idea in detail.

如果你现在运行项目 (npm start),webpack 将会给你一个大大的错误列表:


ERROR in ./~/font-awesome/fonts/fontawesome-webfont.woff2?v=4.7.0
Module parse failed: .../node_modules/font-awesome/fonts/fontawesome-webfont.woff2?v=4.7.0 Unexpected character '' (1:4)
You may need an appropriate loader to handle this file type.
(Source code omitted for this binary file)
 @ ./~/css-loader!./~/font-awesome/css/font-awesome.css 6:479-532
 @ ./~/font-awesome/css/font-awesome.css
 @ ./app/index.js
 @ multi (webpack)-dev-server/client?http://localhost:8080 webpack/hot/only-dev-server react-hot-loader/patch ./app

实现 Webpack 配置

结果不出所料,因为你没有为任何Font Awesome字体配置加载程序,并且webpack不知道如何处理相关文件。 要匹配文件并通过 file-loader 映射,请将下列代码段附加到项目中:

webpack.parts.js

exports.loadFonts = ({ include, exclude, options } = {}) => ({
  module: {
    rules: [
      {
        // Capture eot, ttf, woff, and woff2
        test: /\.(eot|ttf|woff|woff2)(\?v=\d+\.\d+\.\d+)?$/,
        include,
        exclude,

        use: {
          loader: 'file-loader',
          options,
        },
      },
    ],
  },
});

与加载图像想法一样。 此时此刻你会匹配字体文件。 如果你愿意,你还可以将公共的部分重构成一个功能,在多个地共享。

你需要接着上面的主配置:

webpack.config.js

const commonConfig = merge([
  ...
  parts.loadFonts({
    options: {
      name: '[name].[ext]',
    },
  }),
]);

该项目现在应该运行起来了(npm start),并且不报任何错误。

查看Font Awesome的操作,按照如下所示调整应用程序:

app/component.js

export default (text = 'Hello world') => {
  const element = document.createElement('div');
  // element.className = 'pure-button';
  element.className = 'fa fa-hand-spock-o fa-1g';
  element.innerHTML = text;
  return element;
}

如果你构建这个应用(npm run build),你应该可以看到它被处理且 Font Awesome 资源被包含进来。

Hash: e379b2c5a9f46663f367
Version: webpack 2.2.1
Time: 2547ms
        Asset       Size  Chunks                    Chunk Names
  ...font.eot     166 kB          [emitted]
  ...font.ttf     166 kB          [emitted]
...font.woff2    77.2 kB          [emitted]
 ...font.woff      98 kB          [emitted]
  ...font.svg     444 kB          [emitted]  [big]
     logo.png      77 kB          [emitted]
       app.js    4.22 kB       0  [emitted]         app
      app.css    7.72 kB       0  [emitted]         app
   index.html  227 bytes          [emitted]
   [0] ./app/component.js 185 bytes {0} [built]
   [1] ./~/font-awesome/css/font-awesome.css 41 bytes {0} [built]
   [2] ./app/main.css 41 bytes {0} [built]
...

Font Awesome中包含的SVG文件已被标记为 [big]。 它超出了webpack默认设置的性能预算,该主题将在Minifying 章节中详细讨论。

font-awesome-loader allows more customization. Font Awesome 5 improves the situation further and make it easier to decide what fonts to consume. Font Awesome wiki points to available online services that allow you to select specific fonts from Font Awesome collection.

结论

加载字体与加载其他资源类似。你必须考虑你想要支持的浏览器,基于它来选择你的加载策略。

回顾:

  • 加载字体时,与加载图片技术相同。 您可以选择内联小字体,而较大的字体作为分离的资源。
  • 如果您决定仅为现代浏览器提供一流的支持,您只能选择一种或两种字体格式,并让较旧的浏览器使用系统级字体。
  • 使用较大的字体集合时(例如Font Awesome),可能会有问题,特别是要避免加载其他规则。 问题取决于问题的packages,并且可以在一定程度上用webpack解决。
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,254评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,875评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,682评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,896评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,015评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,152评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,208评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,962评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,388评论 1 304
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,700评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,867评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,551评论 4 335
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,186评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,901评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,142评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,689评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,757评论 2 351

推荐阅读更多精彩内容

  • 无意中看到zhangwnag大佬分享的webpack教程感觉受益匪浅,特此分享以备自己日后查看,也希望更多的人看到...
    小小字符阅读 8,153评论 7 35
  • GitChat技术杂谈 前言 本文较长,为了节省你的阅读时间,在文前列写作思路如下: 什么是 webpack,它要...
    萧玄辞阅读 12,682评论 7 110
  • 版权声明:本文为博主原创文章,未经博主允许不得转载。 webpack介绍和使用 一、webpack介绍 1、由来 ...
    it筱竹阅读 11,080评论 0 21
  • 这是画得最快的一张了,褶皱还可以
    VictoryH阅读 243评论 1 1
  • 如果你可以停在一生中的某一刻,你想要停在什么时候?
    邺心阅读 174评论 0 0