مكتبة Node.js مجانية لإنشاء وإدارة مستندات Word DOCX من القوالب

كيفية تثبيت Docxtemplater؟

لتثبيت Docxtemplater، يمكنك استخدام npm، مدير الحزم للـ JavaScript. يرجى استخدام الأوامر التالية لتثبيت ناجح.

 npm install --save docxtemplater pizzip

إنشاء مستندات Word عبر القالب في Node.js

تجعل مكتبة Docxtemplater المفتوحة المصدر من السهل على مطوري البرمجيات توليد مستندات Microsoft Word DOCX باستخدام قالب. يمكن لمطوري البرمجيات حقن بيانات ديناميكية في القالب عبر تمرير كائن يحتوي على أزواج مفتاح-قيمة لاستبدال عناصر النائب ببيانات فعلية لإنشاء مستند الإخراج النهائي. يوضح المثال التالي كيف يمكن للمطورين تحميل قالب موجود وتوليد مستند Word منه داخل بيئة 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!');

إضافة وظائف مخصصة وفلاتر في تطبيقات 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 القدرة على تطبيق سمات تنسيقية مختلفة مثل أنماط الخطوط، الألوان، الأحجام، المحاذاة، وغير ذلك على عناصر مختلفة داخل مستند Word. يشمل ذلك تنسيق النص، الجداول، الصور، الفقرات، تنسيق الأقسام، القوائم، الرموز النقطية وغيرها من المحتوى لتحسين القراءة والجاذبية البصرية. إليكم مثالًا بسيطًا يوضح كيفية تطبيق تنسيق غني على جزء من النص داخل المستند.

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