1. منتجات
  2.   معالجة الكلمة
  3.   Swift
  4.   DOCX
 
  

مكتبة Swift مجانية لقراءة وكتابة مستندات DOCX

واجهة برمجة تطبيقات Swift مفتوحة المصدر تسمح لمطوري iOS و macOS بقراءة، كتابة وتعديل ملفات .docx مع معالجة الخطوط الذكية، ودعم الفقرات والعناوين.

ما هي مكتبة DOCX؟

التعامل مع مستندات Microsoft Word في Swift كان تقليدياً تحديًا للمطورين بسبب الدعم الأصلي المحدود. ومع ذلك، توفر واجهة DOCX Swift مفتوحة المصدر حلًا عمليًا وخفيف الوزن. تمكن هذه المكتبة القائمة على Swift المطورين من إنشاء، قراءة، تعديل وإدارة ملفات .docx برمجيًا دون الاعتماد على Microsoft Office أو أدوات خارجية. على عكس مجموعة أدوات أتمتة المكتب الضخمة أو حلول مستندات Word القائمة على السحابة، تبقي هذه المكتبة الأمور بسيطة وكفء، مما يجعلها ملائمة لإنشاء مستندات خفيفة الوزن على iOS، iPadOS، macOS وتطبيقات Swift على الخادم. تدعم الميزات الأساسية مثل إضافة الفقرات، سلاسل النص، العناوين، الصور، وتنسيق بسيط.

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

Previous Next

البدء مع DOCX

الطريقة الموصى بها لإضافة DOCX إلى مشروعك هي باستخدام GitHub. يرجى استخدام الأمر التالي للتثبيت السلس.

تثبيت مكتبة DOCX عبر CocoaPods

Install DOCX via GitHub

تثبيت DOCX عبر GitHub

go get github.com/shinjukunian/DocX.git

إنشاء مستندات DOCX من الصفر

مع مكتبة DocX Swift مفتوحة المصدر، يمكن للمطورين إنشاء ملفات .docx من الصفر بسهولة. يشمل ذلك إضافة فقرات، عناوين، صور، أنماط وعناصر نصية مضمنة. يمكن للمطورين تعريف بنية المحتوى بسهولة باستخدام واجهة برمجة تطبيقات Swift الأصلية البديهية. يوضح المثال البرمجي التالي كيفية إنشاء مستند Word جديد وإضافة فقرة بسيطة تقول "Hello from DocX Swift!" داخل تطبيقات Swift.

كيف تنشئ مستند Word جديد مع فقرة بسيطة عبر Swift API؟

import DocX

let doc = Document()

let p = Paragraph()
p.appendChild(Text("Hello from DocX Swift!"))
doc.appendChild(p)

try doc.save(to: URL(fileURLWithPath: "MyDocument.docx"))

معالجة الخطوط الذكية والتحكم في تخطيط الصفحة

لضمان التوافق عبر المنصات، يمكن للمطورين تكوين DocX لاستخدام خطوط معالجة Word القياسية بدلاً من تضمين أسماء خطوط محددة. هذا يمنع حدوث مشاكل حيث قد يبدو المستند مختلفًا على جهاز لا يحتوي على الخط الأصلي. علاوةً على ذلك، باستخدام PageDefinition، يمكنك تحديد حجم الصفحة وهوامش المستند. تتضمن المكتبة إعدادات مسبقة لأحجام قياسية مثل A4 و US Letter، وتسمح أيضًا بأبعاد وهوامش مخصصة بالكامل، مما يمنحك تحكمًا دقيقًا في التخطيط النهائي. إليك مثال بسيط يوضح كيفية تعريف حجم صفحة مخصص داخل تطبيقات Swift.

كيف تحدد حجم صفحة مخصص عبر Swift API؟

import Foundation

// 1. Your attributed string
let string = NSAttributedString(string: "This content will be on a custom-sized page.")

// 2. Define a custom page layout
let customPage = PageDefinition(
    pageSize: .init(
        width: Measurement(value: 8, unit: .inches),
        height: Measurement(value: 5, unit: .inches)
    ),
    pageMargins: .init(
        top: .init(value: 0.5, unit: .inches),
        bottom: .init(value: 0.5, unit: .inches),
        left: .init(value: 1, unit: .inches),
        right: .init(value: 1, unit: .inches)
    )
)

// 3. Apply the page definition via DocXOptions
var options = DocXOptions()
options.pageDefinition = customPage

// 4. Write the document
let url = URL(fileURLWithPath: "/path/to/your/CustomPage.docx")
try string.writeDocX(to: url, options: options)

دعم شامل للسمات

تدعم مكتبة Swift DocX مجموعة واسعة من سمات النص، مما يضمن تمثيل النص المنسق بعناية بدقة في ملف .docx النهائي. يشمل ذلك الخطوط والألوان، أنماط الفقرات، أنماط الأحرف، تضمين الصور، وغيرها الكثير. كما تدعم ميزات Furigana (تعليقات Ruby) التي تُعد ميزة بارزة للمطورين الذين يعملون بالنص الياباني، حيث تُظهر الدلائل الصوتية بشكل صحيح.

 عربي