Partilhar via

Páginas do SharePoint e o modelo de página

  • Artigo

Este artigo fornece uma visão geral do modelo de página do SharePoint, incluindo os tipos de página, os arquivos de página padrão disponíveis no SharePoint e no SharePoint Online e informações sobre como as páginas são processadas.

Uma página renderizada do SharePoint é uma combinação de três tipos de página:

  • Página mestra – controla o layout e a aparência do conteúdo

  • Página conteúdo – contém os controles de campo de página

  • Página de criação amigável ao usuário – em que o usuário adiciona conteúdo

Termos e conceitos

Tabela 1. Principais termos e conceitos relacionados ao modelo de página do SharePoint

Termo ou conceito Definição Acesso via Mais informações
Site de colaboração Um site de equipe.
Espaço reservado de conteúdo Uma entrada em uma página mestra que reserva um espaço para controles ou conteúdo que podem ser substituídos posteriormente por meio de programação. Todas as páginas mestras do SharePoint Os espaços reservados para conteúdo são os blocos de construção das páginas mestras do SharePoint.
Página mestra Uma página que padroniza o comportamento e a apresentação dos elementos de navegação esquerda e superior de uma página do SharePoint. Galeria de Páginas Mestras do sistema de arquivos do SharePoint
Galeria de páginas mestras Biblioteca de documentos especial no SharePoint, em que todos os elementos de identidade visual (páginas mestras, layouts de página, arquivos JavaScript, CSS e imagens) são armazenados por padrão. Cada site tem sua própria Galeria de Páginas Mestras. Configurações > Páginas Mestras de Configurações > do Site e Layouts de Página A Galeria de Páginas Mestras contém catálogos que armazenam recursos de identidade visual, como páginas mestras e arquivos CSS.

Dica: ao criar elementos de identidade visual personalizados, armazene ativos personalizados na estrutura de arquivos padrão da Galeria de Páginas Mestras.

Páginas mestras, Galeria de Páginas Mestras e layouts do SharePoint
Estratégia de Download Mínimo (MDS) Uma estratégia que reduz a quantidade de dados que o navegador deve baixar quando os usuários navegam de uma página do SharePoint para outra. Configurações do site Quando o MDS está ativo, o SharePoint passa todas as solicitações de /_layouts/15/start.aspx página e verifica as diferenças visuais entre novas solicitações de página e a página carregada anteriormente.

- Otimizar desempenho de página no SharePoint
- Visão geral da Estratégia de Download Mínimo
Navegação Funcionalidade que permite aos usuários movimentarem-se pela arquitetura de informações de um site do SharePoint. Os elementos de navegação no SharePoint incluem pesquisa, controles de árvore, botões, a faixa de opções, hiperlinks, guias, menus e taxonomia. - Classe de navegação
- Classe NavigationNode
Mestra Oslo Uma página mestra padrão do SharePoint. Galeria de Páginas Mestras do sistema de arquivos do SharePoint Diferente da página mestra seattle.master, a navegação atual está na mesma posição que a área de navegação superior.
Controle de conteúdo de página Um controle em um site de publicação em que uma Web Part pode ser adicionada.
Layout de página Um modelo aplicado a uma página de publicação, o que impõe consistência na apresentação do conteúdo. Galeria de Páginas Mestras do sistema de arquivos do SharePoint Crie um layout de página no SharePoint
Modelo de página Os arquivos, conteúdo e interações que resultam em uma página do SharePoint exibida para os usuários em um navegador. Visão geral do modelo de página do SharePoint
Página de publicação Uma página .aspx em um site de publicação. Classe PublishingPage
Site de publicação Um site do SharePoint que pode acessar sites e páginas de publicação, que incluem layouts de página, taxonomia, navegação gerenciada e outros recursos de gerenciamento de conteúdo corporativo e gerenciamento de conteúdo da web. - Classe PublishingWeb
- Novidades no desenvolvimento de site do SharePoint
Seattle.master Uma página mestra padrão do SharePoint. Galeria de Páginas Mestras do sistema de arquivos do SharePoint
Site de equipe Um site projetado para os usuários colaborarem em documentos, wikis, ideias, processos e assim por diante.
Layout do texto Define as áreas de conteúdo que aparecem em uma página da wiki.
Controle de layout de texto Um controle de página de wiki que pode conter texto, imagens, web parts e partes de aplicativos.
Site de nível superior O site padrão de nível superior fornecido pelo servidor. Criar sites para o SharePoint
Web part Controles do lado do servidor que são executados dentro do contexto das páginas do site. Ações personalizadas e entradas de recipiente de propriedades de um aplicativo do SharePoint
Página de web part Uma página de conteúdo composta por zonas de web parts, que podem conter web parts. As web parts são representadas em páginas de web parts por objetos WebPartDefinition. Microsoft.SharePoint.Client.WebParts namespace
Zona de web part Uma área em uma página em que uma web part pode ser adicionada.
Página Wiki Uma página de conteúdo que usa o modelo de site wiki da empresa. Aplicativo de amostra Provisioning.Pages

