Partage via

Positionner un onglet personnalisé sur le ruban

  • Article

Vous pouvez spécifier l’emplacement où vous souhaitez que l’onglet personnalisé de votre complément apparaisse sur le ruban de l’application Office en utilisant le balisage dans le manifeste du complément.

Remarque

Cet article part du principe que vous êtes familiarisé avec l’article Concepts de base pour les commandes de complément. Veuillez le consulter si vous ne l’avez pas fait récemment.

Importante

  • La fonctionnalité de complément et le balisage décrits dans cet article sont uniquement disponibles dans PowerPoint sur le web.
  • Le balisage décrit dans cet article fonctionne uniquement sur les plateformes qui prennent en charge l’ensemble de conditions requises AddinCommands 1.3. Consultez Comportement sur les plateformes non prises en charge ci-dessous.

Par défaut, un onglet personnalisé est ajouté à la fin du ruban. Toutefois, vous pouvez spécifier l’emplacement où vous souhaitez qu’un onglet personnalisé apparaisse en identifiant l’onglet Office intégré auquel vous souhaitez qu’il se trouve à côté et en spécifiant s’il doit se trouver sur le côté gauche ou droit de l’onglet intégré. Ouvrez l’onglet correspondant au type de manifeste utilisé par votre complément pour obtenir les détails du balisage du manifeste.

Remarque

Le manifeste unifié pour Microsoft 365 peut être utilisé dans les compléments Outlook de production. Il est disponible uniquement en préversion pour les compléments Excel, PowerPoint et Word.

Pour positionner votre onglet personnalisé, incluez une propriété « position » dans l’objet « extensions.ribbons.tabs ». Définissez la propriété « position.builtInTabId » sur l’ID de l’onglet intégré auquel vous souhaitez que votre onglet personnalisé se trouve en regard. (Voir Rechercher les ID des onglets du ruban Office intégrés.) Définissez la propriété « position.align » sur « before » (gauche) ou « after » (droite).

Dans l’exemple suivant, l’onglet personnalisé est configuré pour apparaître juste après l’onglet Révision .

"extensions": [
    ...
    {
        ...
        "ribbons": [
            ...
            {
                ...
                "tabs": [
                    {
                        "id": "MyTab",
                        ...
                        "position": {
                            "builtInTabId": "TabReview",
                            "align": "after"
                        }
                    }
                ]
            }
        ]
    }
]

Comment les actions de l’utilisateur peuvent affecter le positionnement des onglets personnalisés

  • Si l’utilisateur installe plusieurs compléments dont l’onglet personnalisé est configuré pour le même emplacement, par exemple après l’onglet Révision , l’onglet du dernier complément installé se trouve à cet emplacement. Les onglets des compléments précédemment installés sont déplacés à un emplacement unique. Par exemple, l’utilisateur installe les compléments A, B et C dans cet ordre et tous sont configurés pour insérer un onglet après l’onglet Révision , puis les onglets apparaissent dans cet ordre : Review, AddinCTab, AddinBTab, AddinATab.
  • Les utilisateurs peuvent personnaliser le ruban dans l’application Office. Par exemple, un utilisateur peut déplacer ou masquer l’onglet de votre complément. Vous ne pouvez pas l’empêcher ou détecter qu’elle s’est produite.
  • Si un utilisateur déplace l’un des onglets intégrés, Office interprète le balisage de positionnement dans le manifeste en fonction de l’emplacement par défaut de l’onglet intégré. Par exemple, si l’utilisateur déplace l’onglet Révision à l’extrémité droite du ruban, Office interprète le balisage de l’exemple précédent comme signifiant « placer l’onglet personnalisé juste à droite de l’emplacement où se trouve l’onglet Révision par défaut ».

Spécifier l’onglet qui a le focus à l’ouverture du document

Office donne toujours le focus par défaut à l’onglet qui se trouve immédiatement à droite de l’onglet Fichier . Par défaut, il s’agit de l’onglet Accueil . Si vous configurez votre onglet personnalisé pour qu’il soit avant l’onglet Accueil , votre onglet personnalisé est activé lorsque le document s’ouvre.

Importante

Donner une importance excessive à votre complément dérange et contrarie les utilisateurs et les administrateurs. Ne positionnez pas un onglet personnalisé avant l’onglet Accueil , sauf si votre complément est le principal moyen d’interagir avec le document.

Comportement sur les plateformes non prises en charge

Si votre complément est installé sur une plateforme qui ne prend pas en charge l’ensemble de conditions requises AddinCommands 1.3, le balisage décrit dans cet article est ignoré et votre onglet personnalisé s’affiche sous la forme de l’onglet le plus à droite du ruban. Pour empêcher l’installation de votre complément sur des plateformes qui ne prennent pas en charge le balisage, vous devez spécifier AddinCommands 1.3 dans le manifeste comme condition requise pour l’installation. Pour obtenir des instructions, voir Spécifier les versions et plateformes Office qui peuvent héberger votre complément. Vous pouvez également concevoir votre complément pour qu’il ait une autre expérience quand AddinCommands 1.3 n’est pas pris en charge, comme décrit dans Conception d’expériences alternatives. Par exemple, si votre complément contient des instructions qui supposent que l’onglet personnalisé est là où vous le souhaitez, vous pouvez avoir une autre version qui suppose que l’onglet est le plus à droite.