Przechowywanie zawartości źródłowej przy użyciu szablonów sieci web

  • Artykuł

Uwaga

12 października 2022 r. funkcja Portale usługi Power Apps została przekształcona w usługę Power Pages. Więcej informacji: Usługa Microsoft Power Pages jest teraz ogólnie dostępna (blog)
Wkrótce zmigrujemy i scalimy dokumentację funkcji Portale usługi Power Apps z dokumentacją usługi Power Pages.

Szablon sieci Web to tabela Power Apps (adx_webtemplate), z portalami Power Apps używana do przechowywania zawartości źródła szablonu. Szablon sieci Web zazwyczaj będzie zawierał kod Liquid służący do renderowania zawartości dynamicznej i jest centralną tabelą służącą do integrowania szablonów Liquid z pozostałą częścią systemu portali Power Apps.

Szablony sieci Web mogą stanowić część innych treści lub mogą być łączone z innymi szablonami za pomocą znaczników szablonu, i są wywoływane w tych znacznikach przez ich atrybut Nazwa. Można ich również używać do tworzenia całych niestandardowych szablonów stron lub do tworzenia niestandardowych nagłówek i stopek dla witryny portalu.

Uwaga

Możesz również przechowywać zawartość źródła szablonu w Power Pages. Więcej informacji: Co to jest Power Pages

Atrybuty szablonu sieci Web

Atrybut opis
Imię i nazwisko/nazwa Nazwa szablonu. Używana do określania tego szablonu, gdy jest on częścią innej zawartości, lub został rozbudowany przez inne szablony.
Lokalizacja źródłowa Zawartość źródła szablonu. W Power Apps dla tego pola dostępny jest edytor kodu źródłowego z wyróżnianiem składni oraz innymi funkcjami edycji kodu.
Typ MIME Opcjonalnie zapewnia typ MIME dla zawartości szablonu. Typ text/html jest przyjmowany, jeśli nie został podany. Ta wartość będzie używana tylko wtedy, gdy szablon jest skojarzony z szablonem strony i kontroluje renderowanie całości zawartości dla tego szablonu.

Szablony sieci Web jako szablony stron

Szablony sieci Web mogą być używane w połączeniu z szablonami stron w celu tworzenia nowych szablonów dla systemu zarządzania zawartością portali Power Apps. Można to zrobić w całości w obrębie Power Apps, bez konieczności pisania kodu .NET lub ponownego wdrażania aplikacji portalu.

Aby utworzyć nowy szablon strony na podstawie szablonu sieci Web, wybierz szablon sieci Web Typ podczas tworzenia nowego rekordu szablonu strony. Następnie wybierz Szablon sieci Web.

Zauważ opcję Użyj nagłówka i stopki witryny sieci Web(która jest zaznaczona domyślnie). Jeśli jest ona zaznaczona, to Twój szablon sieci Web będzie kontrolował renderowanie zawartości strony pomiędzy globalnym nagłówkiem i stopką witryny internetowej. Jeśli ta opcja nie jest zaznaczona, Twój szablon sieci Web będzie odpowiedzialny za renderowanie pełnej odpowiedzi w przypadku, gdy renderujesz HTML, oznacza to wszystko od typu dokumentu po tagi katalogu głównego <html>, oraz wszystko pomiędzy.

Podczas gdy najczęstszymi przypadkami użycia szablonów sieci Web będzie renderowanie HTML, renderowanie pełnej odpowiedzi (z usunięciem zaznaczenia Użyj nagłówka i stopki witryny sieci Web) daje Ci opcję renderowania dowolnego formatu tekstowego. To tu zaczyna być istotny atrybut Typ MIME szablonu sieci Web. Kiedy szablon strony, który nie używa nagłówka i stopki strony, jest renderowany, nagłówek Content-Type odpowiedzi HTTP zostanie ustawiony na typ MIME powiązanego szablonu strony (text/html zostanie użyty, jeśli nie podano typu MIME), co daje wiele możliwości renderowania treści nie-HTML za pomocą Liquid. Powszechnym przypadkiem użycia byłoby renderowanie kanału RSS przez ustawienie typu MIME application/rss+xml.

Szablony sieci Web jako nagłówki i stopki witryny sieci Web

Szablony sieci Web mogą również służyć do zastępowania globalnego nagłówka i stopki używanych przez portal Power Apps. Ustaw pole Szablon nagłówka lub Szablon stopki Twojej witryny na wybrany szablon sieci Web. Należy zauważyć, że w przypadku zastępowania Nagłówka witryny internetowej, wybrany szablon przejmie na siebie odpowiedzialność za świadczenie podstawowej nawigacji, łącza zaloguj się/wyloguj się, interfejs wyszukiwania itd., dla elementów interfejsu witryny, które normalnie są obsługiwane przez domyślny szablon nagłówka.

Wbudowane szablony sieci Web

Istnieje zestaw gotowych szablonów Liquid dostępnych w ramach portali Power Apps. Aby z nich korzystać, należy je uwzględnić według nazwy, stosując poniższą listę jako punkt odniesienia.

