Δωρεάν Βιβλιοθήκη 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!');