Compartir a través de

Páginas de SharePoint y el modelo de página

  • Artículo

Este artículo sirve de introducción al modelo de página de SharePoint, donde se condensan los tipos de página, los archivos de página predeterminados disponibles en SharePoint y SharePoint Online e

Una página de SharePoint representada es una combinación de tres tipos de página:

  • Página maestra : controla el diseño y la apariencia del contenido

  • Página de contenido : contiene los controles de campo de página

  • Página de creación fácil de usar : donde el usuario agrega contenido

Términos y conceptos

Tabla 1. Términos y conceptos clave relacionados con el modelo de páginas de SharePoint

Término o concepto Definición Acceso con Más información
Sitio de colaboración Un sitio de grupo.
Marcador de contenido Entrada en una página maestra que reserva espacio para controles o contenido que se pueden reemplazar con programación más adelante. Todas las páginas maestras de SharePoint Los marcadores de contenido son bloques de creación de páginas maestras de SharePoint.
Página maestra Página que estandariza el comportamiento y la presentación de los elementos de navegación a la izquierda y en la parte superior de una página de SharePoint. Galería de páginas maestras del sistema de archivos de SharePoint
Galería de páginas principales Biblioteca de documentos especial de SharePoint donde se almacenan de forma predeterminada todos los elementos de personalización de marca (páginas maestras, diseños de página, archivos JavaScript, CSS e imágenes). Cada sitio tiene su propia Galería de páginas maestras. Configuración > de páginas maestras y diseños de página de configuración del > sitio La Galería de páginas maestras contiene catálogos que almacenan los activos de personalización de marca como páginas maestras y archivos CSS.

Sugerencia: Al crear elementos de personalización de marca personalizados, almacene recursos personalizados en la estructura de archivos predeterminada de la Galería de páginas maestras.

Páginas maestras, la Galería de páginas maestras y diseños de página en SharePoint
Estrategia de descarga mínima (MDS) Estrategia que reduce la cantidad de datos que el navegador tiene que descargar cuando los usuarios van de una página de SharePoint a otra. Configuración del sitio Cuando MDS está activo, SharePoint pasa todas las solicitudes de /_layouts/15/start.aspx página y comprueba si hay diferencias visuales entre las nuevas solicitudes de página y la página cargada anteriormente.

- Optimizar el rendimiento de la página en SharePoint
- Información general de Estrategia de descarga mínima
Navegación Funcionalidad que permite a los usuarios desplazarse por la arquitectura de información de un sitio de SharePoint. Los elementos de navegación de SharePoint son la búsqueda, los controles de árbol, los botones, la cinta de opciones, los hipervínculos, las pestañas, los menús y la taxonomía. - Clase Navigation
- Clase NavigationNode
Oslo master Página maestra predeterminada en SharePoint. Galería de páginas maestras del sistema de archivos de SharePoint A diferencia de la página maestra seattle.master, la navegación actual está en la misma posición que el área de navegación superior.
Control de contenido de página Control en un sitio de publicación donde se puede agregar un elemento web.
Diseño de página Plantilla aplicada a una página de publicación que fuerza el uso de una presentación de contenido uniforme. Galería de páginas maestras del sistema de archivos de SharePoint Crear un diseño de página en SharePoint
Modelo de página Archivos, contenido e interacciones que producen una página de SharePoint que se muestra a los usuarios en un navegador. Información general sobre el modelo de página de SharePoint
Página de publicación Una página .aspx en un sitio de publicación. Clase PublishingPage
Sitio de publicación Sitio de SharePoint que puede tener acceso a las páginas y a los sitios de publicación, lo que incluye los diseños de página, la taxonomía, la navegación administrada y otras características de administración de contenido web y de contenido empresarial. - Clase PublishingWeb
- Novedades del desarrollo de sitio de SharePoint
Seattle.master Página maestra predeterminada en SharePoint. Galería de páginas maestras del sistema de archivos de SharePoint
Sitio de grupo Sitio diseñado para que los usuarios colaboren en documentos, wikis, ideas, procesos, etc.
Diseño de texto Define las áreas de contenido que aparecen en una página wiki.
Control de diseño de texto Control de página wiki que puede contener texto, imágenes, elementos web y elementos de aplicación.
Sitio de nivel superior Sitio de nivel superior predeterminado proporcionado por el servidor. Crear sitios para SharePoint
Elemento web Controles del lado servidor que se ejecutan en el contexto de las páginas del sitio. Acciones personalizadas y entradas de contenedor de propiedades de una aplicación de SharePoint
Página de elementos web Una página de contenido que consta de zonas de elementos web que pueden contener elementos web. Los elementos web se representan en páginas de elementos web mediante objetos WebPartDefinition. Espacio de nombres Microsoft.SharePoint.Client.WebParts
Zona de elementos web Área de una página donde se puede agregar un elemento web.
Página Wiki Página de contenido que usa la plantilla de sitio de wiki empresarial. Aplicación de ejemplo Provisioning.Pages

