Страницы SharePoint и модель страницы

  • Статья

Эта статья представляет обзор модели страниц SharePoint, в том числе типов страниц, файлов страницы по умолчанию, доступных в SharePoint и SharePoint Online, а также информацию о механизмах обработки страниц.

Готовая для просмотра страница SharePoint представляет собой комбинацию следующих трех типов страниц:

  • Главная страница — управляет макетом и внешним видом содержимого

  • Страница содержимого — содержит элементы управления поля страницы.

  • Удобная страница разработки — на которой пользователь добавляет содержимое

Термины и понятия

Таблица 1. Ключевые термины и понятия, связанные с моделью страниц SharePoint

Термин или понятие Определение Способ доступа Дополнительная информация
Сайт для совместной работы Сайт группы.
Заполнитель контента Запись на эталонной странице, которая резервирует место для элементов управления или контента и может быть заменена позже программными средствами. Все эталонные страницы SharePoint Заполнители контента — это фундамент эталонных страниц SharePoint.
Эталонная страница Страница, которая упорядочивает размещение и поведение левого и верхнего элементов навигации на странице SharePoint. Коллекция эталонных страниц файловой системы SharePoint
Коллекция эталонных страниц Это специальная библиотека документов в SharePoint, где по умолчанию хранятся все элементы фирменной символики (эталонные страницы, макеты страниц, файлы JavaScript, CSS и изображения). У каждого сайта есть своя коллекция эталонных страниц. Параметры > Параметры параметров > сайта главные страницы и макеты страниц Коллекция эталонных страниц содержит каталоги, в которых хранятся ресурсы фирменной символики, такие как эталонные страницы и CSS-файлы.

Совет. При создании настраиваемых элементов фирменной символики сохраняйте пользовательские ресурсы в структуре файла коллекции главных страниц по умолчанию.

Эталонные страницы, коллекция эталонных страниц и макеты страниц в SharePoint
Стратегия минимальной загрузки Стратегия, сокращающая объем данных, который необходимо загрузить браузеру при переходе пользователем с одной страницы SharePoint на другую. Параметры сайта Когда mds активна, SharePoint передает все запросы страницы /_layouts/15/start.aspx и проверяет визуальные различия между новыми запросами страницы и ранее загруженной страницей.

- Оптимизация производительности страниц в SharePoint
- Обзор стратегии минимальной загрузки
Навигация Набор функциональных возможностей, позволяющих пользователям перемещаться по информационной архитектуре сайта SharePoint. Элементы навигации в SharePoint включают поиск, элементы управления древовидными каталогами, кнопки, ленту, гиперссылки, вкладки, меню и таксономию. - Класс Navigation
- Класс NavigationNode
Эталонная страница Oslo Эталонная страница по умолчанию в SharePoint. Коллекция эталонных страниц файловой системы SharePoint В отличие от эталонной страницы seattle.master текущая структура навигации расположена там же, где и верхняя область навигации.
Элемент управления контентом страницы Элемент управления на сайте публикации, в котором можно добавлять веб-части.
Макет страницы Шаблон, применяемый к странице публикации, который отвечает за согласованное представление контента. Коллекция эталонных страниц файловой системы SharePoint Создание макета страницы в SharePoint
Модель страниц Файлы, контент и взаимодействия, которые обеспечивают преобразование страницы SharePoint для просмотра пользователем в браузере. Обзор модели страниц в SharePoint
Страница публикации ASPX-страница на сайте публикации. Класс PublishingPage
Сайт публикации Сайт SharePoint с доступом к сайтам и страницам публикации, содержащим макеты страниц, таксономию, управляемую навигацию и другие функции управления веб- и корпоративным информационным контентом. - Класс PublishingWeb
- Новые возможности разработки сайтов в SharePoint
Seattle.master Эталонная страница по умолчанию в SharePoint. Коллекция эталонных страниц файловой системы SharePoint
Сайт группы Сайт, предназначенный для совместной работы пользователей с документами, вики-страницами, идеями, процессами и т. д.
Макет текста Определяет области контента, которые отображаются на вики-странице.
Элемент управления макетом текста Элемент управления вики-страницей, который может содержать текст, изображения, веб-части и части приложения.
Сайт верхнего уровня Сайт верхнего уровня, по умолчанию предоставляемый сервером. Создание сайтов для SharePoint
Веб-часть Серверные элементы управления, запускающиеся в контексте страниц сайта. Пользовательские действия и записи контейнера свойств из приложения SharePoint
Страница веб-части Страница контента, состоящая из зон веб-частей, которые могут содержать веб-части. Веб-части отображаются на страницах веб-частей с помощью объектов WebPartDefinition. Пространство имен Microsoft.SharePoint.Client.WebParts
Зона веб-части Область на странице, в которую можно добавить веб-часть.
Вики-страница Страница контента, использующая шаблон корпоративного вики-сайта. Пример приложения Provisioning.Pages

