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

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

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

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

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

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

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

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

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

Java

      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();

Python

    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()

รูปที่ 1 แปลงย่อหน้าเป็นรายการ

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

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

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

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

Java

      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();

Python

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

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