Páginas maestras de SharePoint

Una página maestra es un archivo ASP.NET con una extensión .master. Incluye una <%@ Master directiva y define los elementos HTML de nivel superior, como HTML, Head y Form. Primero recoge los controles y ensamblados y, después, declara una definición de tipo de documento de DOCTYPE, que indica al navegador cómo presentar el código HTML. SharePoint está preparado para funcionar de la mejor forma posible con los DOCTYPES XHTML 1.0 y HTML5.

SharePoint incluye varias páginas maestras de forma predeterminada. Estas páginas maestras proporcionan la estructura y el cromo predeterminados de una determinada página de SharePoint que son adecuados para el tipo de sitio y SKU donde sean aplicables, en concreto, en los lados izquierdo y superior de la página. En la tabla 2 se enumeran las páginas maestras predeterminadas de SharePoint y SharePoint Online.

Tabla 2. Páginas maestras predeterminadas de SharePoint

Página maestra Descripción
Custom.master Páginas del sistema, como formularios y vistas. Usadas por todas las SKU de SharePoint y SharePoint Online.
Default.master Páginas de sitio en sitios de publicación. Incluidas en todas las SKU de SharePoint y SharePoint Online. Disponibles si se activa la característica de publicación.
Application.master Algunas páginas del sistema, como scope.aspx y keyword.aspx. Incluidas en todas las SKU de SharePoint y SharePoint Online.
Minimal.master Opción de página maestra predeterminada disponible en todas las SKU de SharePoint.
Seattle.master Opción de página maestra predeterminada disponible en todas las SKU de SharePoint y SharePoint Online.
Oslo.master Opción de página maestra predeterminada disponible en todas las SKU de SharePoint y SharePoint Online.
Kyoto.master Una página maestra disponible en SharePoint Online.
Berlin.master Una página maestra disponible en SharePoint Online.
Lyon.master Una página maestra disponible en SharePoint Online.
Mysite15.master Sitios de OneDrive para la Empresa (anteriormente: Mi sitio, sitios personales o sitios de OneDrive Pro).

Cada página maestra predeterminada de SharePoint incluye los controles necesarios para que las tecnologías de programación web comunes como HTML, CSS y JavaScript funcionen en SharePoint.

Los marcadores de contenido son el lugar donde está la información definida en las páginas de contenido. Los marcadores de contenido se corresponden con las áreas de una página. Cada área de una página maestra se define entre unos pocos y cientos de marcadores de contenido.

Las páginas maestras de SharePoint utilizan una combinación de declaraciones de ASP.NET (<asp:) y SharePoint (<SharePoint:). El texto que sigue a los dos puntos en una declaración define la funcionalidad del control; así, por ejemplo, SharePoint:PlaceholderGlobalNavigation inserta la navegación global de una página de SharePoint en las etiquetas HTML que corresponda de esa página. Los controles de contenido en una página maestra enlazan los marcadores de contenido con el ContentPlaceHolderID.

SharePoint proporciona dos tipos de páginas maestras: páginas maestras de sistema y páginas maestras del sitio. Las páginas maestras del sistema se aplican a todas las páginas de formulario y páginas de vistas en un sitio de SharePoint. Por otro lado, las páginas maestras del sitio se usan en todas las páginas en un sitio de publicación. Para saber qué tipo de página maestra usa un sitio, abra el archivo de página .master y vea la directiva Page . La directiva de una página maestra del sistema es la siguiente: ~masterurl/default.master. Una página maestra del sitio tiene la siguiente directiva la página: ~masterurl/custom.master.

Puede usar código CSOM para establecer las propiedades de la página maestra, principalmente escribiendo código con el objeto Web. Cambie la página maestra del sistema con su propiedad MasterUrl y la página maestra del sitio con la propiedad CustomMasterUrl del objeto.

Los marcadores de contenido suelen incluir tokens dinámicos, que son fragmentos de código importantes que forman parte de la dirección URL de una página de SharePoint. SharePoint analiza las cadenas de dirección URL según las reglas de protocolos como HTTP, que definen cómo se transfiere la información de hipertexto entre el servidor y una página de SharePoint. Normalmente, un marcador de contenido que apunta a un control de tema o CSS usa una dirección URL relativa, que en el modelo de objetos de servidor de SharePoint se representa como ~SPUrl.

SharePoint usa tokens dinámicos para enlazar la página maestra a la página de contenido, definida en la declaración <asp:content> del código de la página .master. En la tabla 3 se recogen los tokens dinámicos que se encuentran en las páginas maestras de SharePoint y, o bien las propiedades CSOM que los reemplazan cuando la página se procesa, o la forma de la cadena de dirección URL que SharePoint muestra para ese marcador de contenido.

