Der Pagination-Service

Tipp

Zum grundsätzlichen Verstehen von Services lies bitte zuerst Dienste.

Der PaginationService ist dazu da, um Inhalt auf mehrere eigenständige Seiten aufzuteilen. Der Service stellt den PaginationList.Builder zur Verfügung, mit dem man Attribute wie Titel, Inhalt, Kopfzeile und Padding festlegen kann.

Pagination List Builder

First obtain an instance of a PaginationList.Builder:

import org.spongepowered.api.service.pagination.PaginationList;

PaginationList.Builder builder = PaginationList.builder();

Es gibt zwei verschiedene Wege zum Festlegen der Inhalte einer Pagination:

• Mit einer Iterable<Text>

import org.spongepowered.api.text.Text;

import java.util.ArrayList;
import java.util.List;

List<Text> contents = new ArrayList<>();
contents.add(Text.of("Item 1"));
contents.add(Text.of("Item 2"));
contents.add(Text.of("Item 3"));

builder.contents(contents);

Bemerkung

If the Iterable is a List, then bidirectional navigation is supported. Otherwise, only forwards navigation is supported.

• Mit einem Array von Texten

builder.contents(Text.of("Item 1"), Text.of("Item 2"), Text.of("Item 3"));

You can also specify various other components of a paginated list, such as a title, header, footer, and padding. The diagram below shows which component is displayed in each part of the paginated list. In the following diagram, the padding string is shown as the letter p.

pppppppppppppppppppppppp Title pppppppppppppppppppppppp
Header
Item 1
Item 2
Item 3
...
ppppppppppppppppppppppp < 2/3 > ppppppppppppppppppppppp
Footer

To achieve the preceding output, we might use the following builder pattern:

builder.title(Text.of("Title"))
    .contents(Text.of("Item 1"), Text.of("Item 2"), Text.of("Item 3"))
    .header(Text.of("Header"))
    .footer(Text.of("Footer"))
    .padding(Text.of("p"));

Bemerkung

Mit Ausnahme der Inhalte sind alle Komponenten der nummerierten Liste optional. Ein Titel wird jedoch dringend empfohlen.

Finally, to send the paginated list to a MessageReceiver, use PaginationList.Builder#sendTo(MessageReceiver).

Und das war’s! Zur Erinnerung: Eine voll funktionsfähige nummerierte Liste kann generiert und an einen zuvor definierten msgReceiver gesendet werden mithilfe des folgenden Codes:

PaginationList.builder()
    .title(Text.of("Title"))
    .contents(Text.of("Item 1"), Text.of("Item 2"), Text.of("Item 3"))
    .header(Text.of("Header"))
    .footer(Text.of("Footer"))
    .padding(Text.of("p"))
    .sendTo(msgReceiver);