Procédure : Créer une page maître minimale dans SharePoint
Importante
Cette option d’extensibilité est disponible uniquement pour des expériences SharePoint classiques. Vous ne pouvez pas l’utiliser avec des expériences modernes dans SharePoint Online, telles que des sites de communication. Nous vous déconseillons d’utiliser l’expérience classique ou les techniques de marque.
Une page maître minimale ne contient que les éléments de la page requis par SharePoint pour afficher la page correctement dans le navigateur. Le gestionnaire de conception vous permet de créer rapidement une page maître minimale sans avoir à concevoir et à convertir un fichier HTML.
Introduction à la page maître minimale
Avec le gestionnaire de conception, vous pouvez convertir un fichier HTML normal en une page maître SharePoint. Toutefois, si vous ne disposez pas d'une maquette prédéfinie, vous pouvez quand même rapidement tout reprendre à zéro en créant une page maître minimale. La page maître minimale ne contient que les éléments de la page requis par SharePoint pour afficher la page correctement dans le navigateur.
Lorsque vous créez une page maître minimale, le gestionnaire de conception crée le fichier .master et un fichier HTML associé, de sorte que vous pouvez continuer à utiliser uniquement le fichier HTML si vous préférez. L'utilisation d'une page maître minimale est exactement identique à l'utilisation d'une page maître que vous convertissez à partir d'un fichier HTML. La page maître et le fichier HTML sont associés, de sorte que chaque fois que vous modifiez et enregistrez le fichier HTML, ces modifications sont synchronisées avec la page maître associée. En outre, le fichier HTML contient des types spéciaux de balisage qui rendent la synchronisation avec le fichier .master possible. Pour plus d’informations sur cette association et ces types de balisage, voir How to: Convert an HTML file into a master page in SharePoint.
Commencer à partir d’une page maître minimale est utile lorsque :
Vous souhaitez commencer rapidement à partir de zéro, pour ensuite créer votre conception dans le fichier HTML qui est associé à la page maître minimale, plutôt que de commencer avec un fichier HTML maquette.
Vous souhaitez réaliser un prototype d'un élément de conception ou le tester rapidement et que cette action nécessite une page maître SharePoint de travail. Par exemple, la création d'une page maître minimale ne nécessite pas la préparation d'un fichier HTML pour la conversion ou la résolution des erreurs de prévision qui résultent de balisage non valide dans le fichier HTML. Cela signifie que vous pouvez immédiatement travailler avec l'aperçu côté serveur ou la galerie d'extraits de code.
Vous souhaitez travailler directement avec le fichier .master. Si vous êtes un développeur ASP.NET ou un développeur SharePoint, vous pouvez créer une page maître minimale, supprimer l’association entre le fichier HTML et le fichier .master en désactivant la case Fichier associé dans les propriétés du fichier HTML, et ensuite travailler directement avec le fichier .master.
Création d’une page maître minimale
Pour créer une page maître minimale, procédez comme suit :
Accédez à votre site de publication.
Dans le coin supérieur droit de la page, sélectionnez Paramètres, puis Gestionnaire de conception.
Dans le gestionnaire de conception, dans le volet de navigation de gauche, sélectionnez Modifier les pages maîtres.
Choisissez Créer une page maître minimale.
Dans la boîte de dialogue Créer une page maître minimale, saisissez le nom de la page maître, puis choisissez OK.
À ce stade, SharePoint crée un fichier .master et un fichier HTML associé portant le même nom dans la galerie de pages maîtres.
Dans le gestionnaire de conception, votre fichier HTML apparaît maintenant avec l'état Conversion réussie dans la colonne d'état.
Cliquez sur le lien dans la colonne d’état pour prévisualiser le fichier.
La page de prévisualisation est un aperçu côté serveur en temps réel de votre page maître.
Pour plus d’informations sur l’aperçu de la page maître avec différentes pages, voir Guide pratique pour modifier la page d’aperçu dans le Gestionnaire de conception SharePoint.
L'aperçu de la page contient également un lien Extraits de code dans le coin supérieur droit. Ce lien ouvre la galerie d'extraits de code, où vous pouvez initier le remplacement de contrôles de maquette ou statiques dans votre conception par des contrôles dynamiques SharePoint. Pour plus d’informations, consultez la rubrique relative aux extraits de code du Gestionnaire de conception SharePoint.
Une fois que vous aurez un aperçu correct de votre page maître, une balise <div> sera ajoutée à votre fichier HTML. Vous devrez peut-être faire défiler l’aperçu jusqu’au bas de la page pour voir la balise <div>.
Cette balise <div> correspond au bloc de contenu principal. Elle se trouve dans un espace réservé de contenu nommé ContentPlaceHolderMain. Au moment de l’exécution, quand un visiteur parcourt votre site et demande l’ouverture d’une page, cet espace réservé est rempli de contenu à partir d’une mise en page comportant du contenu dans une zone de contenu correspondante. Vous devez placer cette balise <div> à l’emplacement souhaité pour vos mises en page sur la page maître.
Vous pouvez modifier le fichier HTML qui réside directement sur le serveur en utilisant un éditeur HTML pour ouvrir et modifier le fichier HTML dans un lecteur mappé. Chaque fois que vous enregistrez le fichier HTML, toutes les modifications sont synchronisées avec le fichier .master associé. Pour plus d’informations, voir Guide pratique pour mapper un lecteur réseau à la galerie de pages maîtres SharePoint.
Pour travailler uniquement avec le fichier .master et non avec le fichier HTML, vous devez rompre le lien entre les deux fichiers. Dans le gestionnaire de conceptions, sur la page Modifier les pages maîtres, sélectionnez le fichier HTML, ouvrez le menu Propriétés, puis choisissez Modifier les propriétés. Dans l'onglet Modifier, désactivez la case Fichier associé, puis cliquez sur Enregistrer.
La rupture de l'association vous permet de travailler directement avec le fichier .master et d'enregistrer les modifications sans qu'elles soient remplacées par les modifications apportées au fichier HTML. Vous pouvez restaurer cette association à tout moment. Si vous restaurez l’association, le fichier HTML associé se synchronise avec le fichier .master et l’écrase.
Comprendre le fichier HTML associé
Lorsque vous créez une page maître minimale, un fichier HTML associé au fichier .master est créé, et ce fichier HTML contient de nombreuses lignes de balisage spécifiques au fonctionnement de SharePoint. Vous pouvez ignorer en toute sécurité la majeure partie de ce balisage, qui n’apparaît pas dans le balisage final de votre site lorsque vous affichez la source dans le navigateur, mais ce balisage est essentiel pour la synchronisation des modifications du fichier HTML vers le fichier .master que SharePoint utilise réellement. Chaque fois que vous enregistrez une modification dans votre fichier HTML, ce balisage SharePoint permet d’apporter cette même modification au fichier .master associé en arrière-plan. Pour plus d’informations, consultez les exemples de balisage dans Guide pratique pour convertir un fichier HTML en page maître dans SharePoint.