blob: 9c71e2d90f457c5e947005ac6333e6bae8c13625 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
---
title: theme.getCurrent()
slug: Mozilla/Add-ons/WebExtensions/API/theme/getCurrent
tags:
- API
- Add-ons
- Extensions
- Method
- Reference
- Theme
- WebExtensions
- getCurrent
translation_of: Mozilla/Add-ons/WebExtensions/API/theme/getCurrent
---
<div>{{AddonSidebar()}}</div>
<p>Retourne le theme utilisé actuellement sous la forme d'un objet {{WebExtAPIRef("theme.Theme", "Theme")}}. Les arguments disponible dans l'objet couleur sont listés dans les <a href="/fr/Add-ons/WebExtensions/manifest.json/theme#colors">propriétés de la couleur</a>.</p>
<p>Il s'agit d'une fonction asynchrone qui renvoie un objet <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p>
<h2 id="Syntaxe">Syntaxe</h2>
<pre class="brush: js">var getting = browser.theme.getCurrent(
<em>windowId</em> // integer
)
</pre>
<h3 id="Paramètres">Paramètres</h3>
<dl>
<dt><code>windowId</code> {{optional_inline}}</dt>
<dd><code>integer</code>. L'ID d'une fenêtre. Si cela est indiqué, le thème appliqué sur cette fenêtre sera retourné. Sinon le thème appliqué sur la dernière fenêtre active sera retourné.</dd>
</dl>
<h3 id="Valeur_retournée">Valeur retournée</h3>
<p>Un objet <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>. L'objet Promise sera résolu avec un objet {{WebExtAPIRef("theme.Theme")}} représentant le thème appliqué à la fenêtre spécifiée. Si aucun thème provenant d'une extension a été appliqué, l'objet Promise sera résolu avec un objet vide.</p>
<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2>
<p>{{Compat("webextensions.api.theme.getCurrent", 10)}}</p>
<h2 id="Exemples">Exemples</h2>
<p>Obtient les propriétés des couleurs <code>accentcolor</code> et <code>toolbar</code> dans le thème actuel.</p>
<pre class="brush: js">function getStyle(themeInfo)
{
if (themeInfo.colors)
{
console.log("accent color : " + themeInfo.colors.accentcolor);
console.log("toolbar : " + themeInfo.colors.toolbar);
}
}
async function getCurrentThemeInfo()
{
var themeInfo = await browser.theme.getCurrent();
getStyle(themeInfo);
}
getCurrentThemeInfo();</pre>
<p>{{WebExtExamples}}</p>
|
