Membuat daftar isi yang dapat dinavigasi sangat penting saat membuat laporan Word besar atau manual yang perlu dibaca cepat oleh pengguna. Conholdate.Total for Java menyediakan SDK yang kuat yang menyederhanakan kerja dengan file DOCX secara langsung dari aplikasi Java. Dalam panduan langkah‑demi‑langkah ini Anda akan belajar cara menambahkan daftar isi ke dokumen Word dalam Java, mencakup pengaturan, penjelasan kode, dan praktik terbaik.

Contoh Kerja Penuh untuk Menambahkan Daftar Isi ke Dokumen Word dalam Java

Contoh berikut menunjukkan cara menyisipkan daftar isi ke dalam file DOCX yang sudah ada menggunakan Conholdate.Total for Java.

import com.groupdocs.words.Document;
import com.groupdocs.words.DocumentBuilder;
import com.groupdocs.words.TableOfContentsOptions;
import com.groupdocs.words.SaveFormat;
import com.groupdocs.words.TabLeader;

public class AddTableOfContentsExample {
    public static void main(String[] args) throws Exception {
        // Paths to the source and destination Word documents
        String inputPath = "input.docx";
        String outputPath = "output.docx";

// Load the existing document, add a TOC, and save the result
        try (Document doc = new Document(inputPath)) {
            DocumentBuilder builder = new DocumentBuilder(doc);

// Move cursor to the beginning of the document where the TOC will be inserted
            builder.moveToDocumentStart();

// Configure TOC options
            TableOfContentsOptions tocOptions = new TableOfContentsOptions();
            tocOptions.setUpperHeadingLevel(1);          // Include headings from level 1
            tocOptions.setLowerHeadingLevel(3);          // up to level 3
            tocOptions.setRightAlignPageNumbers(true);  // Align page numbers to the right
            tocOptions.setUseHyperlinks(true);           // Make entries clickable
            tocOptions.setTabLeader(TabLeader.DOTS);     // Use dotted leader

// Insert the Table of Contents
            builder.insertTableOfContents(tocOptions);

// Save the modified document
            doc.save(outputPath, SaveFormat.DOCX);
        }
    }
}

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui jalur file (input.docx, output.docx, dll.) agar sesuai dengan lokasi file Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Memahami Penambahan Daftar Isi ke Dokumen Word dalam Kode Java

Berikut adalah rincian langkah-langkah utama yang dilakukan oleh contoh kode:

  1. Muat dokumen sumber - Kelas Document membaca file DOCX yang ada.
try (Document doc = new Document(inputPath)) {
  1. Buat DocumentBuilder - DocumentBuilder menyediakan metode untuk mengedit konten dokumen.
DocumentBuilder builder = new DocumentBuilder(doc);

  1. Posisikan kursor - moveToDocumentStart() memindahkan titik sisipan ke awal file, memastikan TOC muncul sebelum konten apa pun.

    builder.moveToDocumentStart();

  2. Konfigurasikan opsi TOC - TableOfContentsOptions memungkinkan Anda menentukan level heading, perataan nomor halaman, penggunaan hyperlink, dan gaya pemimpin tab.

TableOfContentsOptions tocOptions = new TableOfContentsOptions();
tocOptions.setUpperHeadingLevel(1);
tocOptions.setLowerHeadingLevel(3);
tocOptions.setRightAlignPageNumbers(true);
tocOptions.setUseHyperlinks(true);
tocOptions.setTabLeader(TabLeader.DOTS);

Referensi API detail tersedia di halaman API Reference.

  1. Masukkan TOC dan simpan - insertTableOfContents menambahkan field, dan doc.save menulis file yang diperbarui dalam format DOCX.
    builder.insertTableOfContents(tocOptions);
doc.save(outputPath, SaveFormat.DOCX);

Menginstal dan Mengonfigurasi Conholdate.Total untuk Java

Tambahkan repositori Maven Conholdate dan dependensi SDK ke pom.xml Anda:

<repositories>
    <repository>
        <id>conholdate-repo</id>
        <name>Conholdate Maven Repository</name>
        <url>https://repository.conholdate.com/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.conholdate</groupId>
    <artifactId>conholdate-total</artifactId>
    <version>24.9</version>
    <type>pom</type>
</dependency>

Unduh paket SDK terbaru dari halaman unduhan. SDK memerlukan Java 8 atau yang lebih tinggi dan berjalan pada JVM standar apa pun. Tidak diperlukan komponen runtime tambahan.

Praktik Terbaik untuk Membuat Daftar Isi Word dengan Java

  • Gunakan gaya heading yang konsisten - TOC mengambil paragraf yang diberi gaya heading bawaan (Heading 1, Heading 2, dll.). Pastikan dokumen sumber Anda menggunakan gaya ini untuk menghasilkan entri yang dapat diandalkan.
  • Batasi kedalaman heading - Menyertakan terlalu banyak level dapat membuat TOC menjadi tidak terkendali. Laporan tipikal menggunakan level 1‑3, seperti yang ditunjukkan dalam contoh.
  • Aktifkan hyperlink - Menetapkan setUseHyperlinks(true) membuat entri dapat diklik, meningkatkan navigasi dalam dokumen akhir.
  • Validasi setelah penyisipan - Buka DOCX yang dihasilkan dan perbarui bidang (Ctrl +A, F9) untuk memastikan nomor halaman numbers benar, terutama setelah penyuntingan lebih lanjut.
  • Gunakan kembali objek opsi TOC - Jika Anda menghasilkan beberapa dokumen dalam satu batch, konfigurasikan opsi sekali saja dan gunakan kembali untuk mengurangi beban pembuatan objek.

Kesimpulan

Menambahkan daftar isi ke dokumen Word dalam Java menjadi mudah dengan Conholdate.Total for Java. Dengan memuat file DOCX, mengonfigurasi TableOfContentsOptions, dan menyisipkan field, Anda dapat mengotomatiskan pembuatan laporan dan manual profesional. Ingatlah untuk menginstal SDK, mengikuti rekomendasi praktik terbaik, dan menguji TOC yang dihasilkan di lingkungan target Anda. Untuk penerapan produksi, Anda memerlukan salinan berlisensi; detail harga tersedia di halaman harga dan lisensi sementara dapat diperoleh dari halaman lisensi sementara.

FAQs

  • Apa cara paling sederhana untuk menambahkan daftar isi ke dokumen Word dalam Java?
    Gunakan DocumentBuilder.moveToDocumentStart() diikuti dengan insertTableOfContents dengan objek TableOfContentsOptions yang telah dikonfigurasi, seperti yang ditunjukkan dalam contoh kode.

  • Bagaimana saya dapat mengontrol level heading mana yang muncul di TOC?
    Setel setUpperHeadingLevel dan setLowerHeadingLevel pada instance TableOfContentsOptions untuk menyertakan hanya level yang diinginkan.

  • Apakah mungkin menghasilkan TOC untuk templat Word yang akan diisi nanti?
    Ya. Masukkan TOC ke dalam file templat sebelum mengisi konten dinamis; TOC akan secara otomatis merujuk ke heading yang ditambahkan kemudian.

  • Apakah saya memerlukan koneksi internet untuk menggunakan SDK ini?
    Tidak. Conholdate.Total for Java adalah perpustakaan lokal yang berjalan di server atau desktop Anda tanpa panggilan layanan eksternal.

Baca Selengkapnya