Tabla 3. Tokens dinámicos en páginas maestras reemplazados por valores de propiedad

Token dinámico Se reemplaza 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>

Nota:

Los tokens dinámicos en los marcadores de contenido se corresponden con los métodos y propiedades de la API de servidor. Cuando use el aprovisionamiento remoto, escriba código en CSOM o REST. Para obtener más información sobre los tokens dinámicos y direcciones URL de SharePoint, consulte Direcciones URL y tokens en SharePoint. Los complementos de SharePoint utilizan algunos tokens que se aplican a las direcciones URL del sitio.

Páginas de elementos web y páginas wiki

Las páginas de elementos web pueden contener información estructurada y no estructurada. Están formadas por zonas de elementos web. Los elementos web situados en zonas de elementos web pueden mostrar datos de listas, resultados de búsqueda y consultas y, asimismo, pueden presentar vistas personalizadas de datos procedentes de diversos orígenes. Una página de elementos web contiene prácticamente los mismos elementos que un sitio de grupo de SharePoint estándar. La barra de título puede contener un título, una leyenda, una descripción, un logotipo de la compañía o cualquier otra imagen. La página de elementos web agrega los siguientes elementos:

  • Un menú de página de elementos web que se puede usar para agregar o modificar elementos web, diseñar la página y cambiar entre la vista personal y la vista compartida.
  • Un panel de herramientas donde se pueden buscar y agregar elementos web, así como modificar las propiedades relacionadas con los elementos web y la página de elementos web.

En comparación con las páginas de elementos web, las páginas wiki están menos estructuradas. Dada su naturaleza semiestructurada o no estructurada, hacen que sea fácil crear contenido y colaborar entre los usuarios. SharePoint muestra una página wiki de forma predeterminada la primera vez que se ve un nuevo sitio de grupo.

La funcionalidad de wiki empresarial está disponible en todas las versiones de SharePoint. La plantilla de wiki empresarial permite crear y usar diseños de página con páginas wiki. Cuando una página wiki se edita, los elementos web, el texto y demás contenido se muestran en el diseño de texto. El diseño de texto organiza las áreas de contenido en una página wiki.

Puede usar el modelo de aprovisionamiento remoto para crear una página wiki. La clase WikiPageCreationInformation proporciona métodos que pueden servir para crear la página wiki, al tiempo que la propiedad WikiHtmlContent obtiene y establece el contenido HTML de la página. La clase Utility incluye un método CreateWikiPageInContextWeb, que SharePoint usa para crear la página wiki en el contexto en tiempo de ejecución del cliente con los parámetros de la clase WikiPageCreationInformation.

Diseños de página

El diseño de página es la página de contenido que se elige para los sitios de publicación. Los diseños de página son plantillas que definen los distintos tipos de páginas de un sitio de SharePoint (como los artículos) personalizando la estructura del cuerpo de la página. Al igual que la página de elementos web es una plantilla que existe para organizar los elementos web y zonas de elementos web en una página, los diseños de página existen para organizar los campos de una página. Los controles de campo definidos en un diseño de página hospedan el contenido que un autor crea y la estructura de ese contenido se basará en el diseño de página.

Nota:

Los diseños de página pueden incluir zonas de elementos web.

Los diseñadores pueden aplicar estilos a los controles de campo de página. Esto proporciona a los diseñadores control sobre cómo se aplica CSS a cada campo y se representa, pero permite a los usuarios crear y administrar contenido en cada campo de página.

En SharePoint, los tipos de contenido son colecciones de metadatos reutilizables (también denominados columnas) y comportamientos que definen documentos y elementos específicos. Por ejemplo, puede que le interese crear un tipo de contenido que tenga la apariencia y el comportamiento que debería tener un artículo de una revista en línea. Los tipos de contenido permiten lograr esto. O puede que quiera crear otros tipos de contenido únicos, pero reutilizar y compartir las características de un tipo de contenido en otros. Cada diseño de página se basa exactamente en un tipo de contenido. A cada tipo de contenido se le asigna un Id. de tipo de contenido único.

Para obtener más información acerca de los tipos de contenido, consulte:

Importante

Actualmente, puede usar el patrón de aprovisionamiento remoto para aplicar diseños de página predefinidos en un sitio de SharePoint. Aunque se pueden aprovisionar tipos de contenido personalizados en un sitio usando código CSOM mediante complementos personalizados de SharePoint y, de igual manera, la definición de un ContentTypeId personalizado mediante CSOM está admitida, en estos momentos no se puede establecer un ContentTypeId para un tipo de contenido personalizado usando el aprovisionamiento remoto en sitios de SharePoint locales. Para obtener más información, consulte Crear un diseño de página en SharePoint.

Modelo de procesamiento de páginas de SharePoint

