Aturan dan perilaku pengeditan struktural

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

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

Bagian berikut merangkum aturan utama di seluruh metode ini.

Sisipkan teks

  • Menyisipkan karakter baris baru secara implisit akan membuat Paragraph pada indeks tersebut. Gaya paragraf paragraf baru disalin dari paragraf pada indeks penyisipan saat ini, termasuk daftar dan buletin.
  • Teks harus disisipkan dalam batas Paragraph yang ada. Misalnya, teks tidak dapat disisipkan di indeks awal tabel. Teks harus disisipkan dalam paragraf sebelumnya.
  • API dapat menyesuaikan lokasi secara implisit untuk mencegah penyisipan dalam cluster grafem Unicode. Jika ini terjadi, teks akan disisipkan segera setelah gugus grafem.
  • Gaya teks untuk teks yang disisipkan ditentukan secara otomatis, umumnya mempertahankan gaya teks di sekitarnya. Biasanya, gaya teks untuk teks yang disisipkan cocok dengan teks tepat 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) akan dihapus dari teks yang disisipkan.
  • Untuk informasi selengkapnya, lihat Menyisipkan, menghapus, dan memindahkan teks.

Sisipkan gambar sebaris

  • Gambar harus berukuran kurang dari 50 MB, tidak boleh melebihi 25 megapiksel, dan harus berformat 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 di 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 tersebut akan diterapkan ke paragraf 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, tanda peluru paragraf juga akan diperbarui dengan gaya teks yang cocok.
  • Untuk mengetahui informasi selengkapnya, lihat artikel Memformat teks.

Membuat butir paragraf

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

Hapus teks

  • Menghapus teks yang melintasi batas paragraf dapat menyebabkan perubahan pada gaya paragraf, daftar, objek yang diposisikan, dan bookmark saat dua 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 surrogate.

    • 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 tertentu pada tabel. Menghapus konten di sel tabel diizinkan.

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