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()
นำสัญลักษณ์หัวข้อย่อยออกจากรายการ
หากต้องการนำสัญลักษณ์หัวข้อย่อยออกจากรายการย่อหน้า ให้ใช้เมธอด 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()