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

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

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

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

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

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

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

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

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

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