Páginas mestras do SharePoint

Uma página mestra é um arquivo ASP.NET com uma extensão .master. Ele inclui uma <%@ Master diretiva e define os elementos HTML de nível superior, como HTML, Cabeça e Formulário. Primeiro, lista controles e montagens e, em seguida, declara uma Definição de Tipo de Documento de DOCTYPE, que informa ao navegador como renderizar o HTML. O SharePoint está ajustado para funcionar melhor com os DOCTYPES XHTML 1.0 e HTML5.

O SharePoint inclui várias páginas mestras por padrão. Essas páginas mestras fornecem a estrutura e o cromo padrão de uma determinada página do SharePoint que são apropriados para o SKU e o tipo do site em que são aplicáveis, especificamente, nos lados superior e esquerdo da página. A Tabela 2 lista as páginas mestras padrão do SharePoint e do SharePoint Online.

Tabela 2. Páginas de master padrão do SharePoint

Página mestra Descrição
Custom.master Páginas do sistema, como formulários e visualizações. Usada por todos os SKUs do SharePoint e do SharePoint Online.
Default.master Páginas do site em sites de publicação. Incluída em todos os SKUs do SharePoint e do SharePoint Online. Disponíveis quando o recurso de publicação está ativado.
Application.master Algumas páginas do sistema, como scope.aspx e keyword.aspx. Incluída em todos os SKUs do SharePoint e do SharePoint Online.
Minimal.master Opção de página mestra padrão disponível em todos os SKUs do SharePoint.
Seattle.master Opção de página mestra padrão disponível em todos os SKUs do SharePoint e do SharePoint Online.
Oslo.master Opção de página mestra padrão disponível em todos os SKUs do SharePoint e do SharePoint Online.
Kyoto.master Uma página mestra disponível no SharePoint Online.
Berlin.master Uma página mestra disponível no SharePoint Online.
Lyon.master Uma página mestra disponível no SharePoint Online.
Mysite15.master Sites do OneDrive for Business (anteriormente: Meu Site, sites pessoais ou sites do OneDrive Pro).

Cada página mestra padrão do SharePoint inclui controles necessários para que as tecnologias comuns de programação da web, como HTML, CSS e JavaScript, funcionem no SharePoint.

Espaços reservados de conteúdo para manter o lugar para informações definidas em páginas de conteúdo. Espaços reservados de conteúdo correspondem às áreas de uma página. Cada área de uma página mestra é definida por entre alguns e centenas de espaços reservados para conteúdo.

As páginas mestras do SharePoint usam uma combinação de declarações ASP.NET (<asp:) e SharePoint (<SharePoint:). O texto após os dois pontos em uma declaração define a funcionalidade do controle; por exemplo, SharePoint:PlaceholderGlobalNavigation incorpora a navegação global de uma página do SharePoint às tags HTML relevantes nessa página. Controles de conteúdo em uma página mestra vinculam espaços reservados para conteúdo ao conteúdo com o ContentPlaceHolderID.

O SharePoint fornece dois tipos de páginas mestras: páginas mestras do sistema e páginas mestras do site. As páginas mestras do sistema são aplicadas a todas as páginas de formulário e páginas de exibição em um site do SharePoint. As páginas mestras do site, por outro lado, são usadas por todas as páginas em um site de publicação. Você pode dizer qual tipo de página master um site está usando abrindo o arquivo de página .master e exibindo a diretiva Page. Uma página mestra do sistema tem uma diretiva de página da seguinte maneira: ~masterurl/default.master. Uma página mestra do site possui a seguinte diretiva de página: ~masterurl/custom.master.

Você pode usar o código CSOM para definir as propriedades da página mestra, principalmente escrevendo código contra o objeto da Web. Altere a página mestra do sistema usando sua propriedade MasterUrl e altere a página mestra do site usando a propriedade CustomMasterUrl do objeto.

Os espaços reservados para conteúdo geralmente incluem tokens dinâmicos, que são partes importantes do código que forma parte de uma URL de página do SharePoint. O SharePoint analisa cadeias de caracteres de URL de acordo com as regras de protocolos, como HTTP, que definem como as informações de hipertexto são transferidas entre o servidor e uma página do SharePoint. Geralmente, um espaço reservado para conteúdo que aponta para um controle de CSS ou de tema usa uma URL relativa, que no modelo de objeto do lado do servidor do SharePoint é representada como ~SPUrl.

