JSPM

postcss-urlrebase

1.0.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 66236
  • Score
    100M100P100Q158694F
  • License MIT

PostCSS plugin Rebase URLs to a given root URL.

Package Exports

  • postcss-urlrebase
  • postcss-urlrebase/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (postcss-urlrebase) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

PostCSS URL rebase plugin

PostCSS plugin for rebasing URLs to a given root URL.

.foo {
  /* Input example */
  background: url("images/test.jpg");
  mask: url("/images/layout/shape.svg");
}
.foo {
  /* Output example */
  background: url("https://example.com/images/test.jpg");
  mask: url("/images/layout/shape.svg");
}

Usage

Step 1: Install plugin:

npm install --save-dev postcss postcss-urlrebase

Step 2: Check you project for existed PostCSS config: postcss.config.js in the project root, "postcss" section in package.json or postcss in bundle config.

If you do not use PostCSS, add it according to official docs and set this plugin in settings.

Step 3: Add the plugin to plugins list:

module.exports = {
  plugins: [
+   require('postcss-urlrebase')({ rootUrl: "https://example.com/wp/wp-themes/example/" },
    require('autoprefixer')
  ]
}

Plugin options

rootUrl (required)

The root URL to which the existing URLs should be based to.

skipHostRelativeUrls (optional (default: true))

Should already host-relative URLs (as /images/test.jpg (URL starts with /)) be skipped?