Ajouter des touches d’accès personnalisées à vos compléments Office

Les touches d’accès, également appelées raccourcis clavier séquentiels ou touches d’accès, fournissent une méthode de navigation au clavier efficace pour les utilisateurs de votre complément. Contrairement aux raccourcis clavier simultanés (tels que Ctrl+S) utilisés pour exécuter des opérations au sein d’un complément, les touches d’accès sont enfoncées dans l’ordre pour accéder rapidement aux options à partir du ruban Office. Les touches d’accès aident les utilisateurs à :

  • Naviguez rapidement dans le ruban et accédez aux actions.
  • Prise en charge de la navigation au clavier uniquement pour l’accessibilité.

Conseil

La commande clavier permettant d’accéder aux touches d’accès varie en fonction de la plateforme. Pour vous familiariser avec les touches d’accès, consultez Utiliser le clavier pour utiliser le ruban.

Applications et plateformes Office prises en charge

Les touches d’accès personnalisées sont prises en charge dans les applications et plateformes Office suivantes.

Application Office Office sur le web Office pour Windows Office sur Mac
Excel Pris en charge Pris en charge Pris en charge
Outlook Non pris en charge Non pris en charge Non pris en charge
PowerPoint Pris en charge Pris en charge Pris en charge
Word Pris en charge Pris en charge Pris en charge

Remarque

Les touches d’accès personnalisées sont prises en charge dans Office sur Windows et sur Mac dans des versions d’hôte spécifiques.

  • Windows : version 2603 (build 19822.20000) ou ultérieure
  • Mac : version 16.107 (build 26030819) ou ultérieure

Pour vérifier la version de l’application hôte, appelez Office.context.diagnostics. version.

Surfaces et contrôles pris en charge

Les touches d’accès peuvent être définies pour les contrôles du complément et l’onglet du ruban dans lequel le complément s’affiche. Le tableau suivant présente les onglets et contrôles du ruban qui autorisent les touches d’accès pour chaque application Office prise en charge.

Type d’onglet Excel PowerPoint Word
Onglets Office intégrés Pris en charge Pris en charge Pris en charge
Boutons Pris en charge Pris en charge Pris en charge
Onglet contextuel Non disponible Non disponible Non disponible
Onglet personnalisé Pris en charge Pris en charge Pris en charge
Menus Pris en charge Pris en charge Pris en charge
Éléments de menu Non disponible Non disponible Non disponible

Essayer un complément terminé

Pour tester immédiatement les touches d’accès personnalisées dans un complément Office, essayez l’exemple Définir des info-bulles pour les contrôles du ruban d’un complément Office.

Configurer le manifeste