O SharePoint usa tokens dinâmicos para vincular a página mestra à página de conteúdo, definida na declaração <asp:content> do código da página .master. A Tabela 3 lista os tokens dinâmicos encontrados nas páginas mestras do SharePoint e as propriedades CSOM que as substituem quando a página é processada, ou o formato da cadeia de caracteres de URL que o SharePoint renderiza para esse espaço reservado para conteúdo.

Tabela 3. Tokens dinâmicos em páginas mestras substituídos por valores de propriedades

Token dinâmico Substituído por
~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>

Observação

Os tokens dinâmicos nos espaços reservados para conteúdo correspondem às propriedades e métodos da API do lado do servidor. Ao usar o provisionamento remoto, escreva código em CSOM ou REST. Para saber mais sobre tokens e URLs dinâmicas do SharePoint, consulte URLs e tokens no SharePoint. Os Suplementos do SharePoint usam alguns tokens que se aplicam a URLs de sites.

Páginas de web parts e páginas wiki

As páginas de web parts podem conter informações estruturadas e não estruturadas. Elas são compostas por zonas de web parts. As web parts colocadas em zonas de web parts podem exibir dados de listas, resultados de pesquisa e consultas, e podem apresentar exibições personalizadas de dados de várias origens. Uma página de web part contém a maioria dos mesmos elementos de um site de equipe padrão do SharePoint. A barra de título pode conter título, legenda, descrição, logotipo da empresa ou outra imagem. A página da web part adiciona os seguintes elementos:

  • Um menu de página de web part que pode ser usado para adicionar ou modificar web parts, projetar o layout da página e alternar entre exibições pessoais e compartilhadas.
  • Um painel de ferramentas usado para localizar e adicionar web parts e editar propriedades relacionadas a web parts e à página de web part.

Em comparação com páginas de web parts, as páginas wiki são menos estruturadas. Por causa de sua forma semiestruturada a não estruturada, eles facilitam para os usuários criar conteúdo e colaborar uns com os outros. Por padrão, o SharePoint exibe uma página wiki na primeira vez que você visualiza um novo site de equipe.

A funcionalidade de wiki corporativo está disponível em todas as versões do SharePoint. O modelo de wiki corporativo possibilita criar e usar layouts de página com páginas wiki. Quando você edita uma página da wiki, as web parts, o texto e outros conteúdos são exibidos no layout do texto. O layout do texto organiza áreas de conteúdo em uma página wiki.

Você pode usar o padrão de provisionamento remoto para criar uma página wiki. A classe WikiPageCreationInformation fornece métodos que você pode usar para criar a página wiki, e a propriedade WikiHtmlContent obtém e define o conteúdo HTML na página. A classe Utility inclui um método CreateWikiPageInContextWeb, que o SharePoint usa para criar a página wiki no contexto de tempo de execução do cliente usando parâmetros da classe WikiPageCreationInformation.

Layouts de página

O layout da página é a página de conteúdo escolhida para sites de publicação. Layouts de página são modelos que definem diferentes tipos de páginas em um site do SharePoint, como artigos, personalizando a estrutura do corpo da página. Assim como a página da web part é um modelo que existe para organizar web parts e zonas de web parts em uma página, os layouts de página existem para organizar campos em uma página. Os controles de campo definidos em um layout de página contêm o conteúdo criado por um autor, e a estrutura desse conteúdo é baseada no layout da página.

Observação

Os layouts de página podem incluir zonas de web part.

Os designers podem aplicar estilos a controles de campo da página. Isso possibilita que tenham controle sobre como o CSS é aplicado a cada campo e processado, e ainda permite que os usuários criem e gerenciem conteúdo em cada campo de página.

No SharePoint, os tipos de conteúdo são coleções reutilizáveis de metadados (também conhecidas como colunas) e comportamento que definem itens e documentos específicos. Por exemplo, talvez você queira criar um tipo de conteúdo que tem a aparência e o comportamento de um artigo de uma revista online, na sua concepção. Os tipos de conteúdo possibilitam fazer isso. Você também pode querer criar outros tipos exclusivos de conteúdo, mas reutilizar e compartilhar características de um tipo de conteúdo em outros. Todo layout de página é baseado em exatamente um tipo de conteúdo. Cada tipo de conteúdo é atribuído a um ID de tipo de conteúdo exclusivo.

Para saber mais sobre os tipos de conteúdo, confira:

Importante

Atualmente, você pode usar o padrão de provisionamento remoto para aplicar layouts de página prontos para uso a um site do SharePoint. Embora você possa provisionar tipos de conteúdo personalizados em um site usando o código CSOM por meio de suplementos personalizados para código do SharePoint, e haja suporte para definir ContentTypeId personalizado via CSOM, no SharePoint Online, não há suporte para definir o ContentTypeId para um tipo de conteúdo personalizado por meio de provisionamento remoto em Sites do SharePoint no local, no momento. Para mais informações, consulte Criar um layout de página no SharePoint.