SharePoint es un sistema de representación de páginas basado en plantillas donde se combinan páginas maestras, páginas de contenido y contenido creado para representar páginas. Este sistema de representación de páginas se conoce como modelo de procesamiento de páginas. Las páginas maestras se utilizan en todas las instancias de la página en las que se aplican y, del mismo modo, las páginas de contenido se usan en todas las instancias de la página que estén basadas en esa página de contenido.

El modelo de procesamiento de páginas interpreta y ejecuta todas las solicitudes que los agentes de usuario (como los navegadores web) realizan al servidor. Por ejemplo, supongamos que un usuario solicita una página llamada contoso.aspx. Para completar la solicitud, el motor ASP.NET recupera dos páginas: la página de contenido asociada a contoso.aspx y la página maestra que el proveedor de archivos asoció al sitio de SharePoint. El motor también recupera los controles de campo y los elementos web de los campos y los representa en la página.

Nota:

La lógica de procesamiento de páginas en los sitios de grupo y los sitios es similar a la de las páginas de publicación.

Procesamiento de la página

Cuando un usuario de SharePoint carga una página de elementos web, SharePoint la obtiene analizando la ruta de acceso a su plantilla, contenido de página y contexto correspondientes. También define los elementos web asociados a la página de elementos web, asigna una instancia de WebPartCollection a la página y rellena la página de elementos web y sus elementos web con contenido.

Cuando un usuario de SharePoint carga una página wiki (ya sea usando la plantilla de wiki empresarial en un sitio de grupo o con un sitio de publicación), SharePoint la obtiene analizando la ruta de acceso a su plantilla, contenido de página y contexto correspondientes. También define el control de diseño de texto asociado a la página wiki y rellena la página wiki empresarial y su diseño de texto con el contenido.

Para más información sobre cómo aprovisionar una página wiki con el patrón de aprovisionamiento remoto, consulte el ejemplo Provisioning.Pages

Estrategia de descarga mínima y <controles AjaxDelta>

En SharePoint, la característica de estrategia de descarga mínima administra qué contenido específico de una página maestra se va a actualizar antes de que la página se muestre. Cuando se habilita la estrategia, el contenido asociado a marcadores de posición de contenido encapsulados en etiquetas en <SharePoint:AjaxDelta> la página maestra se actualiza antes de que se represente la página. Por el contrario, los marcadores de contenido que no se incluyan entre etiquetas <SharePoint:AjaxDelta> no se representarán cuando la estrategia de descarga mínima esté habilitada.

Puede habilitar o deshabilitar la estrategia de descarga mínima a través de la administración del sitio central o mediante el modelo de objetos del lado cliente de SharePoint (CSOM). Puede activar esta característica con la propiedad EnableMinimalDownload.

Para obtener más información, vea Información general de Estrategia de descarga mínima. Para más información sobre cómo optimizar una página maestra para que funcione adecuadamente con la estrategia de descarga mínima, vea Modify SharePoint components for MDS.

La característica de estrategia de descarga mínima está habilitada de forma predeterminada en los sitios de grupo de SharePoint y está deshabilitada de forma predeterminada en los sitios de publicación de SharePoint y en los sitios de grupo de SharePoint con publicación habilitada.

Crear una página maestra personalizada con seattle.master

Puede usar el aprovisionamiento remoto para aprovisionar elementos de personalización de marca del sitio como, por ejemplo, los temas, así como usar CSS o JavaScript para mostrar u ocultar elementos o controles de página. La personalización de una página maestra proporciona un nivel extra de control sobre la estructura de la página. Al crear una página maestra personalizada, no edite y, después, guarde una página maestra predeterminada con su nombre predeterminado (por ejemplo, seattle.master). En su lugar, haga una copia de la página maestra predeterminada que quiera modificar y cámbiele el nombre.

Importante

Debido al posible impacto a largo plazo en el mantenimiento y costes continuados de soporte técnico, recomendamos no modificar la estructura de una página maestra nueva. Puede realizar cambios en la página maestra que den cabida a la personalización de marca y que no afecten a la estructura, como cambiar los colores del encabezado, agregar un fondo de color a elementos específicos de una página o mostrar y ocultar un logotipo del sitio. Si la página maestra predeterminada que está usando no incluye un elemento estructural (como un pie de página) que quiera incluir en ella, use otra página maestra ya incluida en el programa.

Para que sea más fácil mantener la coherencia en una página maestra personalizada, siga el patrón de codificación existente. Por ejemplo, en las áreas de la página que usen tablas, refuerce el patrón de codificación usando tablas. En las áreas donde se usen etiquetas <DIV> o HTML5, establezca una relación entre el código personalizado y las etiquetas <DIV> o HTML5. A largo plazo, esto hará que las páginas maestras personalizadas que tenga que crear sean más fáciles de mantener y, por lo tanto, menos costosas.

Vea también