> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Palette de couleurs

> Palette de couleurs

# Palette de couleurs

Une collection de couleurs réutilisables qui peuvent être référencées dans les dispositions.

## Propriétés

`default` - *objet*, *facultatif*. Une collection de définitions de [couleurs hexadécimales](/fr/reference/system/touchadaptationkit/types/game-streaming-touch-hexcolor) qui peuvent être référencées à l'aide d'une [référence de couleur](/fr/reference/system/touchadaptationkit/types/game-streaming-touch-colorreference).

`highContrast` - *objet*, *facultatif*. Une collection de définitions de [couleurs hexadécimales](/fr/reference/system/touchadaptationkit/types/game-streaming-touch-hexcolor) qui peuvent être référencées à l'aide d'une [référence de couleur](/fr/reference/system/touchadaptationkit/types/game-streaming-touch-colorreference). Remplace les définitions de `default` lorsque le [mode Contraste élevé](/fr/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-high-contrast-mode) est activé.

<a id="sample" />

## Exemple

```JSON theme={null}
{
  "$schema": "https://raw.githubusercontent.com/microsoft/xbox-game-streaming-tools/main/touch-adaptation-kit/schemas/layout/4.0/layout.json",
  "styles": {
    "colors": {
      "default": {
        "myColor1": "#ff0000ff",
        "myColor2": "#00ff00ff",
        "system_contentPrimary": "#0000ffff"
      },
      "highContrast": {
        "myColor1": "#00ff00ff",
        "system_contrastPrimary": "#0000ffaa"
      }
    }
  },
  "content": {
    "left": {
      "inner": [
        {
          "type": "directionalPad",
          "styles": {
            "idle": {
              "background": {
                "type": "color",
                "value": "colors/myColor1"
              }
            }
          }
        }
      ]
    },
    "right": {
      "inner": [
          {
              "type": "button",
              "action": "gamepadY"
          },
          {
              "type": "button",
              "action": "gamepadB"
          },
          {
              "type": "button",
              "action": "gamepadA",
              "styles": {
                "idle": {
                  "background": {
                    "type": "color",
                    "value": "colors/myColor2"
                  }
                }
              }
          },
          {
              "type": "button",
              "action": "gamepadX"
          }
      ]
    }
  }
}
```

La disposition ci-dessus avec le mode Contraste élevé **désactivé** :

<img src="https://mintcdn.com/microsoft-4404708b/-_0FrcE2bDxzGxv-/images/gdk/reference/game-streaming-tak-color-palette-reference-hc-disabled.png?fit=max&auto=format&n=-_0FrcE2bDxzGxv-&q=85&s=dba732004eecd1db8fc9a608c31248cd" alt="Disposition tactile avec palette de couleurs et mode Contraste élevé désactivé" width="1006" height="506" data-path="images/gdk/reference/game-streaming-tak-color-palette-reference-hc-disabled.png" />

Et avec le mode Contraste élevé **activé** :

<img src="https://mintcdn.com/microsoft-4404708b/-_0FrcE2bDxzGxv-/images/gdk/reference/game-streaming-tak-color-palette-reference-hc-enabled.png?fit=max&auto=format&n=-_0FrcE2bDxzGxv-&q=85&s=fff468e0eba734e9edec6527e7584262" alt="Disposition tactile avec palette de couleurs et mode Contraste élevé activé" width="1000" height="502" data-path="images/gdk/reference/game-streaming-tak-color-palette-reference-hc-enabled.png" />

<a id="remarks" />

## Remarques

L'[exemple](#sample) ci-dessus inclut des définitions de couleurs qui remplacent les [couleurs système](#system-colors) (par exemple, `system_contentPrimary`, `system_accentPrimary`, etc.) ainsi que des définitions de couleurs personnalisées (`myColor1`, `myColor2`). Les contrôles utilisent **implicitement** les couleurs système lors de l'application du style, ce qui signifie que tout remplacement affecte le style global de tous les contrôles (sauf si un contrôle possède son propre remplacement dans un bloc `styles` personnalisé). Les couleurs personnalisées doivent être référencées **explicitement** à l'aide d'une [référence de couleur](/fr/reference/system/touchadaptationkit/types/game-streaming-touch-colorreference) (par exemple, `colors/myColor1`). En outre, les définitions de couleurs personnalisées **ne peuvent pas** utiliser le préfixe réservé `system_`, car il est réservé aux couleurs système.

