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

Как добавить фрагмент кода "Панель канала устройства" в SharePoint

  • Статья

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

Общие сведения о фрагменте панели каналов устройств

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

Возможно наиболее распространенные сценарии для использования каналов устройств будет выборочно включают части макета страницы для конкретных каналов. Например имеется макет страницы с отдельных текстовых полей для длинный приветственное сообщение и короткий приветствие. Размещая поля страниц внутри каналов устройств, вы можете отобразить короткий приветствие только для телефонов и много приветствие только к рабочему столу. Содержимое панели каналов устройств не отображается на каналы не включены — на самом деле содержимое не отображается, что не позволяет байт переход по сети. По этой причине использование панелей каналов устройств является лучшим способом отображения содержимого на определенных каналах, чем использование класса CSS с Display:None , так как панели каналов устройств помогают уменьшить вес страницы для определенного канала.

Можно также использовать каналов устройств на главных страницах. Например при наличии главной страницы, который может принимать два разных устройства (или две различных браузерах) с помощью только минимальными изменениями каналов устройств можно использовать Чтобы удерживать содержимое на главную страницу, относящуюся к любой из этих устройств.

Существует два ограничения с использованием панели каналов устройств.

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

Вставка фрагмента панели каналов устройств

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

Чтобы вставить фрагмент панели каналов устройств

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

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

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

  4. Выберите имя главной страницы или макет страницы, который вы хотите добавить фрагмент для.

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

  6. На ленте перейдите на вкладку Конструктор выберите пункт Панель канала устройств.

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

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

    Примечание.

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

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

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

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

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

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

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

  12. Замените <div> в разделе class="DefaultContentBlock" собственным контентом.

    Как правило при добавлении в макет страниц панели каналов устройств, замените <div>, скопировав поля страниц в панели.

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

    Для предварительного просмотра на разных каналах панели, можно добавить параметры строки запроса URL-адрес. Например, можно добавить переменную "DeviceChannel=YourChannelAlias" строки запроса к URL-адресу любой страницы в предварительном просмотре на стороне сервера.

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

Два наиболее важные части панели каналов устройств фрагмент, свойство IncludedChannels и <div> где class="DefaultContentBlock". По умолчанию свойство IncludedChannels будет пустым. В разделе важные сетка свойств, необходимо ввести псевдонимы, разделенных запятыми, которые вы хотите отобразить контент этой панели каналов устройств.

Примечание.

[!Примечание] Чтобы изменить псевдоним в списке устройств, каналы, необходимо изменить то псевдоним там, где он находится в разметке, в том числе в свойстве IncludedChannels для каждой панели канала устройств, который использует этот псевдоним.

<div>, где class="DefaultContentBlock" должно быть заменено независимо от определенного содержимого, вы должны отображаться включены каналов. На панели каналов устройств может включать почти любой тип контента, включая ссылку на файл CSS или JS-файла. Наиболее распространенные сценарии для использования каналов устройств — для добавления определенных параметров страницы полей из макета страницы для конкретных каналов. В этом случае необходимо скопировать разметки поля страницы, положение <div> внутри панели каналов устройств.

<div data-name="DeviceChannelPanel">
    <!--CS: Start Device Channel Panel Snippet-->
    <!--SPM:<%@Register Tagprefix="Publishing" Namespace="Microsoft.SharePoint.Publishing.WebControls" Assembly="Microsoft.SharePoint.Publishing, Version=15.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c"%>-->
    <!--MS:<Publishing:DeviceChannelPanel runat="server" IncludedChannels="MyPhoneChannel, MyTabletChannel">-->
        <!--PS: Start of READ-ONLY PREVIEW (do not modify)--><!--PE: End of READ-ONLY PREVIEW-->
       <div class="DefaultContentBlock" style="border:medium black solid; background:yellow; color:black; margin:20px; padding:10px;">
        You should replace this div with content that renders based on your Device Channel Panel Properties.
        </div>
        <!--PS: Start of READ-ONLY PREVIEW (do not modify)--><!--PE: End of READ-ONLY PREVIEW-->
    <!--ME:</Publishing:DeviceChannelPanel>-->
    <!--CE: End Device Channel Panel Snippet-->
</div>

См. также