建立支援遲緩載入的區段版面配置

內容清單可以呼叫含有所查詢之其他元件的區段版面配置。

呈現內容清單時,可以選擇選取區段版面配置來呈現所有傳回的內容項目。這可讓您針對內容項目建立各種不同的版面配置,例如表格、滑桿或八欄版面配置。這些自訂區段版面配置也可以加入到更進階的分頁功能中。

內容清單支援下列分頁功能:

  • 分頁
  • 捲動時載入
  • 按一下時載入

對於標準的分頁功能,區段版面配置不需要執行任何作業。當使用者按下一頁時,它將會重新呈現下一組項目。但若是捲動時載入按一下時載入,就不是讓區段版面配置重新呈現,而是在區段版面配置中加入其他元件。這大多用於無限捲動模型,也就是先載入前 n 個項目,當使用者向下捲動頁面時,再擷取並呈現下一組項目。若要支援捲動時載入按一下時載入,自訂區段版面配置需要執行:

  1. render.js:實行 addComponent() API。將對每個要增加至區段版面配置的新元件呼叫此檔案。

    // 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)); 
               }
  2. appInfo.json:包含下列內容,讓內容清單知道區段版面配置支援 addComponent() api

    "contentListData": {  
      "addComponent": true
    },

appInfo.json 更新之後,當使用者在設定值面板中選取此區段版面配置,他們將會在分頁畫面中見到按一下時載入捲動時載入選項。