Adicionar um trecho da zona de web part do Microsoft Office SharePoint Online
Importante
Essa opção de extensibilidade está disponível apenas para experiências clássicas do SharePoint. Você não pode usar essa opção com experiências modernas no SharePoint Online, como nos sites de comunicação. Não é mais recomendável o uso da experiência clássica ou destas técnicas de identidade visual.
Uma zona de web part é um trecho de código que pode ser adicionado a um layout de página para que os autores de conteúdo possam adicionar, editar ou excluir web parts nessa zona.
Introdução ao trecho de zona de web part
Uma web part é um controle de servidor que fornece um segmento específico de funcionalidade do SharePoint, e uma zona de web part é um contêiner que determina o layout, comportamento e outras propriedades das web parts contidas nessa zona. Por exemplo, uma zona de web part pode especificar se as web parts na zona:
- São organizadas em um layout horizontal ou vertical.
- Exibe os elementos da interface (UI) do usuário comuns, como uma barra de título ou a borda.
- Pode ser personalizado por autores de conteúdo quando eles edita uma página no navegador.
- Podem ser personalizadas por visitantes do site que criarem uma exibição pessoal de uma web part ao exibir uma página no navegador.
Em um site de publicação, os autores de conteúdo com as permissões necessárias podem criar ou editar páginas que se encontram na Biblioteca de páginas. Como designer, você pode adicionar uma zona de web part a um layout de página. Quando um autor de conteúdo cria ou edita uma página com base no layout da página, ele pode adicionar, editar ou excluir web parts nessa zona. Por exemplo, convém adicionar uma zona de web part a um layout de página para que os autores de conteúdo possam:
- Exibir os resultados de uma consulta de pesquisa usando uma web part de Pesquisa de conteúdo. Os autores podem atualizar ou modificar a consulta de pesquisa, quando uma pesquisa orientada pelo web part reside dentro de uma zona de web part.
- Incorporar clipes de vídeo ou áudio em uma página da Web usando uma web part de Mídia.
- Criar listas de hiperlinks que são facilmente editados, agrupados ou reorganizados usando uma web part de Link de resumo.
- Criar um mapa do site que lista todas as páginas em um site e que é atualizado automaticamente sempre que uma página é adicionada, excluída, renomeada ou movida usando uma web part de Sumário.
Quando usar zonas de web part
Quando um layout de página inclui uma ou mais zonas de web part, as zonas de web part estão disponíveis em todas as páginas que usam esse layout, permitindo que os autores insiram web parts nessas páginas. Se você permitir que os autores insiram web parts em páginas, você poderá reduzir o controle sobre a experiência dos usuários no site. Por exemplo, um autor pode inserir uma web part de Sumário em uma página que expõe partes do site aos quais você não deseja que os visitantes possam navegar a partir da página atual.
Se quiser ter o controle completo sobre como uma web part aparece em seu site e se quiser que essa web part apareça em todas as páginas de determinado tipo, adicione a web part diretamente a um layout de página. Se você quiser que uma web part apareça em todas as páginas em um site, você também poderá adicioná-la diretamente a uma página mestra.
Observação
As zonas de web parts estão disponíveis em layouts de página, mas não em páginas mestras; o propósito das zonas é permitir que os autores possam modificar as web parts e, geralmente, eles não editam uma página mestra.
Você também pode adicionar zonas de web part a um layout de página, mas restringindo seu uso. Por exemplo, você pode adicionar web parts a uma zona e, em seguida, definir uma propriedade de zona, para que os autores de conteúdo possam editar as propriedades de web parts existentes, mas não adicionar ou remover web parts da zona. As zonas de web parts têm um conjunto de propriedades que atendem a uma finalidade dupla. Você pode usar um subconjunto de propriedades para organizar o layout e o formato das web parts na página. Você pode usar outro subconjunto de propriedades para fornecer um nível adicional de proteção contra modificação (ou "bloqueio") das web parts dentro da zona.
Para ter vários níveis de controle sobre como as web parts são apresentadas em seu site, você pode:
- Adicionar web parts diretamente a uma página mestra ou layout de página. Isso significa que os autores de conteúdo não podem modificar as web parts.
- Adicionar web parts a zonas em layouts de página, mas restringir as zonas somente as web parts padrão que você adicionar.
- Adicionar zonas de web part a layouts de página e conceder controle total sobre quais web parts aparecem nessas zonas e como elas são configuradas pelos autores de conteúdo.
As propriedades de uma zona de web part podem especificar se os autores de conteúdo têm permissão para alterar:
- O layout das web parts na zona, adicionando, excluindo, redimensionando ou movendo as web parts.
- As configurações de web part para todos os usuários (a exibição compartilhada de uma web part).
- As configurações de web part pessoais (a exibição pessoal de uma web part).
A tabela 1 mostra propriedades importantes que deverão ser consideradas se você quiser restringir uma zona de web part.
Tabela 1. Propriedades da zona da Web part usadas para restringir autores de conteúdo
| Nome da propriedade | Descrição |
|---|---|
| AllowLayoutChange | Especifica se as web parts dentro da zona podem ser fechadas, minimizadas, excluídas ou restauradas. Se definido como False, os usuários não poderão fechar, minimizar, excluir ou restaurar web parts na zona, arrastar as web parts para outra zona nem reorganizar ou mover web parts dentro da zona. Os usuários também não poderão adicionar web parts do catálogo de web parts, e várias propriedades que afetam a interface do usuário de web parts na zona serão desabilitadas. Essa propriedade não afeta a capacidade de alterar o layout de forma programática. Se definido como True, os usuários com permissões apropriadas pode executar essas ações. |
| LockLayout | Especifica se as web parts dentro da zona pode ser adicionadas, excluídas, redimensionadas ou movidas. Essa propriedade funcionará da mesma forma se a página de web part estiver em modo de exibição pessoal ou compartilhada. Se definido como True, as propriedades específicas de web part para cada web part na zona que é afetada serão: Zona (ZoneID), Ordem de parte (PartOrder), Visível na página (IsVisible), Altura (Height), Largura (Width), Permitir fechamento (AllowRemove) e IsIncluded (o comando Fechar no menu web part). Outras propriedades da web part não serão afetadas. Se for definido como False, as propriedades de web part determinarão se as modificações podem ser feitas (juntamente com as permissões de site apropriadas). |
| AllowCustomization | Especifica se os valores de propriedade compartilhados de web parts dentro da zona podem ser modificados. Se definido como True, os usuários com permissões apropriadas podem fazer alterações nas web parts na zona para todos os usuários. Se definido como False, os usuários não podem fazer alterações nas web parts na zona na interface do usuário na exibição compartilhada. Mas as alterações ainda podem ser feitas por programação e usando a página de Manutenção de web parts. |
| AllowPersonalization | Especifica se os valores de propriedade pessoal de web parts dentro da zona podem ser modificados. Se definida como True, os usuários com as permissões apropriadas podem fazer alterações pessoais nas web parts na zona. Se definido como False, os usuários não podem fazer alterações pessoais nas web parts por meio da interface de usuário, a menos que a web part seja uma web part particular e eles tenham as permissões apropriadas. |
Observação
Não é possível inserir uma zona de web part dentro de um Painel de Canais de Dispositivos. Se você quiser permitir que os autores adicionem web parts a uma página e se não estiver preocupado com o peso da página para dispositivos móveis, poderá adicionar um campo de página do Editor de Rich Text a um Painel de Canais de Dispositivos e, em seguida, instruir os autores a adicionarem as web parts ali. Você pode adicionar web parts diretamente a um Painel de Canais de Dispositivos (sem uma zona de web part). Para obter mais informações, consulte Como adicionar um snippet do Painel do Canal do Dispositivo no SharePoint.
Inserir um trecho de zona de web part
Como todos trechos de código, você pode adicionar este trecho da Galeria trecho. Para navegar na Galeria de trecho de código, você deve primeiro selecionar um layout de página para editar. As zonas de web parts podem ser adicionadas aos layouts de página, mas não podem ser adicionadas às páginas mestras.
Para inserir um trecho de zona de web part
Navegue até o seu site de publicação.
No canto superior direito da página, escolha engrenagem as configurações e clique em Gerenciador de Design.
No Gerenciador de Design, no painel de navegação à esquerda, escolha Editar Layouts de Página.
Selecione o nome do layout de página que você deseja adicionar o trecho de código para.
Para abrir a Galeria de trechos, escolha trechos no canto superior direito da visualização do servidor.
Na faixa de opções, na guia Design, escolha a zona de web part.
No lado direito da Galeria trecho, sob sobre este componente, clique ou selecione cabeçalhos de seção para expandir ou recolher grupos de propriedades e, em seguida, configure quaisquer configurações personalizadas que você deseja.
A seção denominada importante contém as propriedades que são fundamentais para como funciona a esse trecho específico. Para uma zona de web part, o trecho tem uma identificação exclusiva. Depois de copiar o trecho para o layout da página, você não deve reutilizar essa identificação. Se você deseja adicionar outro trecho de zona de web part, escolha Atualizar para gerar uma nova identificação para o próximo trecho.
Para obter descrições das propriedades que são necessárias para restringir uma web part de zona (LockLayout, AllowCustomization e AllowPersonalization), confira a tabela 1.
Observação
[!OBSERVAçãO] Você pode observar que alguns nomes de propriedade estão em negrito na grade de propriedades da Galeria trecho. Essas propriedades têm valores que foram alterados da configuração padrão para este componente, mas essas propriedades não são necessariamente relevantes para um cenário de designer. Em outras palavras, uma propriedade pode ser negrito, mas não necessariamente importantes para seu cenário.
Depois de configurar todas as propriedades, escolha a atualização. Isso atualiza o trecho de código HTML no lado esquerdo da página, para que a marcação reflete suas configurações personalizadas. Você sempre pode escolher Redefinir para retornar todas as propriedades para suas configurações padrão.
No lado esquerdo da Galeria trecho, sob Trecho HTML, escolha Copiar para área de transferência.
No seu editor de HTML, abra a unidade de rede mapeada no seu computador e abra o arquivo HTML para a página mestra ou layout de página que você está adicionando o trecho de código para.
Para obter mais informações, consulte Como mapear uma unidade de rede para a Galeria de Páginas Mestras do SharePoint.
No arquivo HTML, cole o trecho de onde você deseja que a marca seja exibida.
Quando você estiver adicionando o trecho de código a um layout de página, certifique-se colar o trecho de PlaceHolderMain.
Substituir o
<div>ondeclass="DefaultContentBlock"com seu próprio conteúdo específico.Se você deseja preencher previamente a zona com web parts, por exemplo, se a zona restringir os autores de conteúdo a modificar somente as web parts existentes e não adicionar novas, insira os trechos de web part onde a marca é exibida.
Salve a página e, em seguida, atualize a visualização do lado do servidor no Gerenciador de Design para garantir que a página apareça conforme o esperado.
Como entender as marcações de trecho
As duas partes mais importantes de um trecho de zona de web part são a propriedade ID e o comentário . Cada zona deve ter uma identificação exclusiva. Se você deseja adicionar mais de uma zona de web part em seu layout de página, certifique-se de escolher Atualizar na Galeria de Trechos antes de copiar cada trecho para que uma nova ID seja gerada. O comentário deverá ser substituído por qualquer web part que você queira que apareça na zona por padrão.
Propriedades adicionais que podem ser usadas para restringir como o conteúdo que os autores podem usar as zonas ( AllowCustomization, AllowPersonalizatione LockLayout) são mostradas no código a seguir.
Observação
As propriedades de AllowCustomization, AllowPersonalizatione LockLayout aparecem na marcação apenas se você alterar os valores padrão na grade de propriedades.
<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>