Добавление фрагмента кода зоны веб-частей в SharePoint
Важно!
Такая расширяемость доступна только для классического интерфейса SharePoint. Эту возможность нельзя использовать вместе с современным интерфейсом в SharePoint Online, например на сайтах для общения. Мы больше не рекомендуем использовать классический интерфейс и эти методы применения фирменной символики.
Зона веб-частей — это фрагмент кода, который можно добавить в макет страницы, чтобы авторы контента могли добавлять, редактировать и удалять веб-части в этой зоне.
Общие сведения о фрагменте кода зоны веб-частей
Веб-часть — это серверный элемент управления, предоставляющий определенную часть функций SharePoint, а зона веб-части — это контейнер, определяющий макет, поведение и другие свойства веб-частей, содержащихся в этой зоне. Например, зона веб-частей может указать, будут ли веб-части в зоне:
- упорядочены по горизонтали или по вертикали;
- отображать распространенные элементы пользовательского интерфейса, например строку заголовка или границу;
- доступны для настройки авторами контента при редактировании страницы в браузере;
- доступны для персонализации посетителями сайта, которые создают личное представление веб-части при просмотре страницы в браузере.
При публикации сайта авторы контента с необходимыми разрешениями можно создавать или изменять страницы, которые находятся в библиотеке страниц. Как конструктор вы можете добавить зону веб-части в макет страницы. Когда автор содержимого создает или изменяет страницу на основе этого макета страницы, автор может добавлять, изменять или удалять веб-части в этой зоне. Например, можно добавить зону веб-частей в макет страницы, чтобы авторы содержимого могли:
- Отображение результатов поискового запроса с помощью веб-части "Поиск контента". Авторы могут обновлять или изменять поисковый запрос, если веб-часть, управляемая поиском, находится в зоне веб-части.
- встраивать видеоролики и аудиофайлы в веб-страницу с помощью веб-части "Мультимедиа";
- создавать списки гиперссылок, которые легко редактировать, группировать и упорядочивать, с помощью веб-части "Сводная ссылка";
- создать карту сайта, которая содержит список всех страниц на сайте и автоматически обновляется при добавлении, удалении, переименовании или перемещении страницы, с помощью веб-части "Оглавление".
Когда использовать зоны веб-частей
Если макет страницы включает одну или несколько зон веб-частей, зоны веб-частей доступны на всех страницах, использующих этот макет, что позволяет авторам вставлять веб-части на эти страницы. Если разрешить авторам вставлять веб-части на страницы, вы уменьшите контроль над взаимодействием пользователей с сайтом. Например, автор может вставить веб-часть "Оглавление" на страницу, которая предоставляет части сайта, к которым вы не хотите, чтобы посетители переходили с текущей страницы.
Если требуется полный контроль над тем, как веб-часть отображается на сайте, и если вы хотите, чтобы эта веб-часть отображалась на всех страницах определенного типа, добавьте ее непосредственно в макет страницы. Если вы хотите, чтобы веб-часть отображалась на всех страницах сайта, вы также можете добавить веб-часть непосредственно на страницу master.
Примечание.
Зоны веб-частей доступны на макетах страниц, но недоступны на эталонных страницах — зоны позволяют авторам изменять веб-части, а авторы обычно не изменяют эталонную страницу.
Вы также можете добавить зоны веб-частей в макет страницы, но ограничить их использование. Например, можно добавить веб-части в зону, а затем задать свойство этой зоны, чтобы авторы содержимого могли изменять свойства существующих веб-частей, но не добавлять или удалять веб-части из зоны. Зоны веб-частей имеют набор свойств, которые служат двойной цели. Для организации макета и формата веб-частей на странице можно использовать одно подмножество свойств. Вы можете использовать другое подмножество свойств, чтобы обеспечить дополнительный уровень защиты от изменения (или блокировки) веб-частей в зоне.
Для различных уровней контроля над внешним видом веб-частей на сайте вы можете:
- Добавьте веб-части непосредственно в master страницу или макет страницы. Это означает, что авторы содержимого не могут изменять веб-части.
- добавить веб-части к зонам на макетах страниц, но ограничить эти зоны только веб-частями по умолчанию, которые вы добавляете;
- добавить зоны веб-частей на макеты страниц и предоставить авторам контента полный контроль над внешним видом и конфигурацией веб-частей в этих зонах.
Свойства зоны веб-частей могут указывать, разрешается ли авторам контента изменять:
- макеты веб-частей в зоне путем добавления, удаления, изменения размеров и перемещения веб-частей;
- параметры веб-частей для всех пользователей (общее представление веб-части);
- личные параметры веб-частей (личное представление веб-части).
В таблице 1 перечислены важные свойства, которые следует учитывать, если требуется ограничить зону веб-частей.
Таблица 1. Свойства зоны веб-частей, используемые для ограничения авторов содержимого
| Имя свойства | Описание |
|---|---|
| AllowLayoutChange | Указывает, можно ли закрывать, сворачивать, удалять и восстанавливать веб-части в зоне. Если задано значение False, пользователи не могут закрывать, сворачивать, удалять или восстанавливать веб-части в зоне, перетаскивать веб-части в другую зону, а также переупорячивать или перемещать веб-части в пределах зоны. Пользователи также не могут добавлять веб-части из каталога веб-частей, а некоторые свойства, влияющие на пользовательский интерфейс веб-частей в зоне, отключены. Это свойство не влияет на возможность менять макет программным образом. Если задано значение True, то пользователи с соответствующими разрешениями могут выполнять эти действия. |
| LockLayout | Указывает, можно ли добавлять, удалять, изменять размер или перемещать веб-части в пределах зоны. Это свойство работает одинаково, независимо от того, находится ли страница веб-части в личном или общем представлении. Если задано значение True, определенные свойства веб-части для каждой затронутой веб-части в зоне: Zone (ZoneID),Part Order (PartOrder), Visible on Page (IsVisible), Height (Height), Width (Width), Allow Close (AllowRemove) и IsIncluded ( команда Закрыть в меню веб-части ). Другие свойства веб-части не затрагиваются. Если задано значение False, то свойства веб-частей указывают, можно ли выполнять изменения (а также соответствующие разрешения на сайте). |
| AllowCustomization | Указывает, можно ли изменять значения общих свойств веб-частей в зоне. Если задано значение True, то пользователи с соответствующими разрешениями могут изменять веб-части в зоне для всех пользователей. Если задано значение False, пользователи не смогут вносить изменения в веб-части в зоне пользовательского интерфейса в общем представлении. Но изменения по-прежнему можно вносить программными средствами и с помощью страницы обслуживания веб-части. |
| AllowPersonalization | Указывает, можно ли изменять значения личных свойств веб-частей в зоне. Если задано значение True, то пользователи с соответствующими разрешениями могут выполнять личные изменения веб-частей в зоне. Если задано значение False, то пользователи не могут выполнять изменения веб-частей через пользовательский интерфейс, если эта веб-часть не является личной и у них нет соответствующих разрешений. |
Примечание.
Вам не удастся вставить зону веб-частей на панели канала устройства. Если вы хотите, чтобы авторы могли добавлять веб-части на страницу, и вас не беспокоит "вес" страницы для мобильных устройств, вы можете добавить поле страницы "Редактор форматированного текста" на панель канала устройства, а затем сообщить авторам, что веб-части следует добавлять туда. Вы можете добавлять веб-части непосредственно на панель канала устройства (без зоны веб-частей). Дополнительные сведения см. в статье Практическое руководство. Добавление фрагмента панели каналов устройств в SharePoint.
Вставка фрагмента кода зоны веб-частей
Как и все фрагменты, этот фрагмент добавляется из коллекции. Чтобы перейти в коллекцию фрагментов, необходимо сначала выбрать макет страницы для редактирования. Зоны веб-частей можно добавлять в макеты страниц, но нельзя добавлять в master страницы.
Вставка фрагмента кода зоны веб-частей
Перейдите на сайт публикации.
Нажмите значок шестеренки "Параметры" в правом верхнем углу страницы, а затем выберите Дизайнер.
В Дизайнере в левой области панели навигации выберите команду Изменить макеты страниц.
Выберите имя макета страницы, к которому нужно добавить фрагмент.
Чтобы открыть коллекцию фрагментов, выберите Фрагменты в правом верхнем углу страницы предварительного просмотра на стороне сервера.
На вкладке Конструктор ленты щелкните Зона веб-частей.
В разделе Об этом компоненте в правой части коллекции фрагментов щелкните или выберите заголовок раздела, чтобы развернуть или свернуть группу свойств, а затем настройте все нужные настраиваемые параметры.
Раздел, с именем важные содержит свойства, которые являются ключом к принципы работы этого конкретного фрагмента. Для зоны веб-части фрагмент имеет уникальный идентификатор. После копирования фрагмента на макет страницы не следует повторно использовать этот идентификатор. Если вы хотите добавить еще один фрагмент зоны веб-части, нажмите кнопку Обновить , чтобы создать новый идентификатор для следующего фрагмента.
Описания свойств, необходимых для ограничения возможностей зоны веб-частей (LockLayout, AllowCustomization и AllowPersonalization), см. в таблице 1.
Примечание.
Вы можете заметить, что некоторые имена свойств выделены полужирным шрифтом в сетке свойств коллекции фрагментов. Эти свойства имеют значения, которые были изменены по сравнению с параметром по умолчанию для этого компонента, но эти свойства не обязательно относятся к сценарию конструктора. Другими словами, свойство может быть полужирным, но не обязательно важным для вашего сценария.
Настроив свойства, нажмите Обновить. При этом обновляется фрагмент HTML в левой части страницы, чтобы разметка отражала настраиваемые параметры. Всегда можно сбросить для возврата всех свойств к значениям по умолчанию.
В разделе Фрагмент HTML в левой части коллекции фрагментов выберите команду Копировать в буфер обмена.
В редакторе HTML откройте сопоставленный сетевой диск на своем компьютере, а затем откройте HTML-файл для эталонной страницы или макета, к которым добавляется фрагмент.
Дополнительные сведения см. в разделе Практическое руководство. Сопоставление сетевого диска с коллекцией главных страниц SharePoint.
Вставьте фрагмент в том месте HTML-файла, где должна отображаться разметка.
При добавлении фрагмента к макету страницы необходимо добавить его в блок PlaceHolderMain.
Замените
<div>в разделеclass="DefaultContentBlock"собственным контентом.Если вам нужно предварительно заполнить зону веб-частями (например, если в зоне авторам контента разрешено только изменять существующие веб-части и запрещено создавать их), вставьте фрагменты кода веб-частей после тега .
Сохраните страницу, а затем обновите страницу предварительного просмотра на стороне сервера в Дизайнере, чтобы страница приняла ожидаемый вид.
Сведения о разметке фрагментов
Двумя наиболее важными частями фрагмента зоны веб-части являются свойство ID и комментарий. У каждой зоны должен быть уникальный идентификатор. Если вы хотите добавить несколько зон веб-частей в макет страницы, обязательно выберите Обновить в коллекции фрагментов, прежде чем копировать каждый фрагмент, чтобы создать новый идентификатор. Комментарий следует заменить любыми веб-частями, которые по умолчанию должны отображаться в зоне.
Дополнительные свойства, которые позволяют ограничить использование зон авторами контента ( AllowCustomization, AllowPersonalization и LockLayout), приводятся в следующем коде.
Примечание.
Свойства AllowCustomization, AllowPersonalization и LockLayout отображаются в разметке, только если изменить их значения по умолчанию в сетке свойств.
<div data-name="WebPartZone">
<!--CS: Start web part zone Snippet-->
<!--SPM:<%@Register Tagprefix="WebPartPages" Namespace="Microsoft.SharePoint.WebPartPages" Assembly="Microsoft.SharePoint, Version=15.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c"%>-->
<div xmlns:ie="ie">
<!--MS:<WebPartPages:WebPartZone runat="server" ID="x0e5f5212505f48a9aac43df13eeae4f9" AllowCustomization="True" AllowPersonalization="False" FrameType="TitleBarOnly" LockLayout="True" Orientation="Vertical">-->
<!--MS:<ZoneTemplate>-->
<!--DC: Replace this comment with default web parts for new pages. -->
<!--ME:</ZoneTemplate>-->
<!--ME:</WebPartPages:WebPartZone>-->
</div>
<!--CE: End web part zone Snippet-->
</div>