Un modulo per compilare SASS al volo e/o salvarlo in file CSS usando node-sass

L’obiettivo di questo progetto è duplice:

  1. Fornire una libreria che possa compilare i file SASS al caricamento della pagina quando si usa NODE_ENV=development al fine di ridurre il tempo di sviluppo (on-the-fly)
  2. Abilitare la compilazione e il salvataggio dei file SASS in file CSS su tutti gli altri ambienti quando, per es, l’applicazione si avvia o con uno script npm

Indice

  • Requisiti
  • Installazione
  • Esempio Usage
  • Usage
  • API
  • Release Notes
  • Maintainer

Requirements

This module is tested with Node.js >= 10. Potrebbe funzionare con Node.js <= 9, ma non è testato.

Installa

npm install --save compile-sass

Esempio d’uso

Questi sono un paio di esempi di come puoi usarlo in un’applicazione reale:

  • Setup: Node.js / TypeScript
  • Configurazione: Node.js / TypeScript
  • Integrazione nell’applicazione: Node.js / TypeScript

Uso

Per la compilazione al volo

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

Fate attenzione al compileSass.setup che differisce dalla variazione TypeScript!

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

Con opzioni

TypeScript
CommonJS

Fate attenzione al compileSass.setup che differisce dalla variazione TypeScript!

Opzioni

Per compilare e salvare come file CSS statico

API

compileSass()

Ritorna il SASS compilato come una stringa.

compileSassAndSave()

Compila il file SASS dato e lo salva nella directory data.

compileSassAndSaveMultiple()

Compila più file SASS definiti nell’opzione “files”. Devono essere tutti situati nella directory definita nell’opzione “sassPath”. I file CSS saranno salvati nella directory definita nell’opzione “cssPath”.

setupCleanupOnExit()

Elimina la directory passata quando l’applicazione viene chiusa. L’idea è quella di passare la directory dove si trovano i file CSS compilati, in modo che possano essere cancellati quando l’app esce e ricompilati quando l’app parte.

Note di rilascio

1.1.1

  • Aggiornamenti di sicurezza

1.1.0

  • Aggiungi una funzione per risolvere i percorsi passati a @import che iniziano con ~
  • Aggiornamenti di sicurezza
  • Fissa un bug per cui le opzioni node-sass passate durante il setup non erano sempre usate

1.0.5

  • Fix una vulnerabilità critica di sicurezza

1.0.4

  • Aggiornamenti di sicurezza
  • Aggiornamento node-sass
  • Aggiornamento hoek 5 a @hapi/hoek 9

1.0.3

  • Fix the broken 1.0.2 release

1.0.2

  • Aggiornamenti di sicurezza
  • Update node-sass

1.0.1

  • Ottimizza ciò che viene incluso quando il pacchetto viene pubblicato (niente più file di prova!)
  • Fissa un paio di link rotti nel Readme
  • Include LICENSE

1.0.0

  • Completa riscrittura con TypeScript
  • Include tipizzazioni per TypeScript
  • Include test automatici per una migliore stabilità