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.

Type de contrôle

Description

Bouton

Bouton simple servant à exécuter une action.

Case à cocher

Case à cocher servant à sélectionner une option.

Sélecteur de couleurs

Grille servant à sélectionner une couleur ou un style.

Zone de liste déroulante

Liste servant à sélectionner une valeur à l’aide d’un clic ou de la saisie de texte.

Liste déroulante

Liste servant à sélectionner une valeur à l’aide d’un clic.

Lanceur de boîte de dialogue

Bouton avec une flèche vers le bas servant à ouvrir un menu.

Insérer un tableau

Grille de 10 par 10 servant à spécifier les dimensions d’un tableau.

Étiquette

Ligne de texte servant à fournir des informations.

Menu

Conteneur servant à afficher des menus contextuels.

Section de menu

Section servant à diviser un menu. Une section de menu peut comporter un titre et des contrôles.

Bouton partagé pour les actions utilisées récemment

Bouton servant à exécuter une action de menu utilisée récemment. Ce contrôle utilise la dernière action choisie dans son sous-menu comme action du bouton.

Zone de sélection numérique

Contrôle servant à insérer une valeur en la tapant ou en utilisant les flèches de direction pour parcourir les valeurs.

Bouton partagé

Contrôle servant à la fois de bouton et de menu.

Zone de texte

Contrôle servant à entrer du texte.

Bouton bascule

Bouton servant à basculer entre l’état activé et l’état désactivé.