Modelo de processamento de página do SharePoint

O SharePoint é um sistema de renderização de páginas baseado em modelos que combina páginas mestras, páginas de conteúdo e conteúdo criado para renderizar páginas. O sistema de renderização de páginas é conhecido como o modelo de processamento de páginas. As páginas mestras são usadas por todas as instâncias de página no site em que são aplicadas, e as páginas de conteúdo são usadas por todas as instâncias da página baseadas nessa página de conteúdo.

O modelo de processamento de página interpreta e executa todas as solicitações que os agentes de usuário, como navegadores Web, fazem ao servidor. Por exemplo, considere um usuário que está solicitando uma página chamada contoso.aspx. Para concluir a solicitação, o mecanismo ASP.NET recupera duas páginas: a página de conteúdo associada a contoso.aspx e a página mestra que o provedor de arquivos associa ao site do SharePoint. O mecanismo também recupera os controles de campo e as web parts dos campos e os renderiza na página.

Observação

A lógica de processamento da página para sites e sites de equipe é semelhante à das páginas de publicação.

Processamento de páginas

Quando um usuário do SharePoint carrega uma página de web part, o SharePoint a obtém analisando o caminho para o modelo, o conteúdo da página e o contexto. Ele também define as web parts associadas à página da web part, atribui uma instância WebPartCollection à página e preenche a página da web part e suas web parts com conteúdo.

Quando um usuário do SharePoint carrega uma página wiki (usando o modelo de Wiki Corporativo em um site de equipe ou de publicação), o SharePoint o obtém analisando o caminho para seu modelo, conteúdo de página e contexto. Ele também define o controle de layout de texto associado à página wiki e preenche a página de wiki corporativo e seu layout de texto com conteúdo.

Para saber mais sobre como provisionar uma página wiki usando o padrão de provisionamento remoto, consulte o exemplo Provisioning.Pages.

Estratégia de download mínima e <controles AjaxDelta>

No SharePoint, o recurso de estratégia de download mínimo gerencia qual conteúdo específico de uma página mestra deve ser atualizado antes da renderização da página. Quando a estratégia está habilitada, o conteúdo associado aos espaços reservados de conteúdo encapsulados em <SharePoint:AjaxDelta> marcas na página master é atualizado antes da renderização da página. Por outro lado, os espaços reservados para conteúdo não agrupados em tags <SharePoint:AjaxDelta> não são renderizados quando a estratégia de download mínimo está ativada.

Você pode habilitar ou desabilitar a estratégia de download mínimo por meio da administração do site central, ou usando o modelo de objeto do lado do cliente (CSOM) do SharePoint. Você pode ativar esse recurso usando a propriedade EnableMinimalDownload.

Para saber mais, consulte visão geral da Estratégia de Download Mínimo. Para saber mais sobre como otimizar uma página mestra para funcionar adequadamente com a estratégia de download mínimo, consulte Modify SharePoint components for MDS.

A estratégia de download mínimo se encontra habilitada por padrão nos sites de equipe do SharePoint, e desabilitado por padrão nos sites de publicação do SharePoint e nos sites de equipe do SharePoint com a publicação habilitada.

Criando uma página mestra personalizada com base no seattle.master

Você pode usar o provisionamento remoto para provisionar elementos de identidade visual do site, como temas para um site, e pode usar CSS ou JavaScript para mostrar ou ocultar elementos ou controles de página. Personalizar uma página mestra fornece um nível adicional de controle sobre a estrutura da página. Ao criar uma página mestra personalizada, não edite e em seguida salve uma página mestra padrão usando seu nome padrão (por exemplo, seattle.master). Em vez disso, faça uma cópia da página mestra padrão que você deseja modificar e dê um novo nome a ela.

Importante

Devido ao possível impacto em longo prazo nos custos de suporte e manutenção contínuos, recomendamos não alterar a estrutura de uma nova página mestra. Você pode fazer alterações na página mestra compatíveis com a identidade visual e que não afetam a estrutura, como alterar cores no cabeçalho, adicionar um plano de fundo colorido a elementos específicos de uma página ou mostrar e ocultar um logotipo do site. Se a página mestra padrão que você está usando não incluir um elemento estrutural (como um rodapé) que você deseja incluir em sua página, use uma página mestra pronta para uso diferente.

Para ajudar a manter a consistência em uma página mestra personalizada, siga o padrão de codificação existente. Por exemplo, em áreas da página que usam tabelas, reforce o padrão de codificação usando tabelas. Nas áreas em que tags <DIV> ou HTML5 são usados, corresponda a qualquer código personalizado com tags <DIV> ou HTML5. A longo prazo, isso torna qualquer página mestra personalizada que você precise criar mais fácil de manter e, portanto, menos dispendiosa.

Confira também