Lista zawartości może wywoływać układ sekcji z dodatkowymi składnikami, do których odnosi się zapytanie.
Gdy lista zawartości jest renderowana, można wybrać układ sekcji do renderowania wszystkich zwracanych elementów zawartości. Dzięki temu można dla elementów zawartości tworzyć różne układy, takie jak tabela, suwak czy układ ośmiokolumnowy. Te niestandardowe układy sekcji mogą także być wykorzystywane w bardziej zaawansowanych funkcjach paginacji.
Listy zawartości obsługują paginację typu:
W przypadku standardowej funkcji paginacji układ sekcji nie musi nic wykonywać. Zostanie wyrenderowany z następnym zestawem elementów, gdy użytkownik kliknie na łączu następnej strony. Natomiast dla typów Ładowanie przy przewijaniu i Ładowanie przy kliknięciu nie następuje ponowne renderowanie sekcji, lecz do układu sekcji są dodawane dodatkowe składniki. Rozwiązanie to jest używane głównie dla modelu z nieograniczonym przwijaniem, kiedy to jest ładowanych n
pierwszych elementów, a następnie — gdy użytkownik przewija stronę — jest ładowany i renderowany następny zestaw elementów. Aby zapewnić obsługę typów Ładowanie przy przewijaniu i Ładowanie przy kliknięciu, układ sekcji musi:
render.js
: Implementować API addComponent()
. Interfejs ten będzie wywoływany z każdym nowym składnikiem, który ma zostać dodany do układu sekcji.
// dynamic API for adding additional components through "load more" when used in a Content List addComponent: function (parentObj, component) { // create the component div and add it to the parent object $(parentObj).append(this.createComponentDiv(component)); }
appInfo.json
: Dodać poniższy kod informujący listę zawartości, że układ zawartości obsługuje api addComponent()
.
"contentListData": { "addComponent": true },
Gdy plik appInfo.json
zostanie zaktualizowany, wówczas użytkownik — kiedy wybierze ten układ sekcji w panelu ustawień i przejdzie do ekranu paginacji — zobaczy opcje Ładowanie przy kliknięciu
i Ładowanie przy przewijaniu
.