Praca z listami

Interfejs API Dokumentów Google umożliwia konwertowanie zwykłych akapitów na listy wypunktowane oraz usuwanie z akapitów wypunktowań.

Konwertowanie akapitu na listę

Typowym formatowaniem akapitów jest konwertowanie ich na listę wypunktowaną.

Aby utworzyć listę, użyj metody documents.batchUpdate i podaj wartość CreateParagraphBulletsRequest. Dodaj Range, aby wskazać komórki, których dotyczy problem, i BulletGlyphPreset, aby ustawić wzór punktora.

Wszystkie akapity, które pokrywają się z danym zakresem, są oznaczone punktem. Jeśli podany zakres zachodzi na tabelę, wypunktowania są stosowane w komórkach tabeli. Poziom zagnieżdżenia każdego akapitu jest określany przez zliczanie tabulacji na początku każdego akapitu.

Nie możesz dostosować poziomu zagnieżdżenia istniejącego punktora. Zamiast tego musisz usunąć punktor, umieścić początkowe karty na początku akapitu i utworzyć punkt ponownie. Więcej informacji znajdziesz w artykule Usuwanie wypunktowania z listy.

Możesz też użyć CreateParagraphBulletsRequest, aby zmienić styl punktorów na liście.

Poniższy przykładowy kod pokazuje żądanie zbiorcze, które najpierw wstawia tekst na początku dokumentu, a potem tworzy listę z akapitów obejmujących pierwszych 50 znaków. BulletGlyphPreset używa BULLET_ARROW_DIAMOND_DISC, co oznacza, że pierwsze 3 poziomy zagnieżdżania listy wypunktowanej są reprezentowane przez strzałkę, diament i płytkę.

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()
Przekształcanie akapitu w listę.
Rysunek 1. Przekształcanie akapitu w listę.

Usuwanie symboli wypunktowania z listy

Aby usunąć punkty z listy akapitów, użyj metody documents.batchUpdate i podaj wartość DeleteParagraphBulletsRequest. Wpisz Range, aby określić komórki, na które ma być zastosowany ten format.

Ta metoda usuwa wszystkie punktory, które nakładają się na dany zakres, niezależnie od poziomu zagnieżdżenia. Aby zachować poziom zagnieżchnienia, na początku każdego odpowiedniego akapitu dodano wcięcie.

Poniższy przykładowy kod pokazuje prośbę zbiorczą, która usuwa wypunktowania z listy akapitów.

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