Aturan dan perilaku pengeditan struktural

Bagian ini menjelaskan perilaku dan batasan yang harus Anda pahami saat mengedit dokumen menggunakan Google Docs API.

Secara umum, Anda tidak dapat menjalankan pengeditan yang menyebabkan struktur elemen yang tidak valid dalam dokumen. Tinjau setiap documents.batchUpdate metode permintaan untuk mengetahui batasan dan aturan yang berlaku untuk permintaan tersebut.

Bagian berikut merangkum aturan utama di seluruh metode ini.

Menyisipkan teks

  • Menyisipkan karakter baris baru secara implisit akan membuat a Paragraph at indeks tersebut. Gaya paragraf paragraf baru disalin dari paragraf pada indeks penyisipan saat ini, termasuk daftar dan poin.
  • Teks harus disisipkan dalam batas Paragraph yang ada. Misalnya, teks tidak dapat disisipkan pada indeks awal tabel. Teks harus disisipkan di paragraf sebelumnya.
  • API dapat menyesuaikan lokasi secara implisit untuk mencegah penyisipan dalam cluster grafem Unicode. Jika hal ini terjadi, teks akan disisipkan segera setelah cluster grafem.
  • Gaya teks untuk teks yang disisipkan ditentukan secara otomatis, yang umumnya mempertahankan gaya teks di sekitarnya. Biasanya, gaya teks untuk teks yang disisipkan cocok dengan teks segera sebelum indeks penyisipan.
  • Beberapa karakter kontrol (U+0000-U+0008, U+000C-U+001F) dan karakter dari Area Penggunaan Pribadi Unicode Basic Multilingual Plane (U+E000-U+F8FF) dihapus dari teks yang disisipkan.
  • Untuk mengetahui informasi selengkapnya, lihat Menyisipkan, menghapus, dan memindahkan teks.

Menyisipkan gambar inline

  • Ukuran gambar harus kurang dari 50 MB, tidak boleh melebihi 25 megapiksel, dan harus dalam salah satu format PNG, JPEG, atau GIF.
  • URI yang diberikan harus dapat diakses secara publik dan panjangnya maksimal 2 KB.
  • Gambar harus disisipkan dalam batas Paragraph yang ada. Misalnya, teks tidak dapat disisipkan pada indeks awal tabel.
  • Gambar tidak dapat disisipkan di dalam catatan kaki atau persamaan.
  • Untuk mengetahui informasi selengkapnya, lihat Menyisipkan gambar inline.

Memformat teks

  • Saat Anda menerapkan pemformatan tingkat paragraf ke rentang, pemformatan akan diterapkan ke paragraf mana pun yang sebagian atau seluruhnya tumpang-tindih dengan rentang tersebut.
  • Rentang dapat diperluas untuk menyertakan baris baru yang berdekatan.
  • Jika rentang sepenuhnya berisi paragraf yang termasuk dalam daftar, poin paragraf juga akan diperbarui dengan gaya teks yang cocok.
  • Untuk mengetahui informasi selengkapnya, lihat Format text.

Membuat poin paragraf

  • Membuat poin untuk semua paragraf yang tumpang-tindih dengan rentang yang diberikan.
  • Tingkat bersarang setiap paragraf ditentukan oleh jumlah tab utama sebelum setiap paragraf.
  • Tab utama akan dihapus saat membuat poin, yang dapat mengubah indeks bagian teks.
  • Jika Anda menambahkan poin paragraf yang cocok dengan poin daftar segera sebelum paragraf target, paragraf akan digabungkan ke daftar.
  • Untuk mengetahui informasi selengkapnya, lihat Bekerja dengan daftar.

Menghapus teks

  • Menghapus teks yang melintasi batas paragraf dapat menyebabkan perubahan pada gaya paragraf, daftar, objek yang diposisikan, dan bookmark saat kedua paragraf digabungkan.

  • Penghapusan yang menyebabkan struktur dokumen tidak valid tidak diizinkan. Beberapa contoh permintaan penghapusan yang tidak valid meliputi:

    • Menghapus satu unit kode dari pasangan pengganti.

    • Menghapus karakter baris baru terakhir dari Body, Header, Footer, Footnote, TableCell, atau TableOfContents.

    • Menghapus awal atau akhir Table, TableOfContents, atau Equation tanpa menghapus seluruh elemen.

    • Menghapus karakter baris baru sebelum Table, TableOfContents, atau SectionBreak tanpa menghapus elemen.

    • Menghapus baris atau sel tabel satu per satu. Menghapus konten di sel tabel diizinkan.

  • Untuk mengetahui informasi selengkapnya, lihat Menyisipkan, menghapus, dan memindahkan teks.