استخدام القوائم

تتيح واجهة Google Docs API تحويل الفقرات العادية إلى قوائم نقطية وإزالة النقاط من الفقرات.

تحويل فقرة إلى قائمة

من العمليات الشائعة لتنسيق الفقرات تحويلها إلى قائمة نقطية.

لإنشاء قائمة، استخدِم الطريقة documents.batchUpdate وقدِّم CreateParagraphBulletsRequest. أدرِج Range لتحديد الخلايا المتأثرة وBulletGlyphPreset لضبط نمط النقطة.

يتم وضع نقاط تعداد في جميع الفقرات التي تتداخل مع النطاق المحدّد. إذا كان النطاق المحدّد يتداخل مع جدول، يتم تطبيق الرموز النقطية داخل خلايا الجدول. يتم تحديد مستوى التداخل لكل فقرة من خلال احتساب علامات التبويب البادئة قبل كل فقرة.

لا يمكنك تعديل مستوى التداخل لنقطة تعداد حالية. بدلاً من ذلك، عليك حذف النقطة، وضبط علامات التبويب البادئة أمام الفقرة، ثم إنشاء النقطة مرة أخرى. لمزيد من المعلومات، يُرجى الاطّلاع على إزالة النقاط من قائمة.

يمكنك أيضًا استخدام CreateParagraphBulletsRequest لتغيير نمط التعداد النقطي لقائمة حالية.

يعرض نموذج الرمز التالي طلبًا مجمّعًا يدرج النص أولاً في بداية المستند، ثم ينشئ قائمة من الفقرات التي تمتد على أول 50 حرفًا. يستخدم BulletGlyphPreset BULLET_ARROW_DIAMOND_DISC، ما يعني أنّ مستويات التداخل الثلاثة الأولى من القائمة النقطية ممثّلة بسهم وماسة وقرص.

Java

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

requests.add(new Request().setCreateParagraphBullets(
        new CreateParagraphBulletsRequest()
                .setRange(new Range()
                        .setStartIndex(1)
                        .setEndIndex(50)
                        .setTabId(TAB_ID))
                .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,
                'tabId': TAB_ID
            },
            'text': 'Item One\n',
        }}, {
        'createParagraphBullets': {
            'range': {
                'startIndex': 1,
                'endIndex':  50,
                'tabId': TAB_ID
            },
            '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)
                        .setTabId(TAB_ID))));

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

Python

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

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