Biblioteca Node.js gratuita para crear y gestionar Word DOCX a partir de plantillas

¿Cómo instalar Docxtemplater?

Para instalar Docxtemplater, puedes usar npm, el gestor de paquetes para JavaScript. Por favor utiliza los siguientes comandos para una instalación exitosa.

 npm install --save docxtemplater pizzip

Creación de documentos Word mediante plantillas en Node.js

La biblioteca de código abierto Docxtemplater facilita a los desarrolladores de software generar documentos Microsoft Word DOCX utilizando una plantilla. Los desarrolladores pueden inyectar datos dinámicos en la plantilla pasando un objeto que contiene pares clave-valor para reemplazar los marcadores de posición con datos reales y crear el documento final. El siguiente ejemplo muestra cómo los desarrolladores pueden cargar una plantilla existente y generar un documento Word a partir de ella dentro del entorno 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!');

Agregar funciones y filtros personalizados en aplicaciones Node.js

Las funciones y filtros personalizados en la biblioteca Docxtemplater ofrecen capacidades avanzadas para manipular datos y realizar operaciones específicas dentro de las plantillas. Permiten a los usuarios ampliar la funcionalidad de la biblioteca más allá del reemplazo básico de marcadores de posición, permitiendo la generación de contenido dinámico y el procesamiento complejo de datos. Puedes definir funciones y filtros personalizados para manipular datos o ejecutar operaciones específicas dentro de tus plantillas. A continuación se muestra un ejemplo que demuestra cómo los desarrolladores pueden implementar una función personalizada para calcular el precio total de los artículos en un carrito de compras y un filtro para formatear valores monetarios.

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

Soporte de formato enriquecido

El código abierto Docxtemplater simplifica el proceso de crear y gestionar documentos Word al ofrecer un enfoque sencillo basado en plantillas. El soporte de formato enriquecido en documentos Word se refiere a la capacidad de aplicar diversos atributos de estilo como tipos de fuente, colores, tamaños, alineaciones y más a diferentes elementos dentro del documento Word. Esto incluye formatear texto, tablas, imágenes, párrafos, formato de secciones, listas, viñetas y otro contenido para mejorar la legibilidad y el atractivo visual. Aquí hay un ejemplo sencillo que muestra cómo aplicar formato enriquecido a una parte del texto dentro de un documento.

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