إنشاء وإدارة Word DOCX عبر مكتبة JavaScript

الشروع في العمل مع Docx

يمكن تثبيت أحدث إصدار من DOCX مباشرة من مستودع DOCX عبر الإنترنت من خلال تطبيق الأمر التالي.

npm install --save docx 

Word Docx File Creation عبر JavaScript API

تمكّن DOCX API مفتوح المصدر مطوري البرامج من إنشاء مستندات Word جديدة بتنسيقات ملفات DOCX ببضع سطرين فقط من كود JavaScript. بمجرد إنشاء المستند ، يمكنك بسهولة تعديله وإضافة كل المحتوى الخاص بك مثل الفقرات والصور والجداول وما إلى ذلك إليه. يمكنك أيضًا الوصول إلى خصائص مستند Word وإضافتها ، مثل المنشئ والوصف والعنوان والموضوع والكلمات الرئيسية و lastModifiedBy والمراجعة.

//create a new document
const doc = new docx.Document();
// add properties to document 
const doc = new docx.Document({
    creator: "Dolan Miu",
});

إدارة قسم من ملف Word Docx

الأقسام هي أقسام فرعية من مستند Word يحتوي على تنسيق الصفحة الخاص به. يمكن أن يكون المقطع عبارة عن مجموعة من الفقرات التي تحتوي على مجموعة معينة من الخصائص مثل حجم الصفحة وأرقام الصفحات واتجاه الصفحة والعناوين والحدود والهوامش. تُستخدم هذه الخصائص لوصف الصفحات التي سيظهر النص عليها. تدعم مكتبة DOCX تمامًا إنشاء القسم وجميع الخصائص ذات الصلة بالقسم.

const doc = new Document({
    sections: [{
        children: [
            new Paragraph({
                children: [new TextRun("Hello World")],
            }),
        ],
    }];
});

إدارة الجداول داخل ملف Word

تعد الجداول أحد عناصر التنسيق الأكثر شيوعًا التي نستخدمها في Microsoft Word. تساعد الجداول المستخدمين على تنظيم المحتوى الخاص بهم بطرق مختلفة. تمنح مكتبة DOCX مفتوحة المصدر مطوري البرامج القدرة على استخدام الجداول داخل تطبيقات JavaScript الخاصة بهم. تدعم المكتبة إضافة صف إلى الجداول ، وتكرار صفوف الجدول ، وإضافة خلايا إلى الجدول ، وضبط عرض الخلية ، وإضافة نص إلى خلية ، وإضافة الجدول المتداخل ، ودمج الخلايا ، وإضافة الأعمدة ، وإضافة حد إلى الجدول ، دمج الأعمدة ، وغير ذلك الكثير.

const docx = require('docx@6.0.1');
const express = require("@runkit/runkit/express-endpoint/1.0.0");
const app = express(exports);
const { Document, Packer, Paragraph, Table, TableCell, TableRow } = docx;
app.get("/", async (req, res) => {
    const table = new Table({
        rows: [
            new TableRow({
                children: [
                    new TableCell({
                        children: [new Paragraph("Hello")],
                    }),
                    new TableCell({
                        children: [],
                    }),
                ],
            }),
            new TableRow({
                children: [
                    new TableCell({
                        children: [],
                    }),
                    new TableCell({
                        children: [new Paragraph("World")],
                    }),
                ],
            }),
        ],
    });
    const doc = new Document({
        sections: [{
            children: [table],
        }],
    });
    const b64string = await Packer.toBase64String(doc);
    res.setHeader('Content-Disposition', 'attachment; filename=My Document.docx');
    res.send(Buffer.from(b64string, 'base64'));
});

إدارة الرؤوس / التذييلات في Word DOCX

تضمنت مكتبة DOCX مفتوحة المصدر دعمًا كاملاً لإضافة وإدارة رؤوس وتذييلات مخصصة داخل ملفات Word DOCX. تتيح المكتبة للمطورين إدراج الجداول والصور والنصوص والمخططات في قسم الرؤوس والتذييلات بسهولة. تتيح لنا المكتبة أيضًا إضافة عدة رؤوس وتذييلات عن طريق إنشاء المزيد من الأقسام. يمكنك بسهولة تعيين رؤوس وتذييلات جديدة حسب القسم.

const docx = require('docx@6.0.1');
const express = require("@runkit/runkit/express-endpoint/1.0.0");
const app = express(exports);
const { Document, Footer, Header, Packer, Paragraph } = docx;
app.get("/", async (req, res) => {
    const doc = new Document({
        sections: [{
            headers: {
                default: new Header({
                    children: [new Paragraph("Header text")],
                }),
            },
            footers: {
                default: new Footer({
                    children: [new Paragraph("Footer text")],
                }),
            },
            children: [new Paragraph("Hello World")],
        }],
    });
    const b64string = await Packer.toBase64String(doc);
    res.setHeader('Content-Disposition', 'attachment; filename=My Document.docx');
    res.send(Buffer.from(b64string, 'base64'));
});