Quy tắc và hành vi chỉnh sửa cấu trúc

Phần này mô tả những hành vi và giới hạn mà bạn phải nắm rõ khi chỉnh sửa tài liệu bằng Google Docs API.

Nhìn chung, bạn không thể thực hiện các thao tác chỉnh sửa khiến cấu trúc của các phần tử trong tài liệu trở nên không hợp lệ. Xem xét từng phương thức yêu cầu documents.batchUpdate để biết các quy tắc và ràng buộc áp dụng cho những yêu cầu đó.

Các phần sau đây tóm tắt các quy tắc chính trong các phương thức này.

Chèn văn bản

  • Việc chèn một ký tự dòng mới sẽ ngầm tạo một Paragraph tại chỉ mục đó. Kiểu đoạn văn của đoạn văn mới được sao chép từ đoạn văn tại chỉ mục chèn hiện tại, bao gồm cả danh sách và dấu đầu dòng.
  • Bạn phải chèn văn bản trong phạm vi của một Paragraph hiện có. Ví dụ: bạn không thể chèn văn bản vào chỉ mục bắt đầu của bảng. Bạn phải chèn văn bản vào đoạn văn trước đó.
  • API có thể điều chỉnh vị trí một cách ngầm định để ngăn việc chèn trong các cụm chữ cái Unicode. Khi điều này xảy ra, văn bản sẽ được chèn ngay sau cụm chữ.
  • Kiểu văn bản cho văn bản được chèn sẽ được xác định tự động, thường là giữ nguyên kiểu của văn bản lân cận. Thông thường, kiểu văn bản cho văn bản được chèn sẽ khớp với văn bản ngay trước chỉ mục chèn.
  • Một số ký tự điều khiển (U+0000-U+0008, U+000C-U+001F) và ký tự trong Vùng sử dụng riêng của Mặt phẳng đa ngôn ngữ cơ bản Unicode (U+E000-U+F8FF) sẽ bị xoá khỏi văn bản được chèn.
  • Để biết thêm thông tin, hãy xem phần Chèn, xoá và di chuyển văn bản.

Chèn hình ảnh cùng dòng

  • Hình ảnh phải có kích thước dưới 50 MB, không được vượt quá 25 megapixel và phải ở một trong các định dạng PNG, JPEG hoặc GIF.
  • URI được cung cấp phải có thể truy cập công khai và có độ dài tối đa là 2 KB.
  • Bạn phải chèn hình ảnh trong phạm vi của một Paragraph hiện có. Ví dụ: bạn không thể chèn văn bản vào chỉ mục bắt đầu của bảng.
  • Bạn không thể chèn hình ảnh vào bên trong chú thích hoặc phương trình.
  • Để biết thêm thông tin, hãy xem phần Chèn hình ảnh nội tuyến.

Định dạng văn bản

  • Khi bạn áp dụng định dạng cấp đoạn văn cho một dải ô, định dạng đó sẽ được áp dụng cho mọi đoạn văn bị dải ô đó chồng lên một phần hoặc toàn bộ.
  • Phạm vi có thể được mở rộng để bao gồm các dòng mới liền kề.
  • Nếu dải ô chứa toàn bộ một đoạn thuộc danh sách, thì dấu đầu dòng của đoạn đó cũng được cập nhật theo kiểu văn bản phù hợp.
  • Để biết thêm thông tin, hãy xem phần Định dạng văn bản.

Tạo dấu đầu dòng cho đoạn văn

  • Tạo dấu đầu dòng cho tất cả các đoạn văn trùng lặp với phạm vi đã cho.
  • Cấp độ lồng của mỗi đoạn văn được xác định bằng số lượng thẻ tab ở đầu trước mỗi đoạn văn.
  • Các thẻ ở đầu sẽ bị xoá khi bạn tạo dấu đầu dòng, điều này có thể làm thay đổi chỉ mục của các phần trong văn bản.
  • Nếu bạn thêm dấu đầu dòng của đoạn văn trùng khớp với dấu đầu dòng của một danh sách ngay trước đoạn văn đích, thì đoạn văn đó sẽ được nối vào danh sách.
  • Để biết thêm thông tin, hãy xem bài viết Làm việc với danh sách.

Xoá văn bản

  • Việc xoá văn bản vượt quá ranh giới đoạn có thể khiến các kiểu đoạn, danh sách, đối tượng được định vị và dấu trang thay đổi khi hai đoạn được hợp nhất.

  • Bạn không được phép xoá nội dung gây ra cấu trúc tài liệu không hợp lệ. Sau đây là một số ví dụ về yêu cầu xoá không hợp lệ:

    • Xoá một đơn vị mã của cặp thay thế.

    • Xoá ký tự dòng mới cuối cùng của Body, Header, Footer, Footnote, TableCell hoặc TableOfContents.

    • Xoá phần đầu hoặc phần cuối của Table, TableOfContents hoặc Equation mà không xoá toàn bộ phần tử.

    • Xoá ký tự dòng mới trước Table, TableOfContents hoặc SectionBreak mà không xoá phần tử.

    • Xoá từng hàng hoặc ô của bảng. Bạn có thể xoá nội dung trong một ô của bảng.

  • Để biết thêm thông tin, hãy xem phần Chèn, xoá và di chuyển văn bản.