Les définitions de couleurs sont déclarées dans les objets `default` et `highContrast`, et sont activées respectivement lorsque le [mode Contraste élevé](/fr/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-high-contrast-mode) est désactivé ou activé. Lorsque le mode Contraste élevé est désactivé, les couleurs sont prises dans `default`. Lorsqu'il est activé, les couleurs sont d'abord prises dans `highContrast`, avec un repli sur `default` si aucune définition n'existe. Si un remplacement de couleur système n'est pas présent dans `default`, une valeur système par défaut est utilisée, tandis que les couleurs personnalisées **doivent** être définies dans `default`. Le tableau suivant indique comment les définitions de couleurs ci-dessus sont résolues selon que le mode Contraste élevé (HC) est activé ou non :

| Définition de couleur | Mode HC désactivé | Mode HC activé |
| :- | - | - |
| myColor1 | `#ff0000ff` | `#00ff00ff` |
| myColor2 | `#00ff00ff` | `#00ff00ff` |
| system\_contentPrimary | `#0000ffff` | `#0000ffff` |
| system\_contrastPrimary | valeur système par défaut | `#0000ffaa` |

<a id="system-colors" />

## Couleurs système

Le tableau suivant récapitule la liste des couleurs système du touch adaptation kit, une description de la façon dont elles sont utilisées pour styliser les contrôles, ainsi que leurs valeurs système par défaut lorsque le mode Contraste élevé (HC) est désactivé/activé.

| Couleur système | Description | Mode HC désactivé | Mode HC activé |
| :- | :- | :- | :- |
| system\_contentPrimary | Couleur utilisée pour styliser des composants tels que les traits médians, les teintes d'icônes et les dégradés de la croix directionnelle. | `#ffffffff` | `#ffffffff` |
| system\_contentSecondary | Couleur utilisée pour styliser des composants tels que les arrière-plans et les remplissages. | `#ffffff1a` | `#ffffffff` |
| system\_contrastPrimary | Couleur utilisée pour styliser des composants de contraste tels que les traits intérieurs/extérieurs et les plaques de fond des images de face. | `#00000000` | `#000000bf` |
| system\_contrastSecondary | Couleur utilisée pour styliser des composants de contraste tels que les traits du pavé tactile. | `#00000000` | `#ffffffff` |
| system\_actionColorDefault | Couleur utilisée pour styliser les composants des contrôles dont le champ `action` est défini sur une action autre qu'une action de manette. | `#ffffffff` | `#ffffffe6` |
| system\_actionColorA | Couleur utilisée pour styliser les composants des contrôles dont le champ `action` est défini sur `gamepadA`. | `#7eb902ff` | `#ffffffe6` |
| system\_actionColorB | Couleur utilisée pour styliser les composants des contrôles dont le champ `action` est défini sur `gamepadB`. | `#f25127ff` | `#ffffffe6` |
| system\_actionColorX | Couleur utilisée pour styliser les composants des contrôles dont le champ `action` est défini sur `gamepadX`. | `#00a2eeff` | `#ffffffe6` |
| system\_actionColorY | Couleur utilisée pour styliser les composants des contrôles dont le champ `action` est défini sur `gamepadY`. | `#ffb807ff` | `#ffffffe6` |
| system\_accentPrimary | Couleur utilisée pour styliser des composants tels que la roue intérieure de l'édition ergonomique. | `#8cc08cff` | `#8cc08cff` |
| system\_accentSecondary | Couleur utilisée pour styliser des composants tels que la roue extérieure de l'édition ergonomique. | `#61ab61ff` | `#61ab61ff` |

Pour obtenir une liste à jour, reportez-vous aux définitions préfixées par `_SystemColor` dans le [schéma le plus récent](https://github.com/microsoft/xbox-game-streaming-tools/blob/main/touch-adaptation-kit/schemas/layout/v4.0/layout.json).

## Voir aussi

[Référence du Touch Adaptation Kit](/fr/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview)\
[Mode Contraste élevé pour les dispositions Touch Adaptation](/fr/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-high-contrast-mode)


## Related topics

- [Compiler et exécuter votre premier titre console GDKX](/fr-CA/home/build-first-title/first-console-title-walkthrough.md)
- [Étiquettes de fonctionnalités d'accessibilité](/fr/build/game-principles/accessibility/accessibility-feature-tags.md)
- [Customizing the Touch Controls Preview](/build/core-features/common/game-streaming/tak-editor/game-streaming-tak-editor-customize-preview.md)
- [XBOX Accessibility Guidelines (XAG)](/fr/build/game-principles/accessibility/xbox-accessibility-guidelines.md)
- [TAK Editor Setup](/build/core-features/common/game-streaming/tak-editor/game-streaming-tak-editor-setup.md)
