Szablony sieci Web
Szablon sieci Web to rekord metadanych witryny Power Pages używany 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ą Power Pages.
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 układów stron lub do tworzenia niestandardowych nagłówek i stopek dla witryny Power Pages.
Atrybuty szablonu sieci Web
| Atrybut | opis |
|---|---|
| Nazwa/nazwisko | 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 niestandardowy układ stron
Szablony sieci Web mogą być używane w połączeniu z niestandardowymi układami stron dla witryn Power Pages.
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 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, 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 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 Power Pages. 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 Power Pages. 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' %} |
Szablony sieci Web jako składniki (wersja zapoznawcza)
Szablony sieci Web mogą być tworzone i używane jako składniki stron sieci Web w celu umożliwienia twórcom korzystania z tych składników, które można ponownie wykorzystać i zapewnić parametry spełniające wymagania.
Więcej informacji: Szablony sieci Web jako składniki