Neutrino Font Loader Middleware

NPM version NPM downloads Join Slack

neutrino-middleware-font-loader is Neutrino middleware for loading and importing font files from modules.

Requirements

  • Node.js v6.10+
  • Yarn or npm client
  • Neutrino v6

Installation

neutrino-middleware-font-loader can be installed via the Yarn or npm clients.

Yarn

❯ yarn add neutrino-middleware-font-loader

npm

npm install --save neutrino-middleware-font-loader

Usage

neutrino-middleware-font-loader can be consumed from the Neutrino API, middleware, or presets. Require this package and plug it into Neutrino:

// Using function middleware format
const fonts = require('neutrino-middleware-font-loader');

// Use with default options
neutrino.use(fonts);

// Usage showing default options
neutrino.use(fonts, {
  limit: '10000',
  woff: {},
  ttf: {},
  eot: {}
});
// Using object or array middleware format

// Use with default options
module.exports = {
  use: ['neutrino-middleware-font-loader']
};

// Usage showing default options
module.exports = {
  use: [
    ['neutrino-middleware-font-loader', {
      limit: '10000',
      woff: {},
      ttf: {},
      eot: {}
    }]
  ]
};
  • limit: Return a Data URL if the file is smaller than a byte limit.
  • woff: Set options for the url-loader used when loading woff files.
  • tff: Set options for the url-loader used when loading ttf files.
  • eot: Set options for the file-loader used when loading eot files.

Customization

neutrino-middleware-font-loader creates some conventions to make overriding the configuration easier once you are ready to make changes.

Rules

The following is a list of rules and their identifiers which can be overridden:

Name Description Environments
woff Allows importing WOFF font files from modules. Contains a single loader named url. all
ttf Allows importing TTF font files from modules. Contains a single loader named url. all
eot Allows importing EOT font files from modules. Contains a single loader named file. all

Contributing

This middleware is part of the neutrino-dev repository, a monorepo containing all resources for developing Neutrino and its core presets and middleware. Follow the contributing guide for details.

results matching ""

    No results matching ""