Mise à jour d'une page maître existante vers la page maître SharePoint Foundation
Dernière modification : lundi 2 août 2010
S’applique à : SharePoint Foundation 2010
Dans cet article
Contrôles sur le ruban du serveur
Ajouter des espaces réservés du contenu
Ajouter le ruban du serveur
Conserver la position du ruban serveur pendant le défilement
Ajouter des contrôles à la page maître
Des modifications notables ont été apportées à l'interface utilisateur de Microsoft SharePoint Foundation 2010, avec notamment l'ajout de Ruban serveur. Par défaut, la page v4.master inclut le Ruban serveur. Nombre des commandes qui se trouvaient précédemment dans les menus et les barres d'outils figurent maintenant dans le Ruban serveur. De ce fait, si votre page maître ne contient pas le Ruban serveur, de nombreuses commandes ne seront pas disponibles. Cette rubrique vous explique comment ajouter le Ruban serveur ainsi que d'éventuels nouveaux contrôles ou espaces réservés de contenu qui sont nécessaires pour qu'une page maître s'affiche correctement dans SharePoint Foundation 2010.
Conditions requises
Microsoft SharePoint Foundation 2010
Contrôles sur le ruban du serveur
Certains contrôles qui faisaient partie de la page maître par défaut ont été déplacés vers la nouvelle interface utilisateur du Ruban serveur. Dans la mesure où ces contrôles sont maintenant intégrés au Ruban serveur, si vous envisagez de mettre à jour une page maître existante avec la fonctionnalité Ruban serveur, vous devez supprimer les contrôles suivants de votre page maître actuelle. Ces contrôles seront ajoutés lorsque vous incorporerez le Ruban serveur dans votre page maître.
Console de publication - <PublishingConsole:Console>
Menu Actions du site - <PublishingSiteAction:SiteActionMenu>
Contrôle de connexion et d'ouverture de session
Important
Si vous utilisez un contrôle de connexion personnalisé, vous pouvez placer le contrôle à l'intérieur ou à l'extérieur du Ruban serveur, en fonction de votre mise en page.
Ajouter des espaces réservés du contenu
Vous devez faire en sorte que les nouveaux contrôles ContentPlaceHolder existent pour pouvoir mettre à jour votre page maître et la rendre compatible avec le SharePoint Foundation 2010. Le tableau suivant répertorie tous les espaces réservés nécessaires pour mettre à jour votre page maître et la rendre compatible avec le SharePoint Foundation 2010.
Important
L'espace réservé PlaceHolderTitleAreaClass se trouve maintenant dans la balise head. Les personnalisations qui ajoutent un WebPartZone dans une balise de contenu pour cet espace réservé générera une erreur sur la page.
Contrôle d'espace réservé |
Description |
Nouveau |
|---|---|---|
<asp:ContentPlaceHolder id="PlaceHolderQuickLaunchTop" runat="server"> |
Le partie supérieure du menu Lancement rapide. |
Oui |
<asp:ContentPlaceHolder id="PlaceHolderQuickLaunchBottom" runat="server"> |
La partie inférieure du menu Lancement rapide. |
Oui |
<asp:ContentPlaceHolder id="PlaceHolderPageTitle" runat="server"/> |
Titre du site. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderAdditionalPageHead" runat="server"/> |
Espace réservé dans la section d'en-tête de la page utilisée pour ajouter des composants supplémentaires tels que ECMAScript (JavaScript, JScript) et les feuilles de style CSS (Cascading Style Sheets) à la page. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderBodyAreaClass" runat="server"/> |
Classe de la zone du corps. |
Non |
<asp:ContentPlaceHolder ID="SPNavigation" runat="server"> |
Contrôle utilisé pour des commandes d'édition de page supplémentaires. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderSiteName" runat="server"> |
Nom du site où réside la page actuelle. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderPageTitleInTitleArea" runat="server" /> |
Titre de la page, qui apparaît dans la zone de titre sur la page. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderPageDescription" runat="server"/> |
Description de la page actuelle. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderSearchArea" runat="server"> |
Section de la page destinée aux contrôles de recherche. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderGlobalNavigation" runat="server"> |
Contrôle Barre de navigation sur cette page. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderTitleBreadcrumb" runat="server"> |
Texte de barre de navigation pour le contrôle Barre de navigation. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderGlobalNavigationSiteMap" runat="server"> |
Liste des sous-sites et sites enfants dans la navigation globale sur la page. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderTopNavBar" runat="server"> |
Conteneur utilisé pour la barre de navigation supérieure. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderHorizontalNav" runat="server"> |
Menu de navigation qui se trouve à l'intérieur de la barre de navigation supérieure. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderLeftNavBarDataSource" runat="server" /> |
Emplacement de la source de données utilisée pour remplir la barre de navigation gauche. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderCalendarNavigator" runat="server" /> |
Le sélecteur de dates utilisé quand un calendrier est visible sur la page. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderLeftNavBarTop" runat="server"/> |
Section supérieure de la barre de navigation de gauche. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderLeftNavBar" runat="server"> |
Barre Lancement rapide. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderLeftActions" runat="server"> |
Objets supplémentaires au-dessus de la barre Lancement rapide. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderMain" runat="server"> |
Contenu principal de la page. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderFormDigest" runat="server"> |
Conteneur stockant le contrôle de chiffrement fourni par le formulaire de la page. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderUtilityContent" runat="server"/> |
Contenu supplémentaire au bas de la page. Ceci se trouve en dehors de la balise form. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderTitleAreaClass" runat="server"/> |
Classe de la zone de titre. Elle se trouve maintenant dans la balise head. Les personnalisations qui ajoutent un WebPartZone dans une balise de contenu pour cet espace réservé générera une erreur sur la page. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderPageImage" runat="server"/> |
Cet espace réservé n'apparaît pas en tant que partie de l'interface utilisateur et doit être présent à des fins de compatibilité amont. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderTitleLeftBorder" runat="server"> |
Cet espace réservé n'apparaît pas en tant que partie de l'interface utilisateur et doit être présent à des fins de compatibilité amont. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderMiniConsole" runat="server"/> |
Cet espace réservé n'apparaît pas en tant que partie de l'interface utilisateur et doit être présent à des fins de compatibilité amont. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderTitleRightMargin" runat="server"/> |
Cet espace réservé n'apparaît pas en tant que partie de l'interface utilisateur et doit être présent à des fins de compatibilité amont. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderTitleAreaSeparator" runat="server"/> |
Cet espace réservé n'apparaît pas en tant que partie de l'interface utilisateur et doit être présent à des fins de compatibilité amont. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderNavSpacer" runat="server"> |
Cet espace réservé n'apparaît pas en tant que partie de l'interface utilisateur et doit être présent à des fins de compatibilité amont. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderLeftNavBarBorder" runat="server"> |
Cet espace réservé n'apparaît pas en tant que partie de l'interface utilisateur et doit être présent à des fins de compatibilité amont. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderBodyLeftBorder" runat="server"> |
Cet espace réservé n'apparaît pas en tant que partie de l'interface utilisateur et doit être présent à des fins de compatibilité amont. |
Non |
<asp:ContentPlaceHolder id="PlaceHolderBodyRightMargin" runat="server"> |
Cet espace réservé n'apparaît pas en tant que partie de l'interface utilisateur et doit être présent à des fins de compatibilité amont. |
Non |
Ajouter le ruban du serveur
Le Ruban serveur est une nouvelle addition à l'interface utilisateur pour SharePoint Foundation. Les contrôles SPRibbonPeripheralContent dans la page v4.master renferment un contenu qui s'affiche dans la zone Ruban serveur. Ce contenu peut être déplacé à l'extérieur du Ruban serveur, le cas échéant. La procédure suivante montre le code permettant d'ajouter le Ruban serveur à la page.
Pour ajouter le Ruban du serveur
Ouvrez le fichier de votre page maître (.master).
Copiez et collez le code suivant dans la balise form pour ajouter le Ruban serveur à la page.
Important
L'exemple de code suivant contient des sections commentées où vous copiez et collez des contrôles de vote page maître personnalisée ou de la page v4.master. Tout contrôle ContentPlaceholder se trouvant dans la section Navigation globale doit être ajouté à la page ailleurs si vous ne l'ajoutez pas dans Ruban serveur.
<div id="s4-ribbonrow" class="s4-pr s4-ribbonrowhidetitle"> <div id="s4-ribboncont"> <SharePoint:SPRibbon runat="server" PlaceholderElementId="RibbonContainer" CssFile=""> <SharePoint:SPRibbonPeripheralContent runat="server" Location="TabRowLeft" CssClass="ms-siteactionscontainer s4-notdlg"> <%-- Insert the Site Actions Menu Here --%> </SharePoint:SPRibbonPeripheralContent> <%-- Insert the Global Navigation Here --%> <SharePoint:SPRibbonPeripheralContent runat="server" Location="TabRowRight" ID="RibbonTabRowRight" CssClass="s4-trc-container s4-notdlg"> <%-- Insert the Top-Right Corner Controls Here --%> </SharePoint:SPRibbonPeripheralContent> </SharePoint:SPRibbon> </div> <div id="notificationArea" class="s4-noti"> <%-- Notifications will appear in this div element. --%> </div> <asp:ContentPlaceHolder ID="SPNavigation" runat="server"> <SharePoint:DelegateControl runat="server" ControlId="PublishingConsole"> </SharePoint:DelegateControl> </asp:ContentPlaceHolder> <div id="WebPartAdderUpdatePanelContainer"> <asp:UpdatePanel ID="WebPartAdderUpdatePanel" UpdateMode="Conditional" ChildrenAsTriggers="false" runat="server"> <ContentTemplate> <WebPartPages:WebPartAdder ID="WebPartAdder" runat="server" /> </ContentTemplate> <Triggers> <asp:PostBackTrigger ControlID="WebPartAdder" /> </Triggers> </asp:UpdatePanel> </div> </div>Enregistrez le fichier de votre page maître.
Conserver la position du ruban serveur pendant le défilement
Lors de l'ajout du Ruban serveur, apportez les modifications suivantes à la page maître pour empêcher le Ruban serveur de défiler avec la page.
Pour conserver la position du ruban serveur pendant le défilement
Déplacez le contenu de votre site à l'intérieur des éléments div suivants.
Important
L’élément div s4-workspace est requis dans les scénarios de modification. Une erreur de script se produit si cet élément n’existe pas.
<div id="s4-workspace"> <div id="s4-bodyContainer"> Content </div> </div>Notes
Si votre page est fixe en largeur, ajoutez la classe s4-nosetwidth à l'élément div s4-workspace. L'élément div mis à jour prendrait l'apparence suivante. <div id="s4-workspace" class="s4-nosetwidth">
Déplacez la zone de titre de votre site vers un élément div avec l'ID suivant.
<div id="s4-titlerow"> Title Area </div>Mettez à jour la balise body tag et la règle CSS (Cascading Style Sheet) pour éviter le défilement. La balise body et la règle auraient une apparence similaire à ce qui suit.
<body scroll="no" ...> Body Content </body>body { overflow: hidden; ... }
Ajouter des contrôles à la page maître
Il existe un jeu de contrôles qui sont nécessaires pour que SharePoint Foundation fonctionne. Il s'agit des contrôles SPPageManager, ScriptManager et ScriptLink.
Le contrôle SPPageManager gère les communications sur cette page. Ce contrôle assure le routage des commandes avec le Ruban serveur, les barres d'outils et d'autres contrôles de la page.
L'objet ScriptManager est un contrôle Microsoft ASP.NET qui est utilisé pour gérer tout le ECMAScript (JavaScript, JScript) sur cette page. Compte tenu de l'utilisation étendue de JavaScript dans SharePoint Foundation, vous devez avoir une instance du ScriptManager sur la page.
Le contrôle ScriptLink est nécessaire pour gérer l'ajout de références à JavaScript sur la page. Ce contrôle affiche un lien vers JavaScript sur la page.
Pour ajouter des contrôles à la page
Ouvrez le fichier de votre page maître.
Copiez et collez le code suivant pour ajouter le contrôle ScriptManager à la page. Cela doit se trouver dans la balise form mais avant Ruban serveur.
<asp:ScriptManager id="ScriptManager" runat="server" EnablePageMethods="false" EnablePartialRendering="true" EnableScriptGlobalization="false" EnableScriptLocalization="true" />Copiez et collez le code suivant pour ajouter le contrôle SPPageManager à la page. Cela doit se trouver dans la balise head.
<SharePoint:SPPageManager runat="server" />Copiez et collez le code suivant pour ajouter le contrôle ScriptLink à la page. Cela doit se trouver dans la balise head.
<SharePoint:ScriptLink defer= "true" runat="server"/>Enregistrez le fichier de votre page maître.