Веб-шаблоны
Веб-шаблон — это запись метаданных сайта Power Pages, которая используется для хранения содержимого источника шаблона. Обычно веб-шаблон содержит код Liquid для динамического отображения содержимого и является основной таблицей, используемой для интеграции шаблонов Liquid с остальной частью Power Pages.
Веб-шаблоны можно включить в другое содержимое или объединить с другими шаблонами с помощью тегов шаблонов; ссылка на шаблоны в этих тегах производится по атрибуту Имя. Они также могут использоваться для создания полных пользовательских макетов страниц или создания настраиваемых верхних и нижних колонтитулов для вашего веб-сайта Power Pages.
Атрибуты веб-шаблона
| Атрибут | Описание: |
|---|---|
| Полное имя | Имя шаблона. Используется для ссылки на этот шаблон, если он включен в другое содержимое или расширен другими шаблонами. |
| Источник | Исходное содержимое шаблона. В Power Apps для этого поля предоставляется редактор исходного кода с выделением синтаксиса и другими функциями редактирования кода. |
| Тип MIME | Дополнительно содержит тип MIME для содержимого шаблона. Если тип не указан, принимается тип text/html. Это значение будет использоваться только в случаях, когда шаблон связан с шаблоном страницы и управляет отображением всего содержимого для этого шаблона. |
Веб-шаблоны в качестве пользовательских макетов страниц
Веб-шаблоны можно использовать в сочетании с шаблонами страницы для создания новых макетов страниц для сайтов Power Pages.
Для создания нового шаблона страницы на основе веб-шаблона выберите Тип веб-шаблона при создании новой записи шаблона страницы. Затем выберите Веб-шаблон.
Обратите внимание на флажок Использовать верхний и нижний колонтитулы веб-сайта (который установлен по умолчанию). Если он установлен, ваш веб-шаблон будет управлять отображением всего содержимого страницы между глобальными верхним и нижним колонтитулами веб-сайта. Если этот флажок снят, ваш веб-шаблон отвечает за отрисовку полного ответа в случае за отрисовки HTML, то есть всего от тегов doctype до root <html>, и всего между ними.
Хотя самыми распространенными способами использования веб-шаблонов является отрисовка HTML, отрисовка всего содержимого (путем снятия флажка Использовать верхний и нижний колонтитулы веб-сайта) дает возможность отрисовывать любой выбранный формат на основе текста. Здесь атрибут Тип MIME веб-шаблона становится уместным. При отображении шаблона страницы, который не использует верхний и нижний колонтитулы веб-сайта, для заголовка Content-Type отклика HTTP будет установлен тип MIME связанного веб-шаблона. (Если тип MIME не указан, используется text/html.) Это предоставляет широкий выбор параметров для отображения содержимого, отличного от HTML, с помощью Liquid. Обычным примером использования может быть отображение RSS-канала путем задания типа MIME application/rss+xml.
Веб-шаблоны как верхние и нижние колонтитулы веб-сайта
Веб-шаблоны также можно применять, чтобы переопределить глобальные верхний и нижний колонтитулы, используемые Power Pages. Задайте в поле Шаблон верхнего колонтитула или Шаблон нижнего колонтитула веб-сайта требуемый веб-шаблон. Если переопределить Верхний колонтитул веб-сайта, выбранный шаблон отвечает за отображение основной навигации, ссылок входа и выхода, интерфейса поиска и т. д. для элементов интерфейса вашего сайта, которые обычно обрабатываются шаблоном верхнего колонтитула по умолчанию.
Встроенные веб-шаблоны
В Power Pages имеется набор готовых шаблонов 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' %} |
Веб-шаблоны в качестве компонентов (предварительная версия)
Веб-шаблоны можно создавать и использовать в качестве компонентов на веб-страницах, чтобы создатели могли использовать эти многократно используемые компоненты и предоставлять параметры для удовлетворения требований.
Дополнительные сведения: Веб-шаблоны как компоненты