wandi-gulp-styles

gulp-styles

Tâche gulp pour compiler les styles Sass.

Installation

npm install --save-dev wandi-gulp-styles

Utilisation

Paramètres par défaut :

// gulpfile.babel.js

import styles from 'wandi-gulp-styles'

const compile = styles()

export {
    compile
}

Paramètres custom (voir ci-dessous pour la liste complète des paramètres) :

// gulpfile.babel.js

import styles from gulp-styles

const compile = styles({
    src: 'path/to/scss/global.scss',
    dest: 'path/to/dest'
})

export {
    compile
}

Paramètres

src

Voir le paramètre globs de gulp.src.

Valeur par défaut : 'assets/scss/**/*.scss'

dest

Voir le paramètre path de gulp.dest.

Valeur par défaut : 'web/css'

autoprefixerOptions

Un objet de configuration passé à Autoprefixer. Voir les options d'Autoprefixer.

Valeur par défaut :

{
    browsers: [
        'last 2 versions',
        'Firefox ESR',
        'IE >= 9',
        'BlackBerry >= 7',
        'Android >= 2'
    ],
    cascade: false,
    remove: false
}

pxToRemOptions

Un objet de configuration passé à postcss-pxtorem. Voir les options de postcss-pxtorem.

Valeur par défaut :

{
    root_value: 16
}

cssnanoOptions

Un objet de configuration passé à cssnano. Voir les optimisations de cssnano.

Valeur par défaut :

{
    autoprefixer: false,
    discardUnused: false,
    discardComments: { removeAll: true },
    zindex: false,
    reduceIdents: false,
    mergeIdents: false
}

sassOptions

Un objet de configuration passé à node-sass. Voir les options de node-sass.

Valeur par défaut :

{
    outputStyle: "nested"
}

production

Booléen. Valeur par défaut : false

Ce paramètre indique à la tâche si elle doit appliquer tous les traitements nécessaires à optimiser le CSS en sortie. Ces traitements sont les suivants :

• Pas de génération de sourcemaps
• Optimisations de cssnano qui ne sont pas explicitement désactivées (voir la configuration par défaut de cssnano, ou votre configuration)

lint

Booléen. Valeur par défaut : true

Active le linting à l'aide de StyleLint. Lorsque le linting est activé, vous devez avoir un fichier de configuration StyleLint à la racine du projet. Le plus simple est d'extend stylelint-config-wandi.

Le linting arrête l'exécution de la tâche lorsqu'une erreur est levée. Si un avertissement est soulevé, celui-ci s'affiche uniquement en console, sans arrêter l'exécution de la tâche.