ใช้งานรายการ

Google เอกสาร API รองรับการแปลงย่อหน้าธรรมดาเป็นรายการหัวข้อย่อย และนำหัวข้อย่อยออกจากย่อหน้า

แปลงย่อหน้าเป็นรายการ

การจัดรูปแบบย่อหน้าโดยทั่วไปคือการแปลงย่อหน้าเป็นรายการหัวข้อย่อย

หากต้องการสร้างรายการ ให้ใช้เมธอด documents.batchUpdate แล้วระบุ CreateParagraphBulletsRequest ใส่ Range เพื่อระบุเซลล์ที่ได้รับผลกระทบและ BulletGlyphPreset เพื่อกำหนดรูปแบบสำหรับหัวข้อย่อย

ย่อหน้าทั้งหมดที่ซ้อนทับกับช่วงที่ระบุจะถูกใส่สัญลักษณ์หัวข้อย่อย หากช่วงที่ระบุทับซ้อนกับตาราง ระบบจะใช้สัญลักษณ์หัวข้อย่อยภายในเซลล์ของตาราง ระดับการซ้อนของแต่ละย่อหน้าจะกำหนดโดยการนับแท็บที่นำอยู่หน้าแต่ละย่อหน้า

คุณไม่สามารถปรับระดับการซ้อนของหัวข้อย่อยที่มีอยู่ได้ แต่คุณต้องลบหัวข้อย่อย ตั้งค่าแท็บนำหน้าย่อหน้า แล้วสร้างหัวข้อย่อยอีกครั้ง ดูข้อมูลเพิ่มเติมได้ที่นำสัญลักษณ์หัวข้อย่อยออกจากรายการ

คุณยังใช้ CreateParagraphBulletsRequest เพื่อเปลี่ยนรูปแบบหัวข้อย่อยสำหรับรายการที่มีอยู่ได้ด้วย

ตัวอย่างโค้ดต่อไปนี้แสดงคำขอแบบกลุ่มที่จะแทรกข้อความไว้ที่จุดเริ่มต้นของเอกสารก่อน จากนั้นจึงสร้างรายการจากย่อหน้าที่ครอบคลุมอักขระ 50 ตัวแรก BulletGlyphPreset ใช้ BULLET_ARROW_DIAMOND_DISC ซึ่งหมายความว่าระดับซ้อน 3 ระดับแรกของรายการสัญลักษณ์หัวข้อย่อยจะแสดงด้วยลูกศร เพชร และดิสก์

      List<Request> requests = new ArrayList<>();
      requests.add(new Request().setInsertText(new InsertTextRequest()
              .setText("Item One\n")
              .setLocation(new Location().setIndex(1))));

      requests.add(new Request().setCreateParagraphBullets(
              new CreateParagraphBulletsRequest()
                      .setRange(new Range()
                              .setStartIndex(1)
                              .setEndIndex(50))
                      .setBulletPreset("BULLET_ARROW_DIAMOND_DISC")));

      BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests);
      BatchUpdateDocumentResponse response = docsService.documents()
              .batchUpdate(DOCUMENT_ID, body).execute();

    requests = [
         {
            'insertText': {
                'location': {
                    'index': 1
                },
                'text': 'Item One\n',
            }}, {
            'createParagraphBullets': {
                'range': {
                    'startIndex': 1,
                    'endIndex':  50
                },
                'bulletPreset': 'BULLET_ARROW_DIAMOND_DISC',
            }
        }
    ]

    result = service.documents().batchUpdate(
        documentId=DOCUMENT_ID, body={'requests': requests}).execute()

นำสัญลักษณ์หัวข้อย่อยออกจากรายการ

หากต้องการนำสัญลักษณ์หัวข้อย่อยออกจากรายการย่อหน้า ให้ใช้เมธอด documents.batchUpdate และป้อน DeleteParagraphBulletsRequest ใส่ Range เพื่อระบุเซลล์ที่ได้รับผลกระทบ

เมธอดจะลบสัญลักษณ์หัวข้อย่อยทั้งหมดที่ซ้อนทับกับช่วงที่กำหนด โดยไม่คำนึงถึงระดับการซ้อน เพื่อรักษาระดับการซ้อนภาพ ระบบจะเพิ่มการเยื้องที่จุดเริ่มต้นของแต่ละย่อหน้าที่เกี่ยวข้อง

ตัวอย่างโค้ดต่อไปนี้แสดงคำขอแบบกลุ่มที่ลบหัวข้อย่อยออกจากรายการย่อหน้า

      List<Request> requests = new ArrayList<>();
      requests.add(new Request().setDeleteParagraphBullets(
              new DeleteParagraphBulletsRequest()
                      .setRange(new Range()
                              .setStartIndex(1)
                              .setEndIndex(50))));

      BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests);
      BatchUpdateDocumentResponse response = docsService.documents()
              .batchUpdate(DOCUMENT_ID, body).execute();

    requests = [
         {
            'deleteParagraphBullets': {
                'range': {
                    'startIndex': 1,
                    'endIndex':  50
                },
            }
        }
    ]

    result = service.documents().batchUpdate(
        documentId=DOCUMENT_ID, body={'requests': requests}).execute()