Ce navigateur n’est plus pris en charge.
Effectuez une mise à niveau vers Microsoft Edge pour tirer parti des dernières fonctionnalités, des mises à jour de sécurité et du support technique.
Les raccourcis clavier, également appelés combinaisons de touches, permettent aux utilisateurs de votre complément de travailler plus efficacement. Les raccourcis clavier améliorent également l’accessibilité du complément pour les utilisateurs handicapés en fournissant une alternative à la souris.
Il existe trois étapes pour ajouter des raccourcis clavier à un complément.
Les raccourcis clavier ne sont actuellement pris en charge que dans les plateformes suivantes et la build d’Excel et Word.
Office sur le web
Note
La fonctionnalité de raccourci clavier est en cours de déploiement pour Word sur le web. Si vous testez la fonctionnalité dans Word sur le web pour le moment, les raccourcis risquent de ne pas fonctionner s’ils sont activés à partir du volet Office du complément. Nous vous recommandons d’case activée régulièrement les ensembles de conditions requises raccourcis clavier pour savoir quand la fonctionnalité est entièrement prise en charge.
Office pour Windows
Office sur Mac
En outre, les raccourcis clavier fonctionnent uniquement sur les plateformes qui prennent en charge les ensembles de conditions requises suivants. Pour plus d’informations sur les ensembles de conditions requises et leur utilisation, consultez Spécifier les applications Office et les exigences d’API.
Conseil
Pour commencer avec une version opérationnelle d’un complément avec des raccourcis clavier déjà configurés, clonez et exécutez l’exemple Utiliser les raccourcis clavier pour les actions de complément Office . Lorsque vous êtes prêt à ajouter des raccourcis clavier à votre propre complément, poursuivez avec cet article.
Le processus de définition des raccourcis clavier personnalisés pour votre complément varie en fonction du type de manifeste utilisé par votre complément. Sélectionnez l’onglet correspondant au type de manifeste que vous utilisez.
Conseil
Pour en savoir plus sur les manifestes pour les compléments Office, voir Manifeste des compléments Office.
Note
L’implémentation de raccourcis clavier avec le manifeste d’application unifié pour Microsoft 365 est disponible en préversion publique pour les développeurs. Il ne doit pas être utilisé dans les compléments de production. Nous vous invitons à l’essayer dans des environnements de test ou de développement. Pour plus d’informations, consultez Schéma du manifeste de l’application développeur public en préversion.
Si votre complément utilise le manifeste d’application unifié pour Microsoft 365, les raccourcis clavier personnalisés et leurs actions sont définis dans le manifeste.
Dans votre projet de complément, ouvrez le fichier manifest.json .
Ajoutez l’objet suivant au tableau « extensions.runtimes ». Notez les points suivants concernant ce balisage.
"runtimes": [
{
"id": "TaskPaneRuntime",
"type": "general",
"code": {
"page": "https://localhost:3000/taskpane.html"
},
"lifetime": "long",
"actions": [
{
"id": "ShowTaskpane",
"type": "executeFunction",
"displayName": "Show task pane (Contoso Add-in)"
},
{
"id": "HideTaskpane",
"type": "executeFunction",
"displayName": "Hide task pane (Contoso Add-in)"
}
],
}
]
Ajoutez ce qui suit au tableau « extensions ». Notez ce qui suit à propos du balisage.
"keyboardShortcuts": [
{
"requirements": {
"capabilities": [
{
"name": "SharedRuntime",
"minVersion": "1.1"
}
]
},
"shortcuts": [
{
"key": {
"default": "Ctrl+Alt+Up",
"mac": "Command+Shift+Up",
"web": "Ctrl+Alt+1",
"windows": "Ctrl+Alt+Up"
},
"actionId": "ShowTaskpane"
},
{
"key": {
"default": "Ctrl+Alt+Down",
"mac": "Command+Shift+Down",
"web": "Ctrl+Alt+2",
"windows": "Ctrl+Alt+Up"
},
"actionId": "HideTaskpane"
}
]
}
]
Dans votre projet, ouvrez le fichier JavaScript chargé par votre page HTML dans l’élément <FunctionFile> .
Dans le fichier JavaScript, utilisez l’API Office.actions.associate pour mapper chaque action que vous avez spécifiée à une étape précédente à une fonction JavaScript. Ajoutez le code JavaScript suivant au fichier. Notez ce qui suit à propos du code.
Office.actions.associate("ShowTaskpane", () => {
return Office.addin.showAsTaskpane()
.then(() => {
return;
})
.catch((error) => {
return error.code;
});
});
Office.actions.associate("HideTaskpane", () => {
return Office.addin.hide()
.then(() => {
return;
})
.catch((error) => {
return error.code;
});
});
Utilisez les instructions suivantes pour créer des combinaisons de touches personnalisées pour vos compléments.
+ caractère.Note
Les raccourcis clavier personnalisés doivent être enfoncés simultanément. Les touches d’accès, également appelées raccourcis de touches séquentielles (par exemple, Alt+H, H), ne sont pas prises en charge dans les compléments Office.
Lorsque vous utilisez des raccourcis clavier personnalisés sur le web, certains raccourcis clavier utilisés par le navigateur ne peuvent pas être remplacés par des compléments. La liste suivante est un travail en cours. Si vous découvrez d’autres combinaisons qui ne peuvent pas être remplacées, faites-le nous savoir à l’aide de l’outil de commentaires au bas de cette page.
De nombreux raccourcis clavier sont déjà utilisés par Microsoft 365. Évitez d’inscrire des raccourcis clavier pour votre complément qui sont déjà utilisés. Toutefois, dans certains cas, il peut être nécessaire de remplacer les raccourcis clavier existants ou de gérer les conflits entre plusieurs compléments qui ont inscrit le même raccourci clavier.
En cas de conflit, l’utilisateur voit une boîte de dialogue la première fois qu’il tente d’utiliser un raccourci clavier en conflit. Notez que la source du texte de l’option de complément affichée dans cette boîte de dialogue varie en fonction du type de manifeste utilisé par votre complément. - Manifeste d’application unifié pour Microsoft 365 : valeur de la propriété « extensions.runtimes.actions.displayName » dans le fichier manifest.json . - Manifeste de complément uniquement : valeur de la propriété « actions.name » dans le fichier JSON de raccourcis.
L’utilisateur peut sélectionner l’action que le raccourci clavier effectuera. Après avoir effectué la sélection, la préférence est enregistrée pour les utilisations futures du même raccourci. Les préférences de raccourci sont enregistrées par utilisateur, par plateforme. Si l’utilisateur souhaite modifier ses préférences, il peut appeler la commande de raccourci Réinitialiser les préférences des compléments Office à partir de la zone de recherche Rechercher . L’appel de la commande efface toutes les préférences de raccourci de complément de l’utilisateur et l’utilisateur sera à nouveau invité avec la boîte de dialogue de conflit la prochaine fois qu’il tentera d’utiliser un raccourci en conflit.
Pour une expérience utilisateur optimale, nous vous recommandons de réduire les conflits de raccourci clavier avec ces bonnes pratiques.
Vous devrez peut-être localiser vos raccourcis clavier personnalisés dans les scénarios suivants.
Les conseils sur la façon de localiser vos raccourcis clavier varient en fonction du type de manifeste utilisé par votre complément.
Pour savoir comment localiser vos raccourcis clavier personnalisés avec le manifeste d’application unifié pour Microsoft 365, consultez Localiser des chaînes dans votre manifeste d’application.
Note
Les API décrites dans cette section nécessitent l’ensemble de conditions requises KeyboardShortcuts 1.1 .
Les utilisateurs de votre complément peuvent réaffecter les actions du complément à d’autres combinaisons de clavier.
Utilisez la méthode Office.actions.replaceShortcuts pour affecter les combinaisons de clavier personnalisées d’un utilisateur à vos actions de compléments. La méthode accepte un paramètre de type {[actionId:string]: string|null}, où les actionIdsont un sous-ensemble des ID d’action qui doivent être définis dans le fichier JSON du manifeste étendu du complément. Les valeurs sont les combinaisons de touches préférées de l’utilisateur. La valeur peut également être null, ce qui supprimera toute personnalisation pour cela actionId et rétablira la combinaison de clavier par défaut spécifiée.
Si l’utilisateur est connecté à Microsoft 365, les combinaisons personnalisées sont enregistrées dans les paramètres d’itinérance de l’utilisateur par plateforme. La personnalisation des raccourcis n’est actuellement pas prise en charge pour les utilisateurs anonymes.
const userCustomShortcuts = {
ShowTaskpane: "Ctrl+Shift+1",
HideTaskpane: "Ctrl+Shift+2"
};
Office.actions.replaceShortcuts(userCustomShortcuts)
.then(() => {
console.log("Successfully registered shortcut.");
})
.catch((error) => {
if (error.code == "InvalidOperation") {
console.log("ActionId doesn't exist or shortcut combination is invalid.");
}
});
Pour savoir quels raccourcis sont déjà utilisés pour l’utilisateur, appelez la méthode Office.actions.getShortcuts . Cette méthode retourne un objet de type [actionId:string]:string|null}, où les valeurs représentent la combinaison de clavier actuelle que l’utilisateur doit utiliser pour appeler l’action spécifiée. Les valeurs peuvent provenir de trois sources différentes.
null étant que le raccourci a été remplacé et qu’il n’existe aucune combinaison de clavier que l’utilisateur peut actuellement utiliser pour appeler cette action de complément.Voici un exemple.
Office.actions.getShortcuts()
.then((userShortcuts) => {
for (const action in userShortcuts) {
let shortcut = userShortcuts[action];
console.log(action + ": " + shortcut);
}
});
Comme décrit dans Éviter les combinaisons de touches utilisées par d’autres compléments, il est recommandé d’éviter les conflits dans les raccourcis. Pour savoir si une ou plusieurs combinaisons de touches sont déjà utilisées, transmettez-les sous forme de tableau de chaînes à la méthode Office.actions.areShortcutsInUse . La méthode retourne un rapport contenant des combinaisons de touches déjà utilisées sous la forme d’un tableau d’objets de type {shortcut: string, inUse: boolean}. La shortcut propriété est une combinaison de touches, telle que « Ctrl+Maj+1 ». Si la combinaison est déjà inscrite dans une autre action, la inUse propriété a la truevaleur . Par exemple : [{shortcut: "Ctrl+Shift+1", inUse: true}, {shortcut: "Ctrl+Shift+2", inUse: false}]. L’extrait de code suivant est un exemple.
const shortcuts = ["Ctrl+Shift+1", "Ctrl+Shift+2"];
Office.actions.areShortcutsInUse(shortcuts)
.then((inUseArray) => {
const availableShortcuts = inUseArray.filter((shortcut) => {
return !shortcut.inUse;
});
console.log(availableShortcuts);
const usedShortcuts = inUseArray.filter((shortcut) => {
return shortcut.inUse;
});
console.log(usedShortcuts);
});
Vous pouvez implémenter un raccourci clavier personnalisé à utiliser dans les applications Microsoft 365 prises en charge, telles qu’Excel et Word. Si l’implémentation permettant d’effectuer la même tâche est différente sur chaque application, vous devez utiliser la Office.actions.associate méthode pour appeler une fonction de rappel différente pour chaque application. Voici un exemple de code.
const host = Office.context.host;
if (host === Office.HostType.Excel) {
Office.actions.associate("ChangeFormat", changeFormatExcel);
} else if (host === Office.HostType.Word) {
Office.actions.associate("ChangeFormat", changeFormatWord);
}
...
Commentaires sur Office Add-ins
Office Add-ins est un projet open source. Sélectionnez un lien pour fournir des commentaires :
Formation
Parcours d’apprentissage
Use advance techniques in canvas apps to perform custom updates and optimization - Training
Use advance techniques in canvas apps to perform custom updates and optimization
Certification
Microsoft Office Specialist: Associate (Microsoft 365 Apps) - Certifications
Microsoft Office Specialist: Associate (Microsoft 365 Apps)