Поделиться через

Веб-шаблоны

  • Статья

Веб-шаблон — это запись метаданных сайта 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' %}

Веб-шаблоны в качестве компонентов (предварительная версия)

Веб-шаблоны можно создавать и использовать в качестве компонентов на веб-страницах, чтобы создатели могли использовать эти многократно используемые компоненты и предоставлять параметры для удовлетворения требований.

Дополнительные сведения: Веб-шаблоны как компоненты

См. также