Споделяне чрез

Съхраняване на съдържание на източник с помощта на уеб шаблони

  • Статия

Бележка

В сила от 12 октомври 2022 г. „Портали на Power Apps“ става Power Pages. Повече информация: Microsoft Power Pages вече е общодостъпен (блог)
Скоро ще мигрираме и ще обединим документацията на „Портали на Power Apps“ с документацията на Power Pages.

Уеб шаблонът представлява таблица на Power Apps (adx_webtemplate), включен към портали на Power Apps, който се използва за съхраняване на шаблон за съдържание на източник. Уеб шаблонът обикновено съдържа 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 отговора Content-Type ще бъде зададена на MIME типа на свързания уеб шаблон (текст/html ще се използва, ако не е предоставен MIME тип. ), предоставяйки голямо разнообразие от опции за изобразяване на не-HTML съдържание с помощта на Liquid. Типичен случай на употреба би било рендирането на RSS канал чрез задаване на MIME тип на application/rss+xml.

Уеб шаблони като горни и долни колонтитули на уеб сайт

Уеб шаблоните могат да се използват и за заместване на глобалните горен и долен колонтитул, използвани от Power Apps портала. Задайте полетата Шаблон за горен колонтитул или Шаблон за долен колонтитул на уеб сайта си за уеб шаблон по ваш избор. Ако заместите Горен колонтитул на уеб сайт, избраният от вас шаблон приема отговорност за рендирането на първична навигация, връзки за вход/изход, интерфейс за търсене, и т.н. за елементи от интерфейса на вашия сайт, които обикновено се използват от шаблона за горен колонтитул по подразбиране.

Вградени уеб шаблони

Има набор от предварително приготвени шаблони на Liquid, налични в Power Apps порталите. За да ги използвате, трябва да ги включите по име, като използвате списъка по-долу като препратка.

Име Описание Код
Реклама Този шаблон рендира реклама по име или случайна реклама от разполагане на реклами. {% 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' %}

Вижте също

Разбиране на операторите на Liquid
Типове на Liquid
Условно
Обекти на Liquid
Етикети на Liquid
Филтри на Liquid

Бележка

Можете ли да ни споделите повече за езиковите си предпочитания за документацията? Попълнете кратко проучване. (имайте предвид, че това проучване е на английски език)

Проучването ще отнеме около седем минути. Не се събират лични данни (декларация за поверителност).