1. 产品
  2.   字处理
  3.   Node.js
  4.   Docxtemplater

Docxtemplater

 
 

免费 Node.js 库，用于从模板创建和管理 Word DOCX

领先的开源 Node.js 库，允许使用简单的基于模板的方法通过 JavaScript API 动态创建、编辑和操作 Word DOCX、XLSX 文档。

Docxtemplater 是什么？

在当今快速发展的数字世界中，效率至关重要，尤其是在文档管理方面。无论用户是需要起草合同、生成报告，还是撰写个性化信函，拥有一个可靠的工具来自动化文档创建都能为他们节省宝贵的时间和资源。Docxtemplater 正是这样一个强大的库，它简化了从模板生成 Word 文档的过程。该库支持基于模板的文档生成，将 Word 文档模板中的占位符替换为实际数据，以创建最终的输出文档。

Docxtemplater 的核心是一个强大的开源 JavaScript 库，允许软件开发者通过将数据与预定义模板合并，创建和管理动态的 Word、Excel 和 PowerPoint 文档。利用 OpenXML 格式，库提供了对文档结构和内容的精细控制，使开发者能够插入占位符，这些占位符将在运行时被实际数据替换。

Docxtemplater 是一个多功能库，使软件开发者能够轻松实现文档创建自动化。通过利用模板和数据合并的力量，您可以显著简化文档工作流并提升生产力。正确使用该库，软件开发者可以轻松生成符合特定需求的动态文档。无论是自动化文档生成任务还是个性化报告，Docxtemplater 都是您工具箱中的宝贵工具。

Previous Next

如何安装 Docxtemplater？

要安装 Docxtemplater，您可以使用 npm（JavaScript 的包管理器）。请使用以下命令进行成功安装。

通过 npm 安装 Docxtemplater

 npm install --save docxtemplater pizzip

在 Node.js 中通过模板创建 Word 文档

开源的 Docxtemplater 库让软件开发者能够使用模板生成 Microsoft Word DOCX 文档。开发者可以通过传入包含键值对的对象，将动态数据注入模板，以替换占位符并创建最终输出文档。下面的示例演示了开发者如何在 Node.js 环境中加载现有模板并生成 Word 文档。

如何在 Node.js 中从模板生成 Word 文档？

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

在 Node.js 应用中添加自定义函数和过滤器

Docxtemplater 库中的自定义函数和过滤器提供了在模板中操作数据和执行特定操作的高级功能。它们使用户能够将库的功能扩展至基本占位符替换之外，实现动态内容生成和复杂数据处理。您可以定义自定义函数和过滤器来操作数据或在模板中执行特定操作。下面的示例展示了开发者如何实现一个自定义函数来计算购物车中商品的总价，以及一个过滤器来格式化货币值。

如何通过自定义函数计算购物车中商品的价格并使用过滤器格式化货币值？

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

丰富的格式化支持

开源的 Docxtemplater 通过提供直接的基于模板的方法，简化了创建和管理 Word 文档的过程。Word 文档中的丰富格式化支持指的是能够对文档内的不同元素应用各种样式属性，如字体样式、颜色、大小、对齐方式等。这包括对文本、表格、图像、段落、章节格式、列表、项目符号以及其他内容进行格式化，以提升可读性和视觉效果。下面是一个简单示例，演示了如何对文档中的一段文字应用丰富的格式化。

如何在 Node.js 应用中使用 Docxtemplater 对文本应用丰富的格式化？

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