Эталонные страницы SharePoint

Эталонная страница — это файл ASP.NET с расширением MASTER. Он включает директиву <%@ Master и определяет элементы HTML верхнего уровня, такие как HTML, Head и Form. В первую очередь перечисляются элементы управления и сборки, а затем объявляется определение DTD для DOCTYPE, которое дает инструкции браузеру по отображению HTML. SharePoint лучше всего работает с элементами DOCTYPE XHTML 1.0 и HTML5.

SharePoint включает несколько эталонных страниц по умолчанию. Они отвечают за структуру по умолчанию и хром определенной страницы SharePoint, подходящие для SKU и типа сайта в случае, когда данное условие применимо, например в левой и верхней части страницы. В таблице 2 приведены эталонные страницы по умолчанию в SharePoint и SharePoint Online.

Табл. 2. Страницы master SharePoint по умолчанию

Эталонная страница Описание
Custom.master Системные страницы, например формы и представления. Используется всеми SKU в SharePoint и SharePoint Online.
Default.master Страницы на сайтах публикаций. Входит во все SKU в SharePoint и SharePoint Online. Доступны, когда активирована функция публикации.
Application.master Некоторые системные страницы, например scope.aspx и keyword.aspx. Входит во все SKU в SharePoint и SharePoint Online.
Minimal.master Эталонная страница по умолчанию, доступная во всех SKU в SharePoint.
Seattle.master Эталонная страница по умолчанию, доступная во всех SKU в SharePoint и SharePoint Online.
Oslo.master Эталонная страница по умолчанию, доступная во всех SKU в SharePoint и SharePoint Online.
Kyoto.master Эталонная страница, доступная в SharePoint Online.
Berlin.master Эталонная страница, доступная в SharePoint Online.
Lyon.master Эталонная страница, доступная в SharePoint Online.
Mysite15.master Сайты OneDrive для бизнеса (ранее: Мой сайт, личные сайты и сайты OneDrive Pro).

Каждая эталонная страница SharePoint по умолчанию содержит элементы управления, требуемые для стандартных технологий веб-программирования, например HTML, CSS и JavaScript, для функционирования в SharePoint.

Заполнители контента резервируют место под информацию, определяемую на страницах контента. Они соответствуют областям страницы. Каждая область эталонной страницы определяется заполнителями контента числом от единиц до нескольких сотен.

Эталонные страницы SharePoint используют сочетание объявлений ASP.NET (<asp:) и SharePoint (<SharePoint:). Текст в объявлении после двоеточия определяет функциональные возможности элемента управления. Например, SharePoint:PlaceholderGlobalNavigation вставляет глобальную структуру навигации страницы SharePoint в соответствующие HTML-теги на этой странице. Элементы управления контентом на эталонной странице связывают заполнители контента с контентом посредством идентификатора ContentPlaceHolderID.

SharePoint предлагает два типа эталонных страниц: эталонные страницы системы и эталонные страницы сайта. Эталонные страницы системы применяются для всех страниц форм и представлений на сайте SharePoint, а эталонные страницы сайта используются всеми страницами на сайте публикации. Вы можете определить, какой тип master страницы использует сайт, открыв файл страницы .master и просмотрев директиву Page. Эталонная страница системы имеет директиву вида ~masterurl/default.master, а эталонная страница сайта — ~masterurl/custom.master.