Nazwa Opis Kod
Reklama Ten szablon renderuje reklamę według nazwy albo losową reklamę z umieszczenia reklamy. {% include 'ad' ad_name:'Name' %}{% include 'ad' ad_placement_name:'Placement Name' %}
Blogi Ten szablon renderuje najnowsze wpisy w blogu w grupie list. {% include 'blogs' %}
Linki do stron nadrzędnych Ten szablon renderuje linki stron nadrzędnych z powrotem do Strony głównej z bieżącej strony. {% include 'breadcrumbs' %}
Grupa list linków podrzędnych Ten szablon renderuje linki do stron podrzędnych bieżącej strony w grupie list. {% include 'child_link_list_group' %}{% include 'child_link_list_group' title_only:true %}{% include 'child_link_list_group' image_width:'64px', image_height:'64px' %}
Wydarzenia: nadchodzące Ten szablon renderuje linki do wydarzeń występujących w przedziale od dnia obecnego do 60 dni po dniu obecnym. {% include 'events_upcoming' %}{% include 'events_upcoming' number_of_days_in_advance:60 %}
Fora Ten szablon renderuje listę forów w witrynie internetowej, wraz z liczbami znajdujących się na nich wątków i wpisów. {% include 'forums' %}
Układ 1-kolumnowy Ten szablon renderuje układ jednokolumnowy, który zawiera linki do stron nadrzędnych, tytuł strony oraz zawartość strony. {% extends 'layout_1_column' %}{% block main %}... {% endblock %}
Układ 2-kolumnowy z szeroką lewą kolumną Ten szablon renderuje układ dwukolumnowy. Lewa kolumna jest szersza niż kolumna po prawej stronie. Zawiera linki do stron nadrzędnych, tytuł strony u góry strony, a zawartość skopiowanej strony znajduje się w kolumnie po lewej stronie. {% extends 'layout_2_column_wide_left' %}{% block main %}...{% endblock %}{% block aside %}...{% endblock %}
Układ 2-kolumnowy z szeroką prawą kolumną Ten szablon renderuje układ dwukolumnowy. Prawa kolumna jest szersza niż kolumna po lewej stronie. Zawiera linki do stron nadrzędnych, tytuł strony u góry strony, a zawartość skopiowanej strony znajduje się w kolumnie po prawej stronie. {% extends 'layout_2_column_wide_right' %}{% block main %}...{% endblock %}{% block aside %}...{% endblock %}
Układ 3-kolumnowy z szeroką kolumną środkową Ten szablon renderuje układ trójkolumnowy. Środkowa kolumna jest szersza niż kolumny znajdujące się po lewej i po prawej stronie. Układ zawiera linki do stron nadrzędnych oraz tytuł strony u góry strony, a zawartość skopiowanej strony znajduje się w kolumnie środkowej. {% extends 'layout_3_column_wide_middle' %}{% block left_aside %}...{% endblock %}{% block main %}...{% endblock %}{% block right_aside %}...{% endblock %}
Kopia strony Ten szablon renderuje edytowalny kod HTML zawartości strony, który obsługuje osadzony kod Liquid. {% include 'page_copy' %}
Nagłówek strony Ten szablon renderuje tytuł strony. {% include 'page_header' %}
Ankieta Ten szablon renderuje ankietę według nazwy albo losową ankietę z umieszczenia ankiety. {% include 'poll' poll_name:'Name' %}{% include 'poll' poll_placement_name:'Placement Name' %}
Wyszukiw. Ten szablon renderuje podstawowy szablon wyszukiwania z jednym polem wprowadzania tekstu i przyciskiem wyszukiwania. {% include 'search' %}
Nawigacja boczna Ten szablon renderuje nawigację pionową o układzie drzewa. Zawiera łącza do stron nadrzędnych umożliwiające przejście do pierwszego poziomu (lub określonego poziomu), łącza do stron równorzędnych dla bieżącej strony oraz łącza do stron podrzędnych dla bieżącej strony. {% include 'side_navigation' %}{% include 'side_navigation' depth_offset:1 %}
Fragment kodu Ten szablon renderuje edytowalny fragment kodu zawartości HTML według nazwy. {% include 'snippet' snippet_name:'Name' %}
Nawigacja górna Ten szablon renderuje edytowalny pasek nawigacyjny z menu rozwijanymi dla zestawu linków sieci Web Nawigacja podstawowa. {% include 'top_navigation' %}
Grupa list linków sieci Web Ten szablon renderuje grupę list linków dla zestawu linków sieci web. {% include 'weblink_list_group' weblink_set_name:'Name' %}

Zobacz także

Poznaj Operatory Liquid
Typy Liquid
Warunkowe
Obiekty Liquid
Tagi Liquid
Filtry Liquid

Uwaga

Czy możesz poinformować nas o preferencjach dotyczących języka dokumentacji? Wypełnij krótką ankietę. (zauważ, że ta ankieta jest po angielsku)

Ankieta zajmie około siedmiu minut. Nie są zbierane żadne dane osobowe (oświadczenie o ochronie prywatności).