Architecture du Ruban serveur

Dernière modification : jeudi 4 mars 2010

S’applique à : SharePoint Foundation 2010

Dans cet article
Objets de base du Ruban serveur
Communication du Ruban serveur
Contrôles du Ruban serveur

Le Ruban serveur de Microsoft SharePoint Foundation 2010 crée une interface utilisateur cohérente pour l’utilisation des objets SharePoint. Vous pouvez étendre le Ruban de manière déclarative à l’aide du code XML du Ruban serveur et de code ECMAScript (JavaScript, JScript) simple. Pour des scénarios plus avancés, vous pouvez également utiliser le code XML du Ruban et un composant de page.

Objets de base du Ruban serveur

Les onglets sont les éléments de niveau supérieur du Ruban. Ils apparaissent dans la partie supérieure d’une page d’un site SharePoint. Chaque onglet permet d’organiser un ensemble de groupes. Ces groupes contiennent des ensembles de contrôles. Chacun de ces groupes peut comporter plusieurs contrôles et possède une étiquette pour l’identifier. Les contrôles contenus dans le groupe comprennent des boutons, des menus déroulants, des cases à cocher, des zones de liste déroulantes, des boutons partagés et des galeries. Chacun de ces contrôles est lié à une commande unique.

Le Ruban serveur est défini à l’aide du code XML du Ruban serveur dans un manifeste de fonctionnalité ou une action personnalisée de l’utilisateur. Le code XML utilisé pour le Ruban définit chaque onglet, groupe et contrôle. L’élément Tab contient un élément Groups. Chaque élément Groups possède plusieurs éléments Group. À l’intérieur de l’élément Group se trouve un seul élément Controls qui contient plusieurs types de contrôles. Les types de contrôles disponibles sont répertoriés dans la section intitulée Contrôles du Ruban serveur. Pour obtenir une explication détaillée du code XML du Ruban, voir XML du Ruban serveur.

Communication du Ruban serveur

Le Ruban utilise plusieurs objets pour interagir avec le reste de la page. Il doit déterminer quels sont les contrôles activés, l’état de ceux-ci et à quel moment procéder à une actualisation. Le Ruban serveur communique, entre autres, à l’aide des objets CommandDispatcher, PageManager et PageComponent. Chacun de ces objets jouent un rôle important dans l’interaction avec le Ruban.

L’objet PageManager initialise tous les contrôles et inscrit l’objet PageComponent pour le Ruban. Une instance de l’objet PageManager réside sur la page.

L’objet CommandDispatcher gère tous les objets PageComponent ainsi que les commandes gérées par ces derniers. Lorsque la page reçoit une commande, l’objet CommandDispatcher la reçoit et la passe à l’objet PageComponent correct.

Un objet PageComponent est crée en ECMAScript (JavaScript, JScript). Il gère les commandes passées par l’objet CommandDispatcher. Une fois l’objet PageComponent ajouté à la page, vous devez utiliser du code JavaScriptpour créer une instance de votre objet PageComponent et l’inscrire auprès de l’objet PageManager. L’objet PageComponent peut alors répondre aux commandes définies dans le code XML du Ruban.

Contrôles du Ruban serveur

Le Ruban serveur contient de nombreux types de contrôles, notamment des contrôles simples tels que des cases à cocher, des boutons et des zones de liste déroulante, et des contrôles plus avancés, comme des boutons partagés et des lanceurs de boîte de dialogue. Les contrôles ci-après sont disponibles dans le Ruban.