DOCXドキュメントを読み書きできる無料のSwiftライブラリ

iOS と macOS の開発者がスマートフォントハンドリング、段落、見出しのサポートで .docx ファイルを読み取り、書き込み、操作できるオープンソースのSwift APIです。

DOCXライブラリとは何ですか?

SwiftでMicrosoft Word文書を扱うことは、ネイティブサポートが限られているため、従来ソフトウェア開発者にとって課題でした。しかし、オープンソースのDOCX Swift APIは実用的で軽量なソリューションを提供します。このSwiftベースのライブラリにより、Microsoft Officeや外部ツールに依存せずに、.docx ファイルをプログラムで作成、読み取り、変更、管理できます。重厚なオフィス自動化スイートやクラウドベースのWord文書ソリューションとは異なり、本ライブラリはシンプルかつ効率的で、iOS、iPadOS、macOS、サーバーサイドSwiftアプリでの軽量文書生成に最適です。段落、テキストラン、見出し、画像、シンプルな書式設定の追加といった基本機能をサポートしています。

オープンソースのDOCX Swift APIは、Swift開発者がWord文書生成をアプリに直接統合できるようにします。このAPIは、クロスプラットフォームのSwift互換性、軽量で依存性がないこと、オフラインでのDOCX生成など、さまざまな利点を提供します。Open Source DOCX Swift APIの主要なメリットの一つは、そのオープンソースである点で、開発者はソースコードに完全にアクセスでき、特定のニーズに合わせて変更できます。このカスタマイズ性により、開発者はAPIを独自の要件に合わせて調整でき、競争の激しい市場で際立つために必要な機能と能力をアプリに装備できます。このAPIを使用すれば、ユーザーはDOCXファイルを簡単に読み書き・操作でき、文書の内容を正確かつ柔軟にアクセス・変更できます。

Previous Next

DOCXの使い方

プロジェクトにDOCXを組み込む推奨方法はGitHubを使用することです。スムーズなインストールのために以下のコマンドを使用してください。

CocoaPodsでDOCXライブラリをインストール

Install DOCX via GitHub 

GitHubでDOCXをインストール

go get github.com/shinjukunian/DocX.git 

DOCXドキュメントを一から作成する

オープンソースのDocX Swiftライブラリを使用すれば、ソフトウェア開発者は簡単に最初から .docx ファイルを生成できます。段落、見出し、画像、スタイル、インラインテキスト要素の追加が含まれます。開発者は直感的なSwiftネイティブAPIでコンテンツ構造を簡単に定義できます。以下のコード例は、新しいWord文書を作成し、Swiftアプリ内で "Hello from DocX Swift!" というシンプルな段落を追加する方法を示しています。

Swift APIでシンプルな段落を使用して新しいWord文書を作成する方法は?

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レターなどの標準サイズのプリセットを含むとともに、完全にカスタムな寸法や余白も設定可能で、最終レイアウトを正確にコントロールできます。以下は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 ファイルに忠実に再現されます。フォントやカラー、段落スタイル、文字スタイル、画像埋め込みなどが含まれます。また、ふりがな(ルビ注釈)機能もサポートしており、日本語テキストを扱う開発者にとって注目すべき機能で、音声ガイドを正しく表示します。

 日本