Bibliothèque Swift gratuite pour lire & écrire des documents DOCX
API Swift open source qui permet aux développeurs iOS & macOS de lire, écrire et manipuler des fichiers .docx avec gestion intelligente des polices, prise en charge des paragraphes et des titres.
Qu'est-ce que la bibliothèque DOCX ?
Travailler avec les documents Microsoft Word sous Swift a traditionnellement été un défi pour les développeurs en raison du support natif limité. Cependant, l'API Swift DOCX open source offre une solution pratique et légère. Cette bibliothèque basée sur Swift permet aux développeurs de créer, lire, modifier et gérer des fichiers .docx de manière programmatique sans dépendre de Microsoft Office ou d'outils externes. Contrairement aux suites d'automatisation de bureau volumineuses ou aux solutions de documents Word basées sur le cloud, cette bibliothèque garde les choses simples et efficaces, ce qui la rend idéale pour la génération légère de documents sur iOS, iPadOS, macOS et les applications Swift côté serveur. Elle prend en charge les fonctionnalités de base comme l'ajout de paragraphes, de blocs de texte, de titres, d'images et de formatage simple.
L'API Swift DOCX open source permet aux développeurs Swift d'intégrer la génération de documents Word directement dans leurs applications. L'API offre plusieurs avantages tels que la compatibilité multiplateforme Swift, la légèreté et l'absence de dépendances, la génération hors ligne de DOCX et bien d'autres. L'un des principaux avantages de l'API Swift DOCX open source est sa nature open source, ce qui signifie que les développeurs ont un accès complet au code source et peuvent le modifier pour répondre à leurs besoins spécifiques. Ce niveau de personnalisation permet aux développeurs d'adapter l'API à leurs exigences uniques, garantissant que leurs applications disposent des fonctionnalités et des capacités nécessaires pour se démarquer sur un marché concurrentiel. Avec cette API, les utilisateurs peuvent lire, écrire et manipuler des fichiers DOCX sans effort, leur permettant d'accéder et de modifier le contenu des documents avec précision et flexibilité.
Premiers pas avec DOCX
La façon recommandée d'intégrer DOCX dans votre projet est d'utiliser GitHub. Veuillez utiliser la commande suivante pour une installation fluide.
Installer la bibliothèque DOCX via CocoaPods
Install DOCX via GitHub Installer DOCX via GitHub
go get github.com/shinjukunian/DocX.git Créer des documents DOCX à partir de zéro
Avec la bibliothèque Swift open source DocX, les développeurs peuvent générer des fichiers .docx de A à Z avec facilité. Cela inclut l'ajout de paragraphes, de titres, d'images, de styles et d'éléments de texte en ligne. Les développeurs peuvent facilement définir la structure du contenu avec une API intuitive et native Swift. L'exemple de code suivant montre comment créer un nouveau document Word et ajouter un paragraphe simple indiquant "Hello from DocX Swift!" dans les applications Swift.
Comment créer un nouveau document Word avec un paragraphe simple via l'API Swift ?
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"))
Gestion intelligente des polices & contrôle de la mise en page
Pour assurer la compatibilité multiplateforme, les développeurs peuvent configurer DocX pour qu'il utilise les polices standard de traitement de texte au lieu d'incorporer des noms de polices spécifiques. Cela évite les problèmes où un document pourrait apparaître différemment sur une machine qui n'a pas la police originale installée. De plus, avec PageDefinition, vous pouvez spécifier la taille de la page et les marges de votre document. La bibliothèque comprend des préréglages pour les tailles standard comme A4 et US Letter, mais elle permet également des dimensions et marges entièrement personnalisées, vous offrant un contrôle précis sur la mise en page finale. Voici un exemple simple montrant comment définir une taille de page personnalisée dans les applications Swift.
Comment définir une taille de page personnalisée via l'API Swift ?
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)
Prise en charge complète des attributs
La bibliothèque Swift DocX prend en charge une large gamme d'attributs de texte, garantissant que votre texte riche soigneusement élaboré est fidèlement représenté dans le fichier .docx final. Cela inclut les polices et les couleurs, les styles de paragraphe, les styles de caractères, l'intégration d'images, et bien plus encore. Elle prend également en charge les fonctionnalités Furigana (annotations Ruby), ce qui est une caractéristique remarquable pour les développeurs travaillant avec du texte japonais, car elle rend correctement les guides phonétiques.