Bezplatná Node.js knihovna pro vytváření a správu Word DOCX ze šablon

Jak nainstalovat Docxtemplater?

Pro instalaci Docxtemplater můžete použít npm, správce balíčků pro JavaScript. Použijte následující příkazy pro úspěšnou instalaci.

 npm install --save docxtemplater pizzip

Vytváření Word dokumentů pomocí šablony v Node.js

Open source knihovna Docxtemplater usnadňuje vývojářům softwaru generovat Microsoft Word DOCX dokumenty pomocí šablony. Vývojáři mohou injektovat dynamická data do šablony předáním objektu obsahujícího páry klíč‑hodnota k nahrazení zástupných znaků skutečnými daty a vytvoření finálního výstupního dokumentu. Následující příklad ukazuje, jak vývojáři mohou načíst existující šablonu a vygenerovat z ní Word dokument v prostředí 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!');

Přidání vlastních funkcí a filtrů do aplikací Node.js

Vlastní funkce a filtry v knihovně Docxtemplater nabízejí pokročilé možnosti pro manipulaci s daty a provádění specifických operací v šablonách. Umožňují uživatelům rozšířit funkčnost knihovny nad rámec základní výměny zástupných znaků, což umožňuje generování dynamického obsahu a složité zpracování dat. Můžete definovat vlastní funkce a filtry pro manipulaci s daty nebo provádění specifických operací ve vašich šablonách. Zde je příklad, který ukazuje, jak mohou vývojáři implementovat vlastní funkci pro výpočet celkové ceny položek v nákupním košíku a filtr pro formátování měnových hodnot.

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

Podpora bohatého formátování

Open source Docxtemplater zjednodušuje proces vytváření a správy Word dokumentů nabídkou přímého šablonového přístupu. Podpora bohatého formátování ve Word dokumentech odkazuje na možnost aplikovat různé stylové atributy, jako jsou styly písma, barvy, velikosti, zarovnání a další na různé prvky ve Word dokumentu. To zahrnuje formátování textu, tabulek, obrázků, odstavců, sekcí, seznamů, odrážek a dalšího obsahu pro zvýšení čitelnosti a vizuální přitažlivosti. Zde je jednoduchý příklad, který ukazuje, jak použít bohaté formátování na část textu uvnitř dokumentu.

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