EcmaScript et le Ruban serveur
Dernière modification : lundi 7 février 2011
S’applique à : SharePoint Foundation 2010
Il existe plusieurs façons d’ajouter du code ECMAScript (JavaScript, JScript) à une page dans Microsoft SharePoint Foundation. Cette rubrique répertorie les techniques couramment employées pour ajouter du code JavaScript à une page pour interagir avec le Ruban serveur.
Ajout de code EcmaScript (JavaScript, JScript) à la page
Vous pouvez placer du code JavaScript personnalisé sur la page en procédant de l’une des manières suivantes :
en ciblant un contrôle de délégué sur la page, tel que AdditionalPageHead ;
en ajoutant un composant WebPart sur la page ;
en utilisant ScriptLink pour l’attribut Location sur une action personnalisée.
Vous pouvez ajouter un contrôle au délégué AdditionalPageHead pour insérer du code JavaScript dans la page. Utilisez cette méthode lorsque vous ciblez une liste spécifique pour la personnalisation. Lorsque vous utilisez une bibliothèque de documents ou une liste spécifique, le contrôle peut déterminer la liste actuelle et générer le script JavaScript de façon appropriée. La génération du script de cette façon répond à des impératifs de performances. Vous pouvez utiliser la méthode ClientScriptManagerRegisterClientScriptBlock() de l’objet System.Web.UI.Page pour générer le script.
Vous pouvez ajouter des composants WebPart à la page et inscrire le script en utilisant la méthode ClientScriptManagerRegisterClientScriptBlock() de l’objet System.Web.UI.Page ou en l’insérant directement dans la page. Cette méthode d’ajout de code JavaScript doit être utilisée lorsque le bouton du Ruban serveur est lié au composant WebPart qui émet le script JavaScript.
L’utilisation de ScriptLink pour l’attribut Location sur une action personnalisée permet d’ajouter le script sur la page au niveau de Microsoft.SharePoint.SPSite. Toutes les pages du site comporteront le script. Utilisez ce type de personnalisation lorsque du code JavaScript est utilisé dans la plupart des pages d’un site.
Le type de personnalisation que vous utilisez dépend de l’étendue du scénario. Pour obtenir un exemple de remplacement d’un bouton sur le Ruban au niveau de la collection de sites, voir Procédure pas à pas : remplacement d’un bouton sur le Ruban serveur pour une collection de sites.
Voir aussi
Tâches
Procédure pas à pas : remplacement d’un bouton sur le Ruban serveur pour une collection de sites