Уеб шаблони
Уеб шаблонът представлява запис на метаданни на сайт на Power Pages, който се използва за съхраняване на изходно съдържание на шаблон. Уеб шаблонът обикновено съдържа Liquid за рендиране на динамично съдържание и представлява централната таблица, използвана за интегриране на шаблони на Liquid с останалата част на Power Pages.
Уеб шаблоните могат да бъдат включени в друго съдържание или комбинирани с други шаблони с помощта на етикети за шаблон и са посочени в тези етикети от техния атрибут Име. Те могат да се използват и за създаване на цели оформления на персонализирани страници или за създаване на персонализирани горен и долен колонтитул за вашия уеб сайт на Power Pages.
Атрибути на уеб шаблон
| Атрибут | Описание |
|---|---|
| Име | Името на шаблона. Използва се за препратка на този шаблон, когато е включен в друго съдържание или разширен от други шаблони. |
| Източник | Съдържанието на източник на шаблона. В Power Apps за това поле се предоставя редактор на изходния код с подчертаване на синтаксиса и други функции за редактиране на код. |
| MIME тип | По желание предоставя MIME тип за съдържанието на шаблона. Типът text/html се приема, ако не е предоставен такъв. Тази стойност ще се използва само в случаите, когато шаблонът е свързан с шаблон на страница и контролира рендирането на цялото съдържание за този шаблон. |
Уеб шаблони като оформления на персонализирани страници
Уеб шаблоните могат да се използват с шаблони за страници за създаване на нови оформления на персонализирани страници за сайтовете на Power Pages.
За да създадете нов шаблон за страница на базата на уеб шаблон, изберете Тип на уеб шаблон при създаването на нов запис за шаблон за страница. След това изберете Уеб шаблон.
Обърнете внимание на опцията Използване на горен и долен колонтитули на уеб сайт(който се проверява по подразбиране). Ако за тази опция е поставена отметка, вашият уеб шаблон ще управлява рендирането на цялото съдържание на страницата между глобалните горен и долен колонтитули на уеб сайта. Ако няма поставена отметка за тази опция, вашият уеб шаблон ще управлява рендирането на целия отговор, в случай че рендирате HTML, което означава всичко от doctype до основните <html> етикети и всичко между тях.
Въпреки че най-честата употреба на уеб шаблони е да се рендира HTML, рендирането на целия отговор (чрез премахване на избора на Използване на горен и долен колонтитули на уеб сайт) ви дава възможност за рендиране на всякакъв базиран на текст формат по ваш избор. Това е мястото, където атрибутът MIME тип на уеб шаблона става важен. Когато се рендира шаблон за страница, който не използва горния и долния колонтитул на уеб сайта, горният колонтитул на HTTP отговора Content-Type ще бъде настроен към MIME типа на свързания уеб шаблон (текст/html ще се използва, ако не е предоставен MIME тип), предоставяйки голямо разнообразие от опции за рендиране на не-HTML съдържание с помощта на Liquid. Типичен случай на употреба би било рендирането на RSS канал чрез задаване на MIME тип на application/rss+xml.
Уеб шаблони като горни и долни колонтитули на уеб сайт
Уеб шаблоните могат да се използват и за заместване на глобалните горен и долен колонтитул, използвани от Power Pages. Задайте полетата Шаблон за горен колонтитул или Шаблон за долен колонтитул на уеб сайта си за уеб шаблон по ваш избор. Ако заместите Горен колонтитул на уеб сайт, избраният от вас шаблон приема отговорност за рендирането на първична навигация, връзки за вход/изход, интерфейс за търсене, и т.н. за елементи от интерфейса на вашия сайт, които обикновено се използват от шаблона за горен колонтитул по подразбиране.
Вградени уеб шаблони
Има набор от предварително подготвени шаблони на Liquid, налични в Power Pages. За да ги използвате, трябва да ги включите по име, като използвате списъка по-долу като препратка.
| Име | Описание | Код |
|---|---|---|
| Реклама | Този шаблон рендира реклама по име или случайна реклама от разполагане на реклами. | {% 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' %} |
| Горна навигационна лента | Този шаблон рендира редактируема навигационна лента с падащи менюта за набора от уеб връзки за основна навигация. | {% include 'top_navigation' %} |
| Списъчна група с уеб връзки | Този шаблон рендира списъчна група от връзки за набор от уеб връзки. | {% include 'weblink_list_group' weblink_set_name:'Name' %} |
Уеб шаблони като компоненти (преглед)
Уеб шаблоните могат да бъдат създадени и използвани като компоненти в уеб страници, за да позволят на създателите да използват тези многократно използваеми компоненти и да предоставят параметри, за да отговорят на изискванията.
Повече информация: Уеб шаблони като компоненти