Les touches d’accès personnalisées sont définies dans le manifeste de votre complément. L’exemple suivant personnalise les touches d’accès au complément et à ses actions à partir de l’onglet Accueil intégré et d’un onglet personnalisé. Notez ce qui suit à propos de ce balisage.

  • La "keytip" propriété définit la séquence de touches sur laquelle les utilisateurs appuient pour activer une touche d’accès personnalisée. Il prend en charge jusqu’à trois caractères alphanumériques majuscules (« A-Z », « 0-9 »). La "keytip" propriété est spécifiée pour les onglets et contrôles suivants.
{
    "extensions": [
        {
            ...
            "ribbons": [
                {
                    ...
                    "tabs": [
                        {
                            "builtInTabId": "TabHome",
                            "groups": [
                                {
                                    "id": "ContosoGroup",
                                    ...
                                    "controls": [
                                        {
                                            "id": "AnalyzeButton",
                                            "type": "button",
                                            "label": "Analyze Data",
                                            "icons": [
                                                {
                                                    "size": 16,
                                                    "url": "https://localhost:3000/assets/icon-16.png"
                                                },
                                                {
                                                    "size": 32,
                                                    "url": "https://localhost:3000/assets/icon-32.png"
                                                },
                                                {
                                                    "size": 80,
                                                    "url": "https://localhost:3000/assets/icon-80.png"
                                                }
                                            ],
                                            "supertip": {
                                                "title": "Analyze Data",
                                                "description": "Perform advanced data analysis."
                                            },
                                            "actionId": "analyzeData",
                                            "keytip": "AD"
                                        },
                                        {
                                            "id": "DataMenu",
                                            "type": "menu",
                                            "label": "Manage Data",
                                            "icons": [
                                                {
                                                    "size": 16,
                                                    "url": "https://localhost:3000/assets/icon-16.png"
                                                },
                                                {
                                                    "size": 32,
                                                    "url": "https://localhost:3000/assets/icon-32.png"
                                                },
                                                {
                                                    "size": 80,
                                                    "url": "https://localhost:3000/assets/icon-80.png"
                                                }
                                            ],
                                            "supertip": {
                                                "title": "Manage Data",
                                                "description": "Options to manage data."
                                            },
                                            "items": [
                                                ...
                                            ],
                                            "keytip": "MD"
                                        }
                                    ]
                                }
                            ],
                            "keytip": "CH"
                        },
                        {
                            "id": "CustomTab",
                            "label": "Contoso custom tab",
                            "groups": [
                                {
                                    "id": "CustomContosoGroup",
                                    "label": "Contoso Custom Group",
                                    "icons": [
                                        {
                                            "size": 16,
                                            "url": "https://localhost:3000/assets/icon-16.png"
                                        },
                                        {
                                            "size": 32,
                                            "url": "https://localhost:3000/assets/icon-32.png"
                                        },
                                        {
                                            "size": 80,
                                            "url": "https://localhost:3000/assets/icon-80.png"
                                        }
                                    ],
                                    "controls": [
                                        {
                                            "id": "CustomTabButton",
                                            ...
                                            "keytip": "CTB"
                                        }
                                    ]
                                }
                            ],
                            "overriddenByRibbonApi": true,
                            "keytip": "CT"
                        }
                    ]
                }
            ]
        }
    ]
}

Gérer les conflits d’info-bulle

L’application hôte Microsoft 365 recherche les conflits d’info-clés entre les compléments et les commandes intégrées. Si l’application hôte détecte un conflit, elle attribue automatiquement une touche d’accès de secours à l’aide du préfixe Y suivi d’un nombre, tel que Y1, Y2 ou Y3. Ces touches d’accès de secours garantissent que chaque commande reste accessible de manière unique par le clavier.

Conseil

Choisissez des touches d’accès personnalisées qui sont peu susceptibles de chevaucher les commandes intégrées du ruban. Pour obtenir la liste des touches d’accès intégrées pour chaque application hôte Microsoft 365, consultez les articles suivants.

Comportement et limitations

Lorsque vous implémentez des touches d’accès pour votre complément, tenez compte des comportements et limitations suivants.

  • Les touches d’accès personnalisées sont uniquement prises en charge dans un complément qui utilise un manifeste unifié. Si votre complément utilise un manifeste de complément uniquement, vous devez le convertir en manifeste unifié pour configurer les touches d’accès. Pour obtenir des conseils sur la conversion de votre manifeste, consultez Convertir un complément pour utiliser le manifeste unifié pour Microsoft 365.
  • Les touches d’accès personnalisées prennent en charge jusqu’à trois caractères alphanumériques majuscules et doivent être uniques entre les onglets et les contrôles.
  • Les touches d’accès personnalisées ne fonctionnent pas dans les versions antérieures des applications Office qui ne prennent pas en charge les touches d’accès. Dans ces versions antérieures, les utilisateurs voient les touches d’accès par défaut affectées au complément à la place.
  • L’utilisateur ne peut pas modifier les touches d’accès du complément.
  • Dans Office sur le Web, la clé X est réservée et ne peut pas être utilisée comme une touche d’accès personnalisée.
  • Dans Office sur Mac, les touches d’accès sont désactivées par défaut. Les utilisateurs doivent activer les touches d’accès dans leurs paramètres Office pour utiliser les touches d’accès définies pour votre complément. Pour plus d’informations, consultez Utiliser le clavier pour utiliser le ruban.

Voir aussi