1. Produkty
  2.   Przetwarzanie tekstu
  3.   Swift
  4.   DOCX
 
  

Darmowa biblioteka Swift do odczytu i zapisu dokumentów DOCX

Otwartoźródłowe API Swift, które umożliwia programistom iOS i macOS odczyt, zapis i manipulację plikami .docx z inteligentnym zarządzaniem czcionkami oraz wsparciem dla akapitów i nagłówków.

Czym jest biblioteka DOCX?

Praca z dokumentami Microsoft Word w Swift tradycyjnie stanowiła wyzwanie dla programistów ze względu na ograniczone wsparcie natywne. Jednak otwartoźródłowe DOCX Swift API oferuje praktyczne i lekkie rozwiązanie. Ta biblioteka oparta na Swift umożliwia programistom programowe tworzenie, odczytywanie, modyfikowanie i zarządzanie plikami .docx bez polegania na Microsoft Office lub zewnętrznych narzędziach. W przeciwieństwie do masywnych pakietów automatyzacji biurowej czy rozwiązań opartych na chmurze, biblioteka ta utrzymuje prostotę i wydajność, co czyni ją doskonałą do lekkiego generowania dokumentów na iOS, iPadOS, macOS oraz aplikacjach Swift po stronie serwera. Obsługuje podstawowe funkcje, takie jak dodawanie akapitów, fragmentów tekstu, nagłówków, obrazów i proste formatowanie.

MarkdownToDocx to otwartoźródłowa biblioteka Swift, która płynnie konwertuje dokumenty Markdown do formatu Microsoft Word DOCX. Oparta na parserze MarkdownToDocx firmy Apple i wykorzystująca ZIPFoundation do tworzenia archiwów, biblioteka ta łączy prostą formatację tekstu z profesjonalnym generowaniem dokumentów. Biblioteka wyróżnia się prostotą, jednocześnie oferując zaawansowane opcje dostosowywania dla programistów potrzebujących precyzyjnej kontroli nad stylizacją dokumentów. Niezależnie od tego, czy tworzysz aplikację do robienia notatek, generator dokumentacji czy system zarządzania treścią, MarkdownToDocx dostarcza niezbędne narzędzia.

Previous Next

Pierwsze kroki z DOCX

Zalecanym sposobem dodania DOCX do projektu jest użycie GitHub. Proszę użyć poniższego polecenia, aby przeprowadzić płynną instalację.

Zainstaluj bibliotekę DOCX za pomocą CocoaPods

Install DOCX via GitHub

Zainstaluj DOCX przez GitHub

go get github.com/shinjukunian/DocX.git

Tworzenie dokumentów DOCX od podstaw

Dzięki otwartoźródłowej bibliotece DocX Swift programiści mogą z łatwością generować pliki .docx od podstaw. Obejmuje to dodawanie akapitów, nagłówków, obrazów, stylów oraz elementów tekstowych w linii. Programiści mogą łatwo definiować strukturę treści za pomocą intuicyjnego, natywnego API Swift. Poniższy przykład kodu pokazuje, jak utworzyć nowy dokument Word i dodać prosty akapit z napisem "Hello from DocX Swift!" w aplikacjach Swift.

Jak stworzyć nowy dokument Word z prostym akapitem za pomocą 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"))

Inteligentne zarządzanie czcionkami i kontrola układu strony

Aby zapewnić kompatybilność międzyplatformową, deweloperzy mogą skonfigurować DocX tak, aby używał standardowych czcionek do przetwarzania tekstu zamiast osadzania konkretnych nazw czcionek. Zapobiega to problemom, gdy dokument wygląda inaczej na komputerze, który nie ma zainstalowanej oryginalnej czcionki. Ponadto, dzięki PageDefinition, można określić rozmiar strony i marginesy dokumentu. Biblioteka zawiera presety dla standardowych rozmiarów, takich jak A4 i US Letter, ale także pozwala na całkowicie niestandardowe wymiary i marginesy, dając precyzyjną kontrolę nad ostatecznym układem. Oto prosty przykład pokazujący, jak zdefiniować niestandardowy rozmiar strony w aplikacjach Swift.

Jak zdefiniować niestandardowy rozmiar strony za pomocą 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)

Kompleksowe wsparcie atrybutów

Biblioteka Swift DocX obsługuje szeroką gamę atrybutów tekstu, zapewniając, że starannie przygotowany tekst sformatowany zostanie wiernie odzwierciedlony w końcowym pliku .docx. Obejmuje to czcionki i kolory, style akapitów, style znaków, osadzanie obrazów i wiele innych. Wspiera także funkcję Furigana (adnotacje Ruby), co jest wyróżniającą cechą dla deweloperów pracujących z japońskim tekstem, ponieważ poprawnie renderuje przewodniki fonetyczne.

 Polski