Ingyenes Node.js könyvtár Word DOCX létrehozásához és kezeléséhez sablonokból

Docxtemplater telepítése

A Docxtemplater telepítéséhez használhatja az npm‑et, a JavaScript csomagkezelőt. Kérjük, a sikeres telepítéshez használja a következő parancsokat.

 npm install --save docxtemplater pizzip

Word dokumentumok létrehozása sablon alapján Node.js-ben

A nyílt forráskódú Docxtemplater könyvtár könnyűvé teszi a fejlesztők számára, hogy sablon segítségével Microsoft Word DOCX dokumentumokat generáljanak. A fejlesztők dinamikus adatokat adhatnak a sablonba egy kulcs‑érték párokat tartalmazó objektum átadásával, amely helyettesíti a helyőrzőket a tényleges adatokkal, így létrehozva a végső kimeneti dokumentumot. Az alábbi példa bemutatja, hogyan tölthetnek be egy meglévő sablont, és hogyan generálhatnak Word dokumentumot a Node.js környezetben.

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

Egyéni függvények és szűrők hozzáadása Node.js alkalmazásokhoz

A Docxtemplater könyvtárban a testreszabott függvények és szűrők fejlett képességeket biztosítanak az adatok manipulálásához és a sablonokon belüli specifikus műveletek végrehajtásához. Lehetővé teszik a felhasználók számára a könyvtár funkcionalitásának kiterjesztését az egyszerű helyőrzőcsere mellett, dinamikus tartalomgenerálást és összetett adatfeldolgozást biztosítva. Testreszabott függvényeket és szűrőket definiálhat, hogy adatokat manipuláljon vagy speciális műveleteket hajtson végre a sablonjában. Itt egy példa, amely megmutatja, hogyan valósíthat meg egy egyéni függvényt a kosárban lévő tételek összárának kiszámításához, valamint egy szűrőt a pénzösszeg formázásához.

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

Rich formázás támogatása

A nyílt forráskódú Docxtemplater egyszerűsíti a Word dokumentumok létrehozását és kezelését egy átlátható sablon‑alapú megközelítéssel. A rich formázás támogatása a Word dokumentumokban azt jelenti, hogy különböző stílus attribútumokat, például betűstílusokat, színeket, méreteket, igazításokat és egyebeket alkalmazhat a dokumentum különböző elemeire. Ez magában foglalja a szöveg, táblázatok, képek, bekezdések, szakaszformázás, listák, felsorolási pontok és egyéb tartalmak formázását, hogy javítsa az olvashatóságot és a vizuális vonzerőt. Itt egy egyszerű példa, amely bemutatja, hogyan alkalmazhat rich formázást egy szövegrészre a dokumentumon belül.

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