Office.OfficeTheme interface

  • Référence
Paquet:
office

Permet d’accéder aux propriétés pour les couleurs du thème Office.

L’utilisation des couleurs de thème Office vous permet de coordonner le jeu de couleurs de votre complément avec le thème Office actuel sélectionné par l’utilisateur. L’utilisateur définit un thème dans une application Office via lecomptede fichier> ou lethème Officedu compte> Office. Le thème sélectionné est ensuite appliqué à toutes les applications Office. Les couleurs du thème Office s’utilisent avec les compléments de messagerie et du volet Office.

Pour plus d’informations sur les thèmes Office, voir Modifier l’apparence de Microsoft 365.

Remarques

Applications prises en charge, par plateforme

Office sur le web Office pour Windows Office sur Mac Office sur iOS Office sur Android
Excel Pris en charge Pris en charge Pris en charge Pris en charge Non disponible
Outlook Pris en charge Pris en charge Non disponible Non disponible Non disponible
PowerPoint Pris en charge Pris en charge Pris en charge Pris en charge Non disponible
Word Pris en charge Pris en charge Pris en charge Pris en charge Non disponible

Important : Dans Outlook, l’API de thème Office est prise en charge à partir de l’ensemble de conditions requises de boîte aux lettres 1.14. Il n’est pas pris en charge dans les compléments Outlook qui implémentent l’activation basée sur les événements.

Exemples

function applyOfficeTheme() {
    // Identify the current Office theme in use.
    const currentOfficeTheme = Office.context.officeTheme.themeId;

    if (currentOfficeTheme === Office.ThemeId.Colorful || currentOfficeTheme === Office.ThemeId.White) {
        console.log("No changes required.");
    }

    // Get the colors of the current Office theme.
    const bodyBackgroundColor = Office.context.officeTheme.bodyBackgroundColor;
    const bodyForegroundColor = Office.context.officeTheme.bodyForegroundColor;
    const controlBackgroundColor = Office.context.officeTheme.controlBackgroundColor;
    const controlForegroundColor = Office.context.officeTheme.controlForegroundColor;

    // Apply theme colors to a CSS class.
    $("body").css("background-color", bodyBackgroundColor);

    if (Office.context.officeTheme.isDarkTheme()) {
        $("h1").css("color", controlForegroundColor);
    }
}

Propriétés

bodyBackgroundColor

Obtient la couleur d’arrière-plan du corps du thème Office sous la forme d’un triplet de couleur hexadécimal (par exemple, « #FFA500 »).
bodyForegroundColor

Obtient la couleur de premier plan du corps du thème Office sous la forme d’un triplet de couleur hexadécimal (par exemple, « #FFA500 »).
controlBackgroundColor

Obtient la couleur d’arrière-plan du contrôle de thème Office sous la forme d’un triplet de couleur hexadécimal (par exemple, « #FFA500 »).
controlForegroundColor

Obtient la couleur de premier plan du contrôle de thème Office sous la forme d’un triplet de couleur hexadécimal (par exemple, « #FFA500 »).
isDarkTheme

Renvoie true si le thème Office actuellement sélectionné est Noir (mode sombre) ou Gris foncé.
themeId

Obtient le thème Office actuellement sélectionné.

Détails de la propriété

bodyBackgroundColor

Obtient la couleur d’arrière-plan du corps du thème Office sous la forme d’un triplet de couleur hexadécimal (par exemple, « #FFA500 »).

bodyBackgroundColor: string;

Valeur de propriété

string

bodyForegroundColor

Obtient la couleur de premier plan du corps du thème Office sous la forme d’un triplet de couleur hexadécimal (par exemple, « #FFA500 »).

bodyForegroundColor: string;

Valeur de propriété

string

controlBackgroundColor

Obtient la couleur d’arrière-plan du contrôle de thème Office sous la forme d’un triplet de couleur hexadécimal (par exemple, « #FFA500 »).

controlBackgroundColor: string;

Valeur de propriété

string

controlForegroundColor

Obtient la couleur de premier plan du contrôle de thème Office sous la forme d’un triplet de couleur hexadécimal (par exemple, « #FFA500 »).

controlForegroundColor: string;

Valeur de propriété

string

isDarkTheme

Renvoie true si le thème Office actuellement sélectionné est Noir (mode sombre) ou Gris foncé.

isDarkTheme: boolean;

Valeur de propriété

boolean

Remarques

Important : la isDarkTheme propriété n’est pas encore prise en charge dans Outlook.

themeId

Obtient le thème Office actuellement sélectionné.

themeId: ThemeId;

Valeur de propriété

Office.ThemeId

Remarques

Important : la themeId propriété n’est pas encore prise en charge dans Outlook.