Partager via

Compléments Office de contenu

  • Article

Les compléments de contenu sont des surfaces qui peuvent être incorporées directement dans des documents Excel ou PowerPoint. Les compléments de contenu permettent aux utilisateurs d’accéder aux contrôles d’interface qui exécutent le code pour modifier des documents ou afficher des données d’une source de données. Utilisez les compléments de contenu lorsque vous souhaitez incorporer des fonctionnalités directement dans le document.

Figure 1. Disposition classique pour les compléments de contenu

Disposition classique des compléments de contenu dans une application Office.

Meilleures pratiques

  • Inclure un élément de navigation ou de commande comme le CommandBar ou le tableau croisé dynamique en haut de votre complément.
  • Inclure un élément de la marque tel que BrandBar en bas de votre complément (s’applique aux compléments Excel et PowerPoint uniquement).

Variantes

Les tailles de complément de contenu pour Excel et PowerPoint dans le bureau Office et dans un navigateur web sont spécifiées par l’utilisateur.

Menu Caractéristique

Les menus Caractéristique peuvent entraver les éléments de navigation et de commande se trouvant en haut à droite du complément. Voici les dimensions actuelles du menu Caractéristique sur Windows et Mac.

Pour Windows, le menu Caractéristique mesure 12 x 32 pixels, comme illustré.

Figure 2. Menu Personnalité sur Windows

Menu de personnalité de 12 x 32 pixels sur le bureau Windows.

Pour Mac, le menu Caractéristique mesure 26 x 26 pixels, mais flotte à 8 pixels de la droite et à 6 pixels du haut, ce qui permet d’augmenter l’espace occupé à 34 x 32 pixels, comme illustré.

Figure 3. Menu Personnalité sur Mac

Menu de personnalité de 34 x 32 pixels sur le bureau Mac.

Implémentation

Il existe des différences mineures dans les manifestes entre les compléments de contenu et les compléments qui utilisent des volets Office. Ouvrez l’onglet correspondant au type de manifeste que vous utilisez.

Remarque

Le manifeste unifié est disponible dans Excel, PowerPoint et Word en préversion pour les développeurs. Pour Outlook, il est généralement disponible et peut être utilisé dans les compléments de production.

Configurez le manifeste en procédant comme suit.

  1. Ajoutez un tableau enfant « contentRuntimes » à l’objet d’extension dans le tableau « extensions ».
  2. Supprimez la propriété « runtimes » si elle est présente. Le tableau « runtimes » est destiné aux compléments de volet Office ou de messagerie. Ceux-ci ne peuvent pas être combinés avec un complément de contenu.
  3. Ajoutez un objet d’exécution de contenu anonyme dans le tableau « contentRuntimes ».
  4. Définissez la propriété « id » de l’objet sur un nom descriptif.
  5. Définissez l’objet « code.page » sur l’URL complète du contenu personnalisé que vous souhaitez incorporer dans le document.
  6. Si vous le souhaitez, définissez les propriétés « requestedWidth » et « requestedHeight » sur une taille comprise entre 32 et 1 000 pixels. Si ces propriétés ne sont pas utilisées, l’application Office détermine la taille.
  7. Si vous le souhaitez, définissez la propriété « disableSnapshot » sur true pour empêcher Office d’enregistrer une instantané du composant de contenu avec le document.

Voici un exemple de propriété « contentRuntimes ».

"contentRuntimes": [
    {
        "id": "ContentRuntime",
        "code": {
            "page": "https://localhost:3000/content.html"
        },
        "requestedWidth": 100,
        "requestedHeight": 100,
        "disableSnapshot": true,
    }
]

Pour obtenir un exemple qui implémente un complément de contenu, consultez Complément de contenu Excel Humongous Insurance sur GitHub.

Pour créer votre propre complément de contenu, consultez démarrage rapide du complément de contenu Excel et Démarrage rapide du complément de contenu PowerPoint.

Considérations relatives à la prise en charge

  • Vérifiez si votre complément Office fonctionnera sur une application ou une plateforme Office spécifique.
  • Certains compléments de contenu peuvent exiger que l’utilisateur accepte que le complément lise et écrive dans Excel ou PowerPoint. Vous pouvez déclarer le niveau des autorisations que vous souhaitez attribuer à votre utilisateur dans le manifeste du complément.

Voir aussi