1. Товары
  2.   Обработка текстов
  3.   Swift
  4.   DOCX
 
  

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

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

Что такое библиотека DOCX?

Работа с документами Microsoft Word в Swift традиционно была проблемой для разработчиков из‑за ограниченной нативной поддержки. Однако открытый API DOCX Swift предлагает практичное и легковесное решение. Эта библиотека на основе Swift позволяет разработчикам программно создавать, читать, изменять и управлять файлами .docx без необходимости использовать Microsoft Office или внешние инструменты. В отличие от громоздких пакетов автоматизации офисных задач или облачных решений для Word‑документов, эта библиотека сохраняет простоту и эффективность, что делает её отличным выбором для легковесной генерации документов на iOS, iPadOS, macOS и серверных приложениях Swift. Она поддерживает базовые функции, такие как добавление абзацев, фрагментов текста, заголовков, изображений и простой форматировки.

Открытый API DOCX Swift дает разработчикам Swift возможность интегрировать генерацию Word‑документов непосредственно в свои приложения. API предоставляет несколько преимуществ, таких как кроссплатформенная совместимость Swift, легковесность и отсутствие зависимостей, возможность генерации DOCX офлайн и многое другое. Одним из ключевых преимуществ открытого API DOCX Swift является его открытый характер, что означает полный доступ разработчиков к исходному коду и возможность его модификации под конкретные нужды. Такой уровень кастомизации позволяет разработчикам адаптировать API к своим уникальным требованиям, обеспечивая приложение необходимыми функциями и возможностями для выделения на конкурентном рынке. С помощью этого API пользователи могут без труда читать, писать и управлять файлами 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 с нуля. Это включает добавление абзацев, заголовков, изображений, стилей и встроенных текстовых элементов. Разработчики могут легко определить структуру контента с помощью интуитивного 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‑аннотации), что является выдающейся особенностью для разработчиков, работающих с японским текстом, так как корректно отображает фонетические подсказки.

 Русский