Office.OfficeTheme interface

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.