Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 1,000,000+ packages pre-installed, including gulp-rtlcss with all npm packages installed. Try it out:

var gulpRtlcss = require("gulp-rtlcss")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

gulp-rtlcss v1.4.1

Gulp plugin that uses RTLCSS to convert LTR CSS to RTL.

gulp-rtlcss

MIT Licence NPM Version Build Status Dependency Status Language grade: JavaScript

Gulp plugin that uses RTLCSS to convert LTR CSS to RTL.

Install

$ npm install --save-dev gulp-rtlcss

Basic Usage

var gulp = require('gulp');
var rtlcss = require('gulp-rtlcss');

gulp.task('default', function () {
    return gulp.src('styles.css')
        .pipe(rtlcss())
        .pipe(gulp.dest('dist'));
});

Configuration

The plugin optionally accepts RTLCSS configuration either as an argument or with a file named .rtlcssrc or .rtlcssrc.json.

See the RTLCSS documentation for more information about accepted configuration.

Example

The below example will result in 2 copies of each stylesheet, one LTR stylesheet and one RTL stylesheet (with "-rtl" appended to the filename before the extension). The example uses autoprefixer, this is just an example of other CSS post-processing being used before rtlcss.

var gulp = require('gulp');
var autoprefixer = require('gulp-autoprefixer');
var rtlcss = require('gulp-rtlcss');
var rename = require('gulp-rename');
var sourcemaps = require('gulp-sourcemaps');

gulp.task('styles', function () {
    return gulp.src(['/styles/*.css'])
        .pipe(sourcemaps.init())
        .pipe(autoprefixer(["last 2 versions", "> 1%"])) // Other post-processing.
        .pipe(gulp.dest('dist')) // Output LTR stylesheets.
        .pipe(rtlcss()) // Convert to RTL.
        .pipe(rename({ suffix: '-rtl' })) // Append "-rtl" to the filename.
        .pipe(sourcemaps.write('dist')) // Output source maps.
        .pipe(gulp.dest('dist')); // Output RTL stylesheets.
});

Change Log

1.4.1 - 2020-03-10

1.4.0 - 2019-06-18

  • Upgrade through2 to 2.0.5.

1.3.0 - 2018-09-17

  • Upgrade to RTLCSS 2.4.0.
  • Upgrade plugin-error to 1.0.1.

1.2.0 - 2018-03-18

  • Upgrade to RTLCSS 2.2.1.

1.1.0 - 2018-01-10

  • Add support for gulp-sourcemaps.
  • Remove gulp-util in favour of plugin-error.

1.0.0 - 2016-02-18

  • #6 Upgrade to RTLCSS 2.

0.1.4 - 2015-01-28

  • #2 Add support for RTLCSS configuration.

Metadata

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free