Хранение исходного содержимого с помощью веб-шаблонов

  • Статья

Примечание

Действует с 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

Примечание

Каковы ваши предпочтения в отношении языка документации? Пройдите краткий опрос (обратите внимание, что этот опрос представлен на английском языке).

Опрос займет около семи минут. Личные данные не собираются (заявление о конфиденциальности).