Bibliotecă Node.js gratuită pentru Crearea & Gestionarea Word DOCX din Șabloane

Cum să Instalați Docxtemplater?

Pentru a instala Docxtemplater, poți folosi npm, managerul de pachete pentru JavaScript. Te rugăm să folosești comenzile de mai jos pentru o instalare cu succes.

 npm install --save docxtemplater pizzip

Crearea Documentelor Word prin Șablon în Node.js

Biblioteca open source Docxtemplater facilitează dezvoltatorilor generarea de documente Microsoft Word DOCX utilizând un șablon. Dezvoltatorii pot injecta date dinamice în șablon prin transmiterea unui obiect ce conține perechi cheie‑valoare pentru a înlocui marcatorii cu date reale și crea documentul final. Exemplul următor demonstrează cum dezvoltatorii pot încărca un șablon existent și genera un document Word din el în mediul Node.js.

const fs = require('fs');
const Docxtemplater = require('docxtemplater');

// Load the template
const content = fs.readFileSync('template.docx', 'binary');
const doc = new Docxtemplater(content);

// Set data to fill placeholders
const data = {
  firstName: 'John',
  lastName: 'Doe'
};

// Replace placeholders with actual data
doc.setData(data);

// Render the document
doc.render();

// Save the generated document
const output = fs.writeFileSync('output.docx', doc.getZip().generate({type: 'nodebuffer'}));

console.log('Document generated successfully!');

Adăugarea Funcțiilor Personalizate & Filtrelor în Aplicații Node.js

Funcții Personalizate și Filtre în biblioteca Docxtemplater oferă capabilități avansate pentru manipularea datelor și execuția de operații specifice în șabloane. Ele permit utilizatorilor să extindă funcționalitatea bibliotecii dincolo de înlocuirea simplă a markerilor, permițând generarea dinamică de conținut și procesarea complexă a datelor. Poți defini funcții și filtre personalizate pentru a manipula datele sau a efectua operații specifice în șabloanele tale. Iată un exemplu care arată cum dezvoltatorii pot implementa o funcție personalizată pentru calcularea prețului total al articolelor dintr-un coș de cumpărături și un filtru pentru formatarea valorilor valutare.

const fs = require('fs');
const Docxtemplater = require('docxtemplater');

// Define custom function to calculate total price
function calculateTotal(items) {
  return items.reduce((total, item) => total + item.price * item.quantity, 0);
}

// Define custom filter to format currency
function formatCurrency(value) {
  return '$' + value.toFixed(2); // Format as dollars with 2 decimal places
}

// Load the template
const content = fs.readFileSync('template.docx', 'binary');
const doc = new Docxtemplater(content, {
  parser: {
    // Define custom tag for invoking functions
    getFunction: function(tag) {
      if (tag === 'calculateTotal') {
        return calculateTotal;
      }
    },
    // Define custom tag for applying filters
    getFilter: function(tag) {
      if (tag === 'currency') {
        return formatCurrency;
      }
    }
  }
});

// Set data with shopping cart items
const data = {
  items: [
    { name: 'Product 1', price: 10, quantity: 2 },
    { name: 'Product 2', price: 20, quantity: 1 },
    { name: 'Product 3', price: 15, quantity: 3 }
  ]
};

// Replace placeholders with actual data
doc.setData(data);

// Render the document
doc.render();

// Save the generated document
const output = fs.writeFileSync('output.docx', doc.getZip().generate({ type: 'nodebuffer' }));

console.log('Document generated successfully!');

Suport pentru Formatare Avansată

Biblioteca open source Docxtemplater simplifică procesul de creare și gestionare a documentelor Word oferind o abordare simplă bazată pe șabloane. Suportul pentru formatare avansată în documentele Word se referă la capacitatea de a aplica diverse atribute de stil, cum ar fi stiluri de font, culori, dimensiuni, aliniamente și multe altele la diferite elemente din documentul Word. Aceasta include formatarea textului, tabelelor, imaginilor, paragrafelor, formatului secțiunii, listelor, punctelor de tip bullet și altor conținuturi pentru a îmbunătăți lizibilitatea și aspectul vizual. Iată un exemplu simplu care arată cum să aplici formatare avansată la o parte a textului într-un document.

// Render the document with custom parser options for rich formatting
doc.render({
  parser: {
    // Custom tag for interpreting HTML-like tags for rich formatting
    tagToken: function(tag) {
      return {
        tagName: tag.substring(1),
        mode: 'open'
      };
    },
    // Apply rich formatting based on tag names
    commands: {
      b: function(scope, context, tag) {
        return {
          type: 'applyRichText',
          value: { b: true }
        };
      },
      i: function(scope, context, tag) {
        return {
          type: 'applyRichText',
          value: { i: true }
        };
      },
      u: function(scope, context, tag) {
        return {
          type: 'applyRichText',
          value: { u: true }
        };
      },
      strike: function(scope, context, tag) {
        return {
          type: 'applyRichText',
          value: { strike: true }
        };
      }
    }
  }
});

// Save the generated document
const output = fs.writeFileSync('output.docx', doc.getZip().generate({ type: 'nodebuffer' }));

console.log('Document generated successfully!');