Biblioteca Swift gratuita para ler e escrever documentos DOCX

API Swift de código aberto que permite a desenvolvedores iOS e macOS ler, escrever e manipular arquivos .docx com gerenciamento inteligente de fontes, suporte a parágrafos e cabeçalhos.

O que é a biblioteca DOCX?

Trabalhar com documentos Microsoft Word em Swift tem sido tradicionalmente um desafio para desenvolvedores de software devido ao suporte nativo limitado. No entanto, a API DOCX Swift de código aberto oferece uma solução prática e leve. Essa biblioteca baseada em Swift permite que desenvolvedores criem, leiam, modifiquem e gerenciem arquivos .docx programaticamente, sem depender do Microsoft Office ou de ferramentas externas. Diferente de suítes de automação de escritório volumosas ou soluções de documentos Word baseadas na nuvem, esta biblioteca mantém tudo simples e eficiente, sendo ideal para geração leve de documentos em iOS, iPadOS, macOS e aplicativos Swift no servidor. Ela suporta recursos essenciais como adição de parágrafos, trechos de texto, cabeçalhos, imagens e formatação simples.

A API DOCX Swift de código aberto capacita desenvolvedores Swift a integrar a geração de documentos Word diretamente em seus aplicativos. A API oferece vários benefícios, como compatibilidade multiplataforma Swift, leve e sem dependências, geração offline de DOCX e muitos outros. Uma das principais vantagens da API DOCX Swift de código aberto é sua natureza aberta, o que significa que os desenvolvedores têm acesso total ao código-fonte e podem modificá-lo para atender às suas necessidades específicas. Esse nível de personalização permite que os desenvolvedores adaptem a API aos seus requisitos únicos, garantindo que seus aplicativos estejam equipados com os recursos e capacidades necessários para se destacar em um mercado competitivo. Com esta API, os usuários podem ler, escrever e manipular arquivos DOCX sem esforço, permitindo acessar e modificar o conteúdo dos documentos com precisão e flexibilidade.

Previous Next

Introdução ao DOCX

A forma recomendada de incluir o DOCX em seu projeto é usando o GitHub. Por favor, use o comando a seguir para uma instalação tranquila.

Instalar a biblioteca DOCX via CocoaPods

Install DOCX via GitHub 

Instalar DOCX via GitHub

go get github.com/shinjukunian/DocX.git 

Criar documentos DOCX do zero

Com a biblioteca DocX Swift de código aberto, os desenvolvedores de software podem gerar arquivos .docx do zero com facilidade. Isso inclui adicionar parágrafos, cabeçalhos, imagens, estilos e elementos de texto embutidos. Os desenvolvedores podem definir facilmente a estrutura do conteúdo com uma API intuitiva e nativa Swift. O exemplo de código a seguir demonstra como criar um novo documento Word e adicionar um parágrafo simples dizendo "Hello from DocX Swift!" em aplicações Swift.

Como criar um novo documento Word com um parágrafo simples via 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"))

Gerenciamento inteligente de fontes e controle de layout de página

Para garantir compatibilidade multiplataforma, os desenvolvedores podem configurar o DocX para usar fontes padrão de processamento de Word em vez de incorporar nomes de fontes específicos. Isso evita problemas em que um documento possa aparecer diferente em uma máquina que não tenha a fonte original instalada. Além disso, com PageDefinition, você pode especificar o tamanho da página e as margens do seu documento. A biblioteca inclui predefinições para tamanhos padrão como A4 e US Letter, mas também permite dimensões e margens totalmente customizadas, proporcionando controle preciso sobre o layout final. Aqui está um exemplo simples que mostra como definir um tamanho de página personalizado em aplicações Swift.

Como definir um tamanho de página personalizado via 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)

Suporte abrangente a atributos

A biblioteca Swift DocX suporta uma ampla variedade de atributos de texto, garantindo que seu texto rico e cuidadosamente elaborado seja fielmente representado no arquivo .docx final. Isso inclui fontes e cores, estilos de parágrafo, estilos de caractere, inserção de imagens e muito mais. Também oferece suporte a recursos de Furigana (anotações Ruby), que são um destaque para desenvolvedores que trabalham com texto em japonês, pois renderizam corretamente guias fonéticos.

 Português