Un module pour compiler SASS à la volée et/ou l’enregistrer dans des fichiers CSS en utilisant node-sass

Le but de ce projet est double :

  1. Fournir une bibliothèque capable de compiler les fichiers SASS au chargement de la page lors de l’utilisation de NODE_ENV=development afin de réduire le temps de développement (à la volée)
  2. Faire en sorte de permettre la compilation et l’enregistrement des fichiers SASS dans des fichiers CSS sur tous les autres environnements lorsque, par exemple, l’application démarre ou avec un script npm

Table des matières

  • Requirements
  • Installation
  • Exemple. Utilisation
  • Utilisation
  • API
  • Notes de mise à jour
  • Mainteneur

Exigences

Ce module est testé avec Node.js >= 10. Il pourrait fonctionner avec Node.js <= 9, mais n’est pas testé.

Install

npm install --save compile-sass

Exemple d’utilisation

Voici quelques exemples de la façon dont vous pouvez l’utiliser dans une application réelle:

  • Setup : Node.js / TypeScript
  • Configuration : Node.js / TypeScript
  • Intégration dans l’application : Node.js / TypeScript

Utilisation

Pour la compilation à la volée

TypeScript
import compileSass from 'compile-sass';
app.use('/css/:cssName', compileSass());
CommunJS

Prêtez attention à la compileSass.setupqui diffère de la variante TypeScript !

const compileSass = require('compile-sass');
app.use('/css/:cssName', compileSass.setup());

Avec options

TypeScript
CommonJS

Prêtez attention à la compileSass.setup qui diffère de la variation TypeScript !

Options

Pour la compilation et l’enregistrement en tant que fichiers CSS statiques

API

compileSass()

Retourne le SASS compilé sous forme de chaîne de caractères.

compileSassAndSave()

Compile le fichier SASS donné et l’enregistre dans le répertoire donné.

compileSassAndSaveMultiple()

Compile plusieurs fichiers SASS définis dans l’option « files ». Ils doivent tous être situés dans le répertoire défini dans l’option « sassPath ». Les fichiers CSS seront enregistrés dans le répertoire défini dans l’option « cssPath ».

setupCleanupOnExit()

Supprime le répertoire passé lorsque l’app est quittée. L’idée est de passer le répertoire où se trouvent vos fichiers CSS compilés, afin qu’ils puissent être supprimés lorsque l’app est quittée et recompilés lorsque l’app démarre.

Notes de version

1.1.1

  • Mises à jour de sécurité

1.1.0

  • Ajout d’une fonctionnalité pour résoudre les chemins passés à @import qui commencent par ~
  • Mises à jour de sécurité
  • Correction d’un bug où les options node-sass passées lors de l’installation n’étaient pas toujours utilisées

1.0.5

  • Corriger une vulnérabilité de sécurité critique

1.0.4

  • Mises à jour de sécurité
  • Mise à jour de node-sass
  • Mise à jour de hoek 5 vers @hapi/hoek 9

1.0.3

  • Fixe la version 1.0.2 cassée

1.0.2

  • Mises à jour de sécurité
  • Mise à jour de node-sass

1.0.1

  • Optimiser ce qui est inclus lorsque le paquet est publié (plus de fichiers de test !)
  • Corriger quelques liens brisés dans le Readme
  • Inclure LICENSE

1.0.0

  • Réécriture complète avec TypeScript
  • Inclure des typages pour TypeScript
  • Inclure des tests automatisés pour une meilleure stabilité

.