Для настройки свойств эталонной страницы можно использовать код CSOM, в основном описывая объекты Web. Менять эталонную страницу системы можно с помощью свойства MasterUrl, а эталонную страницу сайта, используя свойство объекта CustomMasterUrl.

Заполнители контента часто содержат динамические маркеры — важные фрагменты кода, являющиеся частью URL-адреса страницы SharePoint. SharePoint анализирует строки URL-адреса согласно правилам протокола, например HTTP, которые определяют, как осуществляется передача гипертекстовой информации между сервером и страницей SharePoint. Обычно заполнитель контента, указывающий на таблицу CSS или элемент управления темой, использует соответствующий URL-адрес, который в серверной объектной модели SharePoint представлен в виде ~SPUrl.

SharePoint использует динамические маркеры для связи эталонной страницы со страницей контента, что определяется объявлением <asp:content> в коде страницы MASTER. В таблице 3 приведены динамические маркеры, которые находящиеся на эталонных страницах SharePoint, а также свойства CSOM, заменяющие их при обработке страницы, или форма строки URL-адреса, которую SharePoint отображает для этого заполнителя контента.

Табл. 3. Динамические токены на эталонных страницах и их замена значениями свойства

Динамический токен Замена
~masterurl/default.master SPWeb.MasterUrl
~masterurl/custom.master SPWeb.CustomMasterUrl
~site/<xyz>.master <http:// siteColl>/<subsite1>/<subsite2>/<xyz.master>
~sitecollection/<abc>.master <http:// siteColl>/<abc.master>

Примечание.

Динамические маркеры в заполнителях контента соответствуют свойствам и методам серверных API. При удаленной подготовке создавайте код на CSOM или REST. Дополнительные сведения о динамических маркерах и URL-адресах SharePoint см. в статье URL-адреса и маркеры в SharePoint. Надстройки SharePoint используют некоторые маркеры, применяемые к URL-адресам сайтов.

Вики-страницы и страницы веб-частей

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

  • Меню страницы веб-части, которое может использоваться для добавления или изменения веб-частей, макета страницы и переключения между личным и общим представлением.
  • Область инструментов, которая используется для того, чтобы находить и добавлять веб-части, а также редактировать свойства и страницы веб-частей.

По сравнению со страницами веб-частей вики-страницы менее структурированы. Из-за своей частичной структурированности или ее полного отсутствия они делают создание контента пользователями и их взаимодействие между собой проще. По умолчанию SharePoint отображает вики-страницу, когда вы в первый раз просматриваете новый сайт группы.

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

Для создания вики-страницы можно воспользоваться удаленной подготовкой. Класс WikiPageCreationInformation предоставляет методы, используемые для создания вики-страниц, а свойство WikiHtmlContent получает и задает HTML-контент на странице. Класс Utility включает в себя метод CreateWikiPageInContextWeb, используемый SharePoint для создания вики-страниц в контексте среды выполнения клиента, используя параметры из класса WikiPageCreationInformation.

Макеты страниц

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

Примечание.

Макеты страниц могут включать в себя зоны веб-частей.

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

В SharePoint типы контента — это повторно используемые коллекции метаданных (также известные как столбцы) и действий, которые определяют отдельные элементы и документы. Например, вы хотите создать контент, который выглядит и действует так, как (по вашему мнению) должна выглядеть и действовать статья в интернет-журнале. Типы контента предоставляют такую возможность. Возможно, вы также захотите создать другой уникальный контент, но с повторным совместным использованием характеристик одного типа контента в других. Каждый макет страницы основан строго на одном типе контента, каждому из которых присваиваются уникальные идентификаторы типов контента.

Дополнительные сведения о типах контента см. в следующих статьях:

Важно!

