Добавление фрагмента кода зоны веб-частей в SharePoint

Такая расширяемость доступна только для классического интерфейса SharePoint. Эту возможность нельзя использовать вместе с современным интерфейсом в SharePoint Online, например на сайтах для общения. Мы больше не рекомендуем использовать классический интерфейс и эти методы применения фирменной символики.

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

Общие сведения о фрагменте кода зоны веб-частей

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

упорядочены по горизонтали или по вертикали;

отображать распространенные элементы пользовательского интерфейса, например строку заголовка или границу;

доступны для настройки авторами контента при редактировании страницы в браузере;

доступны для персонализации посетителями сайта, которые создают личное представление веб-части при просмотре страницы в браузере.

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

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

встраивать видеоролики и аудиофайлы в веб-страницу с помощью веб-части "Мультимедиа";

создавать списки гиперссылок, которые легко редактировать, группировать и упорядочивать, с помощью веб-части "Сводная ссылка";

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

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

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

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

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

Для различных уровней контроля над внешним видом веб-частей на сайте вы можете:

добавить веб-части непосредственно на эталонную страницу или макет страницы. Это означает, что авторы контента не могут изменять веб-части;

добавить веб-части к зонам на макетах страниц, но ограничить эти зоны только веб-частями по умолчанию, которые вы добавляете;

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

Свойства зоны веб-частей могут указывать, разрешается ли авторам контента изменять:

макеты веб-частей в зоне путем добавления, удаления, изменения размеров и перемещения веб-частей;

параметры веб-частей для всех пользователей (общее представление веб-части);

личные параметры веб-частей (личное представление веб-части).

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

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

Имя свойства Описание AllowLayoutChange Указывает, можно ли закрывать, сворачивать, удалять и восстанавливать веб-части в зоне. Если задано значение False (Ложь), то пользователи не могут закрывать, сворачивать, удалять и восстанавливать веб-части в зоне, перетаскивать веб-части и другие зоны, а также перемещать веб-части и менять их местами. Пользователи также не могут добавлять веб-части из каталога, а несколько свойств, влияющих на пользовательский интерфейс веб-частей в зоне, отключены. Это свойство не влияет на возможность менять макет программным образом. Если задано значение True, то пользователи с соответствующими разрешениями могут выполнять эти действия. LockLayout Указывает, можно ли добавлять, удалять и перемещать веб-части в зоне, а также менять их размеры. Если задано значение True, то будут затронуты следующие свойства каждой веб-части в зоне: Зона (ZoneID), Порядок частей (PartOrder), Видимость на странице (IsVisible), Высота (Height), Ширина (Width), Разрешить закрытие (AllowRemove) и IsIncluded (команда Закрыть в меню Веб-часть). Остальные свойства веб-частей остаются без изменений. Если задано значение False, то свойства веб-частей указывают, можно ли выполнять изменения (а также соответствующие разрешения на сайте). AllowCustomization Указывает, можно ли изменять значения общих свойств веб-частей в зоне. Если задано значение True, то пользователи с соответствующими разрешениями могут изменять веб-части в зоне для всех пользователей. Если задано значение False, то пользователи не могут изменять веб-части в зоне пользовательского интерфейса в общем представлении. Тем не менее, эти изменения можно выполнить программным способом и на странице "Управление веб-частями". AllowPersonalization Указывает, можно ли изменять значения личных свойств веб-частей в зоне. Если задано значение True, то пользователи с соответствующими разрешениями могут выполнять личные изменения веб-частей в зоне. Если задано значение False, то пользователи не могут выполнять изменения веб-частей через пользовательский интерфейс, если эта веб-часть не является личной и у них нет соответствующих разрешений.

Вам не удастся вставить зону веб-частей на панели канала устройства. Если вы хотите, чтобы авторы могли добавлять веб-части на страницу, и вас не беспокоит "вес" страницы для мобильных устройств, вы можете добавить поле страницы "Редактор форматированного текста" на панель канала устройства, а затем сообщить авторам, что веб-части следует добавлять туда. Вы можете добавлять веб-части непосредственно на панель канала устройства (без зоны веб-частей). Дополнительные сведения см. в статье Добавление фрагмента кода панели канала устройства в SharePoint.

Вставка фрагмента кода зоны веб-частей

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

Перейдите на сайт публикации.

Нажмите значок шестеренки "Параметры" в правом верхнем углу страницы, а затем выберите Дизайнер.

В Дизайнере в левой области панели навигации выберите команду Изменить макеты страниц.

Выберите имя макета страницы, к которому нужно добавить фрагмент.

Чтобы открыть коллекцию фрагментов, выберите Фрагменты в правом верхнем углу страницы предварительного просмотра на стороне сервера.

На вкладке Конструктор ленты щелкните Зона веб-частей.

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

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

Описания свойств, необходимых для ограничения возможностей зоны веб-частей (LockLayout, AllowCustomization и AllowPersonalization), см. в таблице 1.

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

Настроив свойства, нажмите Обновить. При этом обновляется фрагмент HTML в левой части страницы, чтобы разметка отражала настраиваемые параметры. Вы всегда можете нажать кнопку Сбросить, чтобы восстановить исходные значения всех свойств.

В разделе Фрагмент HTML в левой части коллекции фрагментов выберите команду Копировать в буфер обмена.

В редакторе HTML откройте сопоставленный сетевой диск на своем компьютере, а затем откройте HTML-файл для эталонной страницы или макета, к которым добавляется фрагмент.

Вставьте фрагмент в том месте HTML-файла, где должна отображаться разметка.

При добавлении фрагмента к макету страницы необходимо добавить его в блок PlaceHolderMain.

Если вам нужно предварительно заполнить зону веб-частями (например, если в зоне авторам контента разрешено только изменять существующие веб-части и запрещено создавать их), вставьте фрагменты кода веб-частей после тега .

Сохраните страницу, а затем обновите страницу предварительного просмотра на стороне сервера в Дизайнере, чтобы страница приняла ожидаемый вид.

Сведения о разметке фрагментов

Две самые важные части фрагмента кода зоны веб-частей — свойство ID и комментарий . У каждой зоны должен быть уникальный идентификатор. Если вам нужно добавить несколько веб-частей в макет страницы, обязательно нажимайте кнопку Обновить в коллекции фрагментов кода перед копированием каждого фрагмента, чтобы создать идентификатор. Комментарий необходимо заменить веб-частями, которые должны отображаться в зоне по умолчанию.

Дополнительные свойства, которые позволяют ограничить использование зон авторами контента ( AllowCustomization, AllowPersonalization и LockLayout), приводятся в следующем коде.

Свойства AllowCustomization, AllowPersonalization и LockLayout отображаются в разметке, только если изменить их значения по умолчанию в сетке свойств.