Хранение исходного содержимого с помощью веб-шаблонов
Примечание
Действует с 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 до root <html>, и всего между ними.
Хотя самыми распространенными способами использования веб-шаблонов является отображение HTML, отображение всего содержимого (путем снятия флажка Использовать верхний и нижний колонтитулы веб-сайта) дает возможность отображать любой выбранный текстовый формат. Здесь атрибут Тип MIME веб-шаблона будет уместным. При отображении шаблона страницы, который не использует верхний и нижний колонтитулы веб-сайта, для заголовка Content-Type отклика HTTP будет установлен тип MIME связанного веб-шаблона. (Если тип MIME не указан, используется text/html.) Это предоставляет широкий выбор параметров для отображения содержимого, отличного от HTML, с помощью Liquid. Обычным примером использования может быть отображение RSS-канала путем задания типа MIME application/rss+xml.
Веб-шаблоны как верхние и нижние колонтитулы веб-сайта
Веб-шаблоны также можно применять, чтобы переопределить глобальные верхний и нижний колонтитулы, используемые порталом 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' %} |
| Макет с одной колонкой | Этот шаблон выводит навигационную цепочку, заголовок страницы и ее содержимое в одноколоночном макете. | {% extends 'layout_1_column' %}{% block main %}... {% endblock %} |
| Макет с двумя колонками и широкой левой колонкой | Этот шаблон отображает макет с двумя колонками. Левая колонка шире правой. Она содержит навигационные цепочки, заголовок страницы в верхней части страницы; в левой колонке расположено содержимое копии страницы. | {% extends 'layout_2_column_wide_left' %}{% block main %}...{% endblock %}{% block aside %}...{% endblock %} |
| Макет с двумя колонками и широкой правой колонкой | Этот шаблон отображает макет с двумя колонками. Правая колонка шире левой. Она содержит навигационные цепочки, заголовок страницы в верхней части страницы; в правой колонке расположено содержимое копии страницы. | {% extends 'layout_2_column_wide_right' %}{% block main %}...{% endblock %}{% block aside %}...{% endblock %} |
| Макет с тремя колонками и широкой средней колонкой | Этот шаблон отображает макет с тремя колонками. Средняя колонка шире левой и правой колонок. Макет содержит навигационные цепочки и заголовок страницы в верхней части страницы; в средней колонке расположено содержимое копии страницы. | {% 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
Примечание
Каковы ваши предпочтения в отношении языка документации? Пройдите краткий опрос (обратите внимание, что этот опрос представлен на английском языке).
Опрос займет около семи минут. Личные данные не собираются (заявление о конфиденциальности).