gulp-css-url-adjuster

⚠️ THIS IS A FORKED REPO The original repository is located here - https://github.com/trentearl/gulp-css-url-adjuster. The reason behind forking it was using gulp-util as dependency which was deprecated at the time of creation and introduced a critical vulnerability (in its dependencies).

Please consider using gulp-rework

https://github.com/sindresorhus/gulp-rework

https://github.com/trentearl/gulp-css-url-adjuster/issues/20#issuecomment-109732884

This package allows gulp to change css urls

css file:

.cool-background {
    background-image: url('coolImage.jpg');
}

var urlAdjuster = require('gulp-css-url-adjuster');

gulp.src('style.css').
  pipe(urlAdjuster({
    prepend: '/image_directory/',
    append: '?version=1',
  }))
  .pipe(gulp.dest('modifiedStyle.css'));

.cool-background {
    background-image: url('/image_directory/coolImage.jpg?version=1');
}

only adjust relative paths:

.cool-background {
    background-image: url('coolImage.jpg');
}

.neato-background {
    background-image: url('/images/neatoImage.jpg');
}

gulp.src('style.css').
  pipe(urlAdjuster({
    prependRelative: '/image_directory/',
  }))
  .pipe(gulp.dest('modifiedStyle.css'));

.cool-background {
    background-image: url('/image_directory/coolImage.jpg');
}

.neato-background {
    background-image: url('/images/neatoImage.jpg');
}

or replace path to another:

.cool-background {
    background-image: url('/old/path/coolImage.jpg');
}

.neato-background {
    background-image: url('/old/path/images/neatoImage.jpg');
}

gulp.src('style.css').
  pipe(urlAdjuster({
    replace:  ['/old/path','/brand/new'],
  }))
  .pipe(gulp.dest('modifiedStyle.css'));

.cool-background {
    background-image: url('/brand/new/coolImage.jpg');
}

.neato-background {
    background-image: url('/brand/new/images/neatoImage.jpg');
}