使用網站範本儲存來源內容
注意
自 2022 年 10 月 12 日起,Power Apps 入口網站為 Power Pages。 其他資訊:Microsoft Power Pages 現在已推出 (部落格)
我們很快就會遷移並將 Power Apps 入口網站文件與 Power Pages 文件併合。
網站範本是 Power Apps 入口網站隨附的 Power Apps 資料表 (adx_webtemplate),用來儲存範本來源內容。 網站範本通常包含動態內容轉譯的 Liquid,並且是用來整合 Liquid 範本與 Power Apps 入口網站系統其餘部分的主要資料表。
網站範本可以包含在其他內容中,或是使用範本標籤與其他範本結合,並且在這些標籤中透過其名稱屬性參考。 他們也可以用來建立整個自訂頁面範本,或是建立入口網站的自訂頁首和頁尾。
注意
您也可以在 Power Pages 中儲存範本來源內容。 更多資訊:何謂 Power Pages
網站範本屬性
屬性 | 描述 |
---|---|
名稱 | 範本的名稱。 用來參考此範本,當它包含在其他內容中或透過其他範本擴充時。 |
來源 | 範本的來源內容。 在 Power Apps 中,會針對此欄位提供具有語法醒目提示功能和其他程式碼編輯功能的原始程式碼編輯器。 |
MIME 類型 | 選擇性地提供 MIME 類型做為範本內容。 如果未提供,則會假設為 text/html 類型。 只有在範本與頁面範本關聯,並控制該範本的所有內容轉譯時,才會使用此值。 |
網站範本做為頁面範本
網站範本可與頁面範本一起使用,為 Power Apps 入口網站內容管理系統建立新範本。 這可以完全在 Power Apps 內完成,不需要撰寫 .NET 程式碼或重新部署入口網站應用程式。
若要根據網站範本建立新的頁面範本,在建立新的頁面範本記錄時選取網站範本的類型。 然後選取網站範本。
請注意,使用網站頁首和頁尾選項 (預設為勾選狀態)。 如果此選項已勾選,您的網站範本將控制全域網站頁首和頁尾之間所有頁面內容的轉譯。 如果未勾選此選項,則網站範本會負責轉譯整個回應 (在您轉譯 HTML 的情況下),這表示,從 doctype 到根 <html> 標籤的一切內容,也包括兩者之間的一切內容。
雖然網站範本最常見的使用案例是轉譯 HTML,但是轉譯整個回應 (取消選取使用網站頁首和頁尾) 可讓您選擇轉譯所選的任何文字格式。 這就是與網站範本的 MIME 類型屬性相關之處。 當顯示不使用網站頁首和頁腳的頁面範本時,HTTP 回應內容類型標題將設定為關聯 Web 範本的 MIME 類型 (如果未提供 MIME 類型,將使用 text/html。),提供多種使用 Liquid 顯示非 HTML 內容的選項。 常見的使用案例會是透過設定 MIME 類型的 application/rss+xml 來轉譯 RSS 摘要。
網站範本做為網站頁首和頁尾
網站範本也可以用來覆寫 Power Apps 入口網站使用的全域頁首和頁尾。 將網站的頁首範本或頁尾範本欄位設定為您選擇的網站範本。 如果您覆寫網站頁首,您選取的範本會負責轉譯網站的主要導覽、登入/登出連結、搜尋介面等,通常由預設頁首範本處理的網站介面元素。
內建網站範本
Power Apps 入口網站中提供一組預先製作的 Liquid 範本。 若要使用它們,您必須依名稱新增它們,使用下列清單做為參考。
名稱 | 描述 | 代碼 |
---|---|---|
廣告 | 此範本會依名稱呈現廣告,或是從廣告位置呈現隨機廣告。 | {% include 'ad' ad_name:'Name' %}{% include 'ad' ad_placement_name:'Placement Name' %} |
部落格 | 此範本會在清單群組中呈現最近的部落格文章。 | {% include 'blogs' %} |
導覽路徑標示 | 此範本會轉譯目前頁面的上階頁面連結,重新呈現為首頁。 | {% include 'breadcrumbs' %} |
子連結清單群組 | 此範本會將連結轉譯成清單群組中目前頁面的任何子頁面。 | {% include 'child_link_list_group' %}{% include 'child_link_list_group' title_only:true %}{% include 'child_link_list_group' image_width:'64px', image_height:'64px' %} |
事件:近期 | 此範本會將連結轉譯成現在到未來 60 天內發生的事件。 | {% include 'events_upcoming' %}{% include 'events_upcoming' number_of_days_in_advance:60 %} |
論壇 | 此範本會轉譯網站論壇的清單,包含各自的對話和文章數。 | {% include 'forums' %} |
配置 1 欄 | 此範本會轉譯單欄配置,包含導覽路徑標示、頁面標題及頁面複製內容。 | {% extends 'layout_1_column' %}{% block main %}... {% endblock %} |
配置 2 欄左寬 | 此範本會轉譯兩欄配置。 左欄會比右欄寬。 它包含導覽路徑標示、頁面頂端的頁面標題,以及頁面複製內容,位於左欄中。 | {% extends 'layout_2_column_wide_left' %}{% block main %}...{% endblock %}{% block aside %}...{% endblock %} |
配置 2 欄右寬 | 此範本會轉譯兩欄配置。 右欄會比左欄寬。 它包含導覽路徑標示、頁面頂端的頁面標題,以及頁面複製內容,位於右欄中。 | {% extends 'layout_2_column_wide_right' %}{% block main %}...{% endblock %}{% block aside %}...{% endblock %} |
配置 3 欄中間寬 | 此範本會轉譯三欄配置。 中間欄會比左和右欄寬。 配置包含導覽路徑標示、頁面頂端的頁面標題及頁面複製內容,位於中間欄。 | {% extends 'layout_3_column_wide_middle' %}{% block left_aside %}...{% endblock %}{% block main %}...{% endblock %}{% block right_aside %}...{% endblock %} |
頁面複製 | 此範本會轉譯可編輯的頁面複製內容 HTML,並支援內嵌 Liquid。 | {% include 'page_copy' %} |
頁面標題 | 此範本轉譯頁面標題。 | {% include 'page_header' %} |
輪詢 | 此範本會依名稱轉譯意見調查,或是從意見調查位置呈現隨機意見調查。 | {% include 'poll' poll_name:'Name' %}{% include 'poll' poll_placement_name:'Placement Name' %} |
搜尋 | 此範本會轉譯基本搜尋表單,包含單一文字輸入和搜尋按鈕。 | {% include 'search' %} |
側邊導覽 | 此範本轉譯垂直樹狀檢視樣式導覽。 它包含上階頁面的連結,可返回第一層 (或指定的深度位移)、目前頁面的同層級頁面連結,以及目前頁面的子頁面連結。 | {% include 'side_navigation' %}{% include 'side_navigation' depth_offset:1 %} |
程式碼片段 | 此範本會依名稱轉譯可編輯的 HTML 內容程式碼片段。 | {% include 'snippet' snippet_name:'Name' %} |
上方導覽 | 此範本會轉譯可編輯的導覽列,包含下拉式功能表用於主要導覽 Web 連結設定。 | {% include 'top_navigation' %} |
網頁連結清單群組 | 此範本呈現網頁連結組的連結清單群組。 | {% include 'weblink_list_group' weblink_set_name:'Name' %} |