Kostenlose Node.js Bibliothek zum Erstellen & Verwalten von Word DOCX aus Vorlagen

Wie installiert man Docxtemplater?

Um Docxtemplater zu installieren, können Sie npm, den Paketmanager für JavaScript, verwenden. Bitte verwenden Sie die folgenden Befehle für eine erfolgreiche Installation.

 npm install --save docxtemplater pizzip

Erstellung von Word-Dokumenten über Vorlagen in Node.js

Die Open‑Source‑Bibliothek Docxtemplater ermöglicht es Softwareentwicklern, Microsoft‑Word‑DOCX‑Dokumente mithilfe einer Vorlage zu erzeugen. Entwickler können dynamische Daten in die Vorlage einfügen, indem sie ein Objekt mit Schlüssel‑Wert‑Paare übergeben, das Platzhalter durch echte Daten ersetzt, um das endgültige Ausgabedokument zu erstellen. Das folgende Beispiel zeigt, wie Entwickler eine bestehende Vorlage laden und daraus ein Word‑Dokument in einer Node.js‑Umgebung generieren können.

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!');

Eigene Funktionen & Filter in Node.js-Apps hinzufügen

Benutzerdefinierte Funktionen und Filter in der Docxtemplater‑Bibliothek bieten erweiterte Möglichkeiten zur Datenmanipulation und zum Ausführen spezifischer Operationen innerhalb von Vorlagen. Sie ermöglichen es Nutzern, die Funktionalität der Bibliothek über den einfachen Platzhalter‑Austausch hinaus zu erweitern, wodurch dynamische Inhaltserstellung und komplexe Datenverarbeitung möglich werden. Sie können benutzerdefinierte Funktionen und Filter definieren, um Daten zu manipulieren oder bestimmte Vorgänge innerhalb Ihrer Vorlagen auszuführen. Das folgende Beispiel zeigt, wie Entwickler eine benutzerdefinierte Funktion implementieren können, um den Gesamtpreis von Artikeln in einem Warenkorb zu berechnen, sowie einen Filter zur Formatierung von Währungswerten.

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!');

Unterstützung für Rich Formatting

Die Open‑Source‑Bibliothek Docxtemplater vereinfacht den Prozess der Erstellung und Verwaltung von Word‑Dokumenten, indem sie einen unkomplizierten vorlagenbasierten Ansatz bietet. Rich‑Formatting‑Unterstützung in Word‑Dokumenten bezieht sich auf die Möglichkeit, verschiedene Stilattribute wie Schriftarten, Farben, Größen, Ausrichtungen und mehr auf unterschiedliche Elemente im Word‑Dokument anzuwenden. Dazu gehören die Formatierung von Text, Tabellen, Bildern, Absätzen, Abschnittsformatierungen, Listen, Aufzählungszeichen und anderem Inhalt, um die Lesbarkeit und optische Attraktivität zu erhöhen. Das folgende einfache Beispiel zeigt, wie Rich Formatting auf einen Teil des Textes in einem Dokument angewendet werden kann.

// 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!');