В настоящее время можно воспользоваться шаблоном удаленной подготовки для применения уже готовых макетов страниц к сайту SharePoint. Вы можете подготовить пользовательский тип контента на сайте, используя код CSOM с помощью пользовательских надстроек для кода SharePoint, и также поддерживается установка пользовательских идентификаторов ContentTypeId посредством CSOM в SharePoint Online. Однако установка идентификатора ContentTypeId для пользовательского контента при помощи удаленной подготовки на локальных сайтах SharePoint в настоящий момент не поддерживается. Дополнительные сведения см. в статье Создание макета страницы в SharePoint.

Модель обработки страниц SharePoint

SharePoint — это система отображения страниц на основе шаблонов, объединяющая эталонные страницы, страницы контента и авторский контент. Система отображения страниц также называется моделью обработки страниц. Эталонные страницы используются всеми экземплярами страниц на сайте, а страницы контента — всеми экземплярами страниц, основанных на данной странице.

Модель обработки страниц интерпретирует и выполняет все запросы, отправляемые на сервер агентами пользователя, например веб-браузером. Допустим, пользователь запрашивает страницу под названием contoso.aspx. Чтобы выполнить этот запрос, модуль ASP.NET извлекает две страницы: страницу контента, связанную с именем contoso.aspx, и эталонную страницу, которую поставщик файлов связал с сайтом SharePoint. Модуль также извлекает из полей элементы управления и веб-части, а затем отображает их на странице.

Примечание.

Логика обработки страниц для сайтов групп и сайтов аналогична сайтам публикации.

Обработка страниц

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

Когда пользователь SharePoint загружает вики-страницу (используя шаблон корпоративного вики-сайта на сайте группы или публикации), SharePoint анализирует путь к ее шаблону, контенту и контексту, а также настраивает связанный элемент управления макетом текста и заполняет корпоративную вики-страницу и макет текста контентом.

Дополнительные сведения о подготовке вики-страницы посредством шаблона удаленной подготовки см. в примере Provisioning.Pages.

Минимальная стратегия загрузки и <элементы управления AjaxDelta>

В SharePoint стратегия минимальной загрузки управляет тем, какой контент на эталонной странице необходимо обновить, прежде чем отобразить страницу. Если стратегия включена, содержимое, связанное с заполнителями контента, завернутыми в <SharePoint:AjaxDelta> теги на странице master, обновляется перед отрисовкой страницы. И наоборот: заполнители контента, которые не заключены в теги <SharePoint:AjaxDelta>, не отображаются при активированной стратегии минимальной загрузки.

Активировать или деактивировать стратегию минимальной загрузки можно с использованием центрального администрирования сайта или при помощи клиентской объектной модели (CSOM) SharePoint. Можно активировать эту функцию при помощи свойства EnableMinimalDownload.

Дополнительные сведения см. в статье Обзор стратегии минимальной загрузки. Дополнительные сведения об оптимизации работы эталонных страниц с активированной стратегией минимальной загрузки см. в статье Изменение компонентов SharePoint для MDS.

Стратегия минимальной загрузки в SharePoint по умолчанию активирована для сайтов групп и неактивна по умолчанию для сайтов публикации SharePoint и сайтов групп SharePoint с включенной функцией публикации.

Создание пользовательской эталонной на основе seattle.master

Можно использовать удаленную подготовку для элементов фирменной символики сайта, например тем, а также применять CSS или JavaScript, чтобы отображать или скрывать компоненты и элементы управления страницы. Пользовательская настройка эталонной страницы обеспечивает повышенную степень контроля над ее структурой. При создании пользовательской эталонной страницы не редактируйте и не сохраняйте эталонную страницу по умолчанию с существующим именем (например, seattle.master). Следует сделать копию эталонной страницы по умолчанию, которую вы хотите изменить, и переименовать ее.

Важно!

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

Для поддержки единообразия пользовательских эталонных страниц применяйте существующие шаблоны кодирования. Например, в областях страницы с таблицами повысьте надежность кода, применяя таблицы. В областях с тегами <DIV> или HTML5 сопоставьте пользовательский код с тегами <DIV> или HTML5. Придерживаясь этих правил, обслуживать создаваемые пользовательские эталонные страницы в долгосрочной перспективе будет проще, а значит — дешевле.

См. также