1. Продукти
  2.   Обробка текстів
  3.   Swift
  4.   DOCX
 
  

Безкоштовна Swift-бібліотека для читання та запису DOCX документів

Swift API з відкритим кодом, який дозволяє розробникам iOS та macOS читати, записувати та маніпулювати файлами .docx з розумним керуванням шрифтами, підтримкою абзаців та заголовків.

Що таке бібліотека DOCX?

Робота з документами Microsoft Word у Swift традиційно була викликом для розробників програмного забезпечення через обмежену вбудовану підтримку. Однак open‑source DOCX Swift API пропонує практичне та легковагове рішення. Ця бібліотека на основі Swift дозволяє розробникам програмно створювати, читати, модифікувати та керувати файлами .docx без необхідності використовувати Microsoft Office або зовнішні інструменти. На відміну від громіздких пакетів автоматизації офісу чи хмарних рішень для Word‑документів, ця бібліотека залишає все простим і ефективним, що робить її відмінним вибором для легкого генерування документів на iOS, iPadOS, macOS та серверних Swift‑додатках. Вона підтримує основні функції, такі як додавання абзаців, текстових фрагментів, заголовків, зображень та простого форматування.

Open‑source DOCX Swift API дає змогу розробникам Swift інтегрувати генерацію Word‑документів безпосередньо у свої додатки. API пропонує кілька переваг, таких як крос‑платформна сумісність Swift, легкість і відсутність залежностей, офлайн‑генерація DOCX та інше. Однією з ключових переваг Open‑source DOCX Swift API є його відкритий код, що означає, що розробники мають повний доступ до вихідного коду і можуть змінювати його відповідно до своїх потреб. Такий рівень налаштування дозволяє розробникам адаптувати API до унікальних вимог, забезпечуючи, щоб їхні додатки мали функції та можливості, необхідні для виділення на конкурентному ринку. За допомогою цього API користувачі можуть без зусиль читати, записувати та маніпулювати файлами DOCX, отримуючи доступ і змінюючи вміст документів з точністю та гнучкістю.

Previous Next

Початок роботи з DOCX

Рекомендований спосіб додати DOCX у ваш проект — використання GitHub. Будь ласка, використайте наведений нижче команду для безперешкодної інсталяції.

Встановлення бібліотеки DOCX через CocoaPods

Install DOCX via GitHub

Встановити DOCX через GitHub

go get github.com/shinjukunian/DocX.git

Створення DOCX документів з нуля

З відкритою Swift‑бібліотекою DocX розробники можуть легко створювати .docx файли з нуля. Це включає додавання абзаців, заголовків, зображень, стилів та вбудованих текстових елементів. Розробники можуть просто визначати структуру вмісту за допомогою інтуїтивного API, орієнтованого на 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), що є важливою особливістю для розробників, які працюють з японським текстом, оскільки правильно відображає фонетичні підказки.

 Українська