Modèle de page et pages SharePoint
Cet article donne un aperçu du modèle de page SharePoint, y compris les types de pages, les fichiers de page par défaut qui sont disponibles dans SharePoint et SharePoint Online, et les informations sur la façon dont les pages sont traitées.
Un rendu de page SharePoint est une combinaison de trois types de page :
Page maître – contrôle la mise en page et l’apparence du contenu.
Page de contenu – contient les contrôles de champ de page.
Page de création conviviale – emplacement où l’utilisateur ajoute du contenu.
Termes et concepts
Tableau 1. Termes et concepts clés liés au modèle de page SharePoint
| Terme ou concept | Définition | Accès par | Plus d’informations |
|---|---|---|---|
| Site de collaboration | Site d’équipe. | ||
| Espace réservé de contenu | Entrée dans une page maître qui réserve un espace pour les contrôles ou contenus pouvant être remplacés ultérieurement par programme. | Toutes les pages maîtres SharePoint | Les espaces réservés de contenu sont les blocs de construction des pages maîtres SharePoint. |
| Page maître | Page qui standardise le comportement ainsi que la présentation des éléments de navigation sur le côté gauche et la partie supérieure d’une page SharePoint. | Galerie de pages maîtres du système de fichiers SharePoint | |
| Galerie de pages maîtres | Bibliothèque de documents spéciale dans SharePoint, dans laquelle tous les éléments de personnalisation (pages maîtres, mises en page, fichiers JavaScript, CSS et images) sont stockés par défaut. Chaque site possède sa propre galerie de pages maîtres. | Paramètres > Paramètres de site > Pages maîtres et mises en page | La galerie de pages maîtres contient des catalogues qui stockent les éléments de personnalisation tels que les pages maîtres et les fichiers CSS. Conseil : lorsque vous créez des éléments de personnalisation, stockez-les dans la structure de fichiers de la galerie de pages maîtres par défaut. Pages maîtres, galerie de pages maîtres et mises en pages dans SharePoint |
| Stratégie de téléchargement minimal | Stratégie réduisant la quantité de données que le navigateur doit télécharger lorsque les utilisateurs naviguent d’une page SharePoint à l’autre. | Paramètres de site | Lorsque la stratégie de téléchargement minimal est active, SharePoint transmet toutes les demandes de page par le biais de /_layouts/15/start.aspx et recherche les différences visuelles entre les nouvelles demandes de page et la page précédemment chargée.- Optimiser les performances de page dans SharePoint - Vue d’ensemble de la stratégie de téléchargement minimale |
| Navigation | Fonctionnalité permettant aux utilisateurs de se déplacer autour de l’architecture d’information d’un site SharePoint. Les éléments de navigation dans SharePoint incluent la recherche, les contrôles d’arborescence, les boutons, le ruban, les hyperliens, les onglets, les menus, et la taxonomie. | - Classe de navigation - Classe NavigationNode |
|
| Maître Oslo | Page maître par défaut dans SharePoint. | Galerie de pages maîtres du système de fichiers SharePoint | Contrairement à la page maître seattle.master, la navigation en cours est au même emplacement que la zone de navigation supérieure. |
| Contrôle du contenu de page | Contrôle sur un site de publication permettant d’ajouter un composant WebPart. | ||
| Mise en page | Modèle appliqué à une page de publication pour la mise en application de la présentation uniforme du contenu. | Galerie de pages maîtres du système de fichiers SharePoint | Procédure : créer une mise en page dans SharePoint |
| Modèle de page | Fichiers, contenus et interactions qui forment une page SharePoint affichée dans un navigateur pour les utilisateurs. | Présentation du modèle de page SharePoint | |
| Page de publication | Page .aspx dans un site de publication. | Classe PublishingPage | |
| Site de publication | Site SharePoint pouvant accéder à des sites et des pages de publication, qui comprennent les mises en page, la taxonomie, la navigation gérée et d’autres fonctionnalités de gestion de contenu web et de contenu d’entreprise. | - Classe PublishingWeb - Nouveautés du développement de sites SharePoint |
|
| Seattle.master | Page maître par défaut dans SharePoint. | Galerie de pages maîtres du système de fichiers SharePoint | |
| Site d’équipe | Site conçu pour les utilisateurs pour collaborer sur des documents, des wikis, des idées, des processus, etc. | ||
| Mise en page de texte | Définit les zones de contenu qui apparaissent sur une page Wiki. | ||
| Contrôle de mise en page de texte | Contrôle de page wiki pouvant contenir du texte, des images, des composants WebPart et des composants d’application. | ||
| Site de niveau supérieur | Site de niveau supérieur fourni par défaut par le serveur. | Créer des sites pour SharePoint | |
| Composant WebPart | Contrôles côté serveur qui s’exécutent dans le contexte des pages de site. | Actions personnalisées et entrées de conteneur de propriétés à partir d’une application SharePoint | |
| Page de composant WebPart | Page de contenu composée de zones de composants WebPart pouvant contenir des composants WebPart. Les composants WebPart sont représentés sur les pages de composant WebPart par les objets WebPartDefinition. | Espace de noms Microsoft.SharePoint.Client.WebParts | |
| Zone de composant WebPart | Zone d’une page permettant d’ajouter un composant WebPart. | ||
| Page Wiki | Page de contenu utilisant le modèle de site Wiki d’entreprise | Exemple d’application Provisioning.Pages |
Pages maîtres SharePoint
Une page maître est un fichier ASP.NET avec une extension .master. Il inclut une directive <%@ Master et définit les éléments HTML de niveau supérieur comme HTML, En-tête et Formulaire. Ce fichier répertorie d’abord les contrôles et les assemblys, puis déclare une définition de type de document DOCTYPE qui indique au navigateur comment rendre le code HTML. SharePoint est conçu pour fonctionner au mieux avec les DOCTYPES XHTML 1.0 et HTML5.
SharePoint comprend plusieurs pages maîtres par défaut. Ces pages maîtres fournissent le chrome et la structure par défaut d’une page SharePoint donnée, qui sont appropriés pour le SKU et le type de site, à l’emplacement où ceux-ci sont applicables, notamment sur la partie gauche et supérieure de la page. Le tableau 2 répertorie les pages maîtres SharePoint et SharePoint Online par défaut.
Tableau 2. Pages maîtres SharePoint par défaut
| Page maître | Description |
|---|---|
| Custom.master | Pages système, telles que des formulaires et des vues. Utilisées par tous les SKU SharePoint et SharePoint Online. |
| Default.master | Pages de site dans les sites de publication. Incluses dans tous les SKU SharePoint et SharePoint Online. Disponibles lorsque la fonctionnalité de publication est activée. |
| Application.master | Certaines pages système, telles que scope.aspx et keyword.aspx. Incluses dans tous les SKU SharePoint et SharePoint Online. |
| Minimal.master | Option de page maître par défaut disponible dans toutes les références SKU SharePoint. |
| Seattle.master | Option de page maître par défaut disponible dans toutes les références SKU SharePoint Online et SharePoint. |
| Oslo.master | Option de page maître par défaut disponible dans toutes les références SKU SharePoint Online et SharePoint. |
| Kyoto.master | Page maître disponible dans SharePoint Online. |
| Berlin.master | Page maître disponible dans SharePoint Online. |
| Lyon.master | Page maître disponible dans SharePoint Online. |
| Mysite15.master | Sites OneDrive Entreprise (précédemment : Mon Site, sites personnels ou sites professionnels OneDrive). |
Chaque page maître par défaut SharePoint inclut les commandes requises pour les technologies de programmation web courantes, telles que HTML, CSS et JavaScript, pour fonctionner dans SharePoint.
Les espaces réservés de contenu contiennent l’espace destiné aux informations définies dans les pages de contenu. Ils correspondent à des zones d’une page. Chaque zone d’une page master est définie par un nombre d’espaces réservés de contenu allant de quelques-uns à plusieurs centaines.
Les pages maîtres SharePoint utilisent une combinaison de déclarations ASP.NET (<asp:) et SharePoint (<SharePoint:). Dans une déclaration, le texte suivant le signe deux-points définit les fonctionnalités de contrôle. Par exemple, SharePoint:PlaceholderGlobalNavigation incorpore la navigation globale d’une page SharePoint dans les balises HTML appropriées sur cette page SharePoint. Les contrôles de contenu dans une page maître associent les espaces réservés de contenu au contenu avec l’élément ContentPlaceHolderID.
SharePoint offre deux types de pages maîtres : les pages maîtres système et les pages maîtres de site. Les pages maîtres système sont appliquées à toutes les pages de formulaire et affichent des pages sur un site SharePoint. En revanche, les pages maîtres de site sont utilisées par toutes les pages dans un site de publication. Vous pouvez indiquer le type de page maître utilisé par un site en ouvrant le fichier de page .master et en affichant la directive Page. Une page maître système possède la directive de page suivante : ~masterurl/default.master. Une page maître de site possède la directive de page suivante : ~masterurl/custom.master.
Vous pouvez utiliser du code CSOM pour définir les propriétés de la page maître principalement en écrivant du code dans l’objet Web. Modifiez la page maître système à l’aide de sa propriété MasterUrl, et modifiez la page maître de site à l’aide de la propriété CustomMasterUrl de l’objet.
Les espaces réservés de contenu incluent souvent des jetons dynamiques, qui sont des parties importantes du code appartenant à l’URL d’une page SharePoint. SharePoint analyse les chaînes d’URL conformément aux règles des protocoles, comme HTTP, qui définissent la façon dont les informations sur l’hypertexte sont transférées entre le serveur et une page SharePoint. En général, un espace réservé de contenu qui pointe vers un contrôle de thème ou une feuille CSS utilise une URL relative, qui est représentée par ~SPUrl dans le modèle d’objet côté serveur SharePoint.
SharePoint utilise des jetons dynamiques pour associer la page maître à la page de contenu, tel que défini dans la déclaration <asp:content> du code de page .master. Le tableau 3 répertorie les jetons dynamiques qui se trouvent dans les pages maîtres SharePoint, ainsi que les propriétés CSOM qui les remplacent lors du traitement de la page ou la forme de la chaîne d’URL affichée par SharePoint pour cet espace réservé de contenu.
Tableau 3. Jetons dynamiques des pages maîtres remplacés par des valeurs de propriété
| Jeton dynamique | Remplacé par |
|---|---|
| ~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 |
Notes
Les jetons dynamiques dans les espaces réservés de contenu correspondent aux méthodes et aux propriétés d’API côté serveur. Lorsque vous utilisez la mise en service à distance, écrivez du code dans CSOM ou REST. Pour en savoir plus sur les jetons dynamiques et les URL SharePoint, reportez-vous à la rubrique relative aux URL et aux jetons dans SharePoint. Les compléments SharePoint utilisent certains jetons qui s’appliquent aux URL de site.
Pages de composant WebPart et pages Wiki
Les pages de composant WebPart peuvent contenir des informations structurées et non structurées. Elles sont constituées de zones de composant WebPart. Les composants WebPart placés dans ces zones peuvent afficher des données à partir de listes, de résultats de recherche et de requêtes, et peuvent présenter des vues personnalisées de données provenant de plusieurs sources. Une page de composant WebPart contient la plupart des éléments d’un site d’équipe SharePoint standard. La barre de titre peut contenir un titre, une légende, une description, un logo d’entreprise, ou toute autre image. La page de composant WebPart ajoute les éléments suivants :
- un menu de page de composant WebPart qui peut être utilisé pour ajouter ou modifier des composants WebPart, concevoir la mise en page et basculer entre les affichages personnel et partagé ;
- un volet d’outils utilisé pour trouver et ajouter des composants WebPart, et modifier les propriétés liées à des composants WebPart et à la page de composant WebPart.
Par rapport aux pages de composant WebPart, les pages wiki sont moins structurées. Leur forme semi-structurée, voire non structurée, facilite la création de contenu pour les utilisateurs, ainsi que la collaboration. Par défaut, SharePoint affiche une page wiki de la première fois que vous affichez un nouveau site d’équipe.
La fonctionnalité wiki d’entreprise est disponible dans toutes les versions de SharePoint. Le modèle wiki d’entreprise permet de créer et d’utiliser des mises en page avec des pages wiki. Lorsque vous modifiez une page wiki, les composants WebPart, le texte et tout autre contenu sont affichés dans la mise en page du texte. La mise en page du texte organise des zones de contenu sur une page wiki.
Vous pouvez utiliser le modèle de mise en service à distance pour créer une page Wiki. La classe WikiPageCreationInformation propose des méthodes que vous pouvez utiliser afin de créer la page Wiki, tandis que la propriété WikiHtmlContent obtient et définit le contenu HTML sur la page. La classe d’utilitaire inclut une méthode CreateWikiPageInContextWeb utilisée par SharePoint pour créer la page Wiki dans le contexte d’exécution client à l’aide des paramètres de la classe WikiPageCreationInformation.
Mises en page
La mise en page est la page de contenu privilégiée pour les sites de publication. Les mises en page sont des modèles définissant les différents types de pages d’un site SharePoint, tels que les articles, en personnalisant la structure du corps de la page. De la même façon que la page de composant WebPart est un modèle conçu pour organiser les zones de composant WebPart et les composants WebPart sur une page, les mises en page sont conçues pour organiser les champs sur une page. Les contrôles de champ définis dans une mise en page contiennent le contenu créé par un auteur, et la structure de ce contenu est basée sur la mise en page.
Notes
Les mises en page peuvent inclure des zones de composant WebPart.
Les concepteurs peuvent appliquer des styles aux contrôles de champ de page. Cela leur permet de contrôler l’application et le rendu de la feuille de style CSS pour chaque champ, tout en permettant aux utilisateurs de créer et de gérer le contenu de chaque champ de page.
Dans SharePoint, les types de contenu sont des collections réutilisables de métadonnées (également appelées colonnes) et correspondent au comportement qui définit des documents et des éléments spécifiques. Par exemple, vous souhaiterez créer un type de contenu qui ressemble à un article de magazine en ligne et se comporte comme tel. Cela est rendu possible par les types de contenu. De même, vous souhaiterez peut-être créer d’autres types de contenu uniques, tout en réutilisant et en partageant les caractéristiques d’un certain type de contenu dans d’autres types de contenu. Chaque mise en page repose sur un seul type de contenu. Chaque type de contenu est affecté à un ID de type de contenu unique.
Pour en savoir plus sur les types de contenu, consultez la rubrique :
Important
Actuellement, vous pouvez utiliser le modèle de mise en service à distance pour appliquer les mises en page prêtes à l’emploi dans un site SharePoint. Bien que vous puissiez mettre en service des types de contenu personnalisés sur un site à l’aide du code CSOM via des compléments personnalisés pour le code SharePoint, ainsi que configurer un ContentTypeId personnalisé via CSOM dans SharePoint Online, la définition de la valeur ContentTypeId pour un type de contenu personnalisé via la mise en service à distance sur des sites SharePoint en local n’est actuellement pas prise en charge. Pour obtenir plus d’informations, consultez l’article Procédure : créer une mise en page dans SharePoint.
Modèle de traitement des pages SharePoint
SharePoint est un système de rendu de pages reposant sur un modèle qui combine des pages maîtres, des pages de contenu et du contenu créé pour rendre les pages. Le système de rendu de pages est également appelé modèle de traitement des pages. Les pages maîtres sont utilisées par toutes les instances de page dans le site auquel elles sont appliquées. Les pages de contenu sont utilisées par toutes les instances de la page qui sont basées sur cette page de contenu.
Le modèle de traitement des pages interprète et exécute toutes les demandes que les agents utilisateurs, tels que les navigateurs Web, font au serveur. Par exemple, supposons qu’un utilisateur demande une page appelée contoso.aspx. Pour terminer la demande, le moteur ASP.NET récupère deux pages : la page de contenu associée à contoso.aspx, et la page maître que le fournisseur de fichier a associée au site SharePoint. Le moteur récupère également les contrôles de champ et les composants WebPart à partir des champs et en effectue le rendu sur la page.
Notes
La logique de traitement des pages pour les sites d’équipe et les sites est semblable à celle des pages de publication.
Traitement des pages
Lorsqu’un utilisateur de SharePoint charge une page de composant WebPart, SharePoint l’obtient en analysant le chemin d’accès à son modèle, à la page de contenu et au contexte. Il définit également les composants WebPart associés à la page de composant WebPart, affecte une instance WebPartCollection à la page et remplit la page de composant WebPart et ses composants WebPart avec le contenu correspondant.
Lorsqu’un utilisateur SharePoint charge une page wiki (en utilisant le modèle wiki d’entreprise sur un site d’équipe ou un site de publication), SharePoint l’obtient en analysant le chemin d’accès à son modèle, au contenu de page et au contexte. Il définit également le contrôle de mise en page du texte associé à la page Wiki, et remplit la page wiki d’entreprise ainsi que sa mise en page de texte avec du contenu.
Pour en savoir plus sur la mise en service d’une page Wiki en utilisant le modèle de mise en service à distance, reportez-vous à l’exemple Provisioning.Pages.
Stratégie de téléchargement minimal et contrôles
Dans SharePoint, la fonctionnalité de stratégie de téléchargement minimal gère le contenu spécifique d’une page maître pour actualiser la page avant de l’afficher. Lorsque la stratégie est activée, le contenu associé aux espaces réservés de contenu encapsulé dans les balises <SharePoint:AjaxDelta> sur la page maître est actualisé avant de procéder au rendu de la page. En revanche, les espaces réservés de contenu qui ne sont pas encapsulés dans les balises <SharePoint:AjaxDelta> ne s’affichent pas lorsque la stratégie de téléchargement minimal est activée.
Vous pouvez activer ou désactiver la stratégie de téléchargement minimale via l’administration centrale du site ou à l’aide du modèle objet côté client SharePoint (CSOM). Vous pouvez activer la fonctionnalité à l’aide de la propriété EnableMinimalDownload .
Pour plus d’informations, consultez la Vue d’ensemble de la stratégie de téléchargement minimal. Pour plus d’informations sur l’optimisation d’une page maître pour qu’elle fonctionne correctement avec la stratégie de téléchargement minimale, consultez Modifier les composants SharePoint pour MDS.
La fonctionnalité de stratégie de téléchargement minimal est activée par défaut sur les sites d’équipe SharePoint, et désactivée par défaut sur les sites de publication SharePoint et les sites d’équipe SharePoint où la publication est activée.
Création d’une page maître personnalisée basée sur seattle.master
Vous pouvez utiliser la mise en service à distance pour mettre en service des éléments de personnalisation de site, tels que des thèmes, sur un site, et vous pouvez utiliser la feuille de style CSS ou JavaScript pour afficher ou masquer des éléments ou des contrôles de page. La personnalisation d’une page maître fournit un niveau de contrôle supplémentaire sur la structure de la page. Lorsque vous créez une page maître personnalisée, ne modifiez pas et n’enregistrez pas une page maître par défaut en utilisant son nom par défaut (par exemple, seattle.master). Faites plutôt une copie de la page maître par défaut que vous souhaitez modifier, et renommez-la.
Important
En raison de l’impact potentiel à long terme des coûts continus de prise en charge et de maintenance, nous vous recommandons de ne pas modifier la structure d’une nouvelle page maître. Vous pouvez apporter des modifications à la page maître prenant en charge la personnalisation qui n’affecte pas la structure, comme la modification des couleurs de l’en-tête, l’ajout d’une couleur d’arrière-plan à des éléments spécifiques d’une page, ou l’affichage et le masquage d’un logo du site. Si la page master par défaut que vous utilisez n’inclut pas d’élément structurel (comme un pied de page), que vous souhaitez inclure sur votre page, utilisez une autre page maître prête à l’emploi.
Pour vous aider à maintenir la cohérence dans une page maître personnalisée, suivez le modèle de codage existant. Par exemple, dans les zones de la page qui utilisent des tableaux, renforcez le modèle de codage à l’aide de tableaux. Dans les zones où les balises <DIV> ou le code HTML5 sont utilisés, mettez en correspondance tout code personnalisé avec des balises <DIV> ou du code HTML5. À long terme, cette opération permet de gérer plus facilement la maintenance des pages maîtres personnalisées que vous devez créer et, par conséquent, d’en réduire le coût.
Voir aussi
- Ressources de la communauté de développeurs SharePoint (SharePoint PnP)
- Pratiques et modèles de développement Office 365 sur GitHub
- Pages maîtres, galerie de pages maîtres et mises en pages dans SharePoint
- SharePoint 2013 : Utiliser une application pour que SharePoint configure une page Wiki
- Solutions de personnalisation et de mise en service du site pour SharePoint