> ## 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
Collection de couleurs réutilisables qui peuvent être référencées dans les dispositions.
## Propriétés
`default` - *objet*, *facultatif*. Collection de définitions de [couleurs hexadécimales](/fr-CA/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-CA/reference/system/touchadaptationkit/types/game-streaming-touch-colorreference).
`highContrast` - *objet*, *facultatif*. Collection de définitions de [couleurs hexadécimales](/fr-CA/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-CA/reference/system/touchadaptationkit/types/game-streaming-touch-colorreference). Remplace les définitions de `default` lorsque le [mode de contraste élevé](/fr-CA/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-high-contrast-mode) est activé.
## 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 de contraste élevé **désactivé** :
Et avec le mode de contraste élevé **activé** :
## Remarques
L'[exemple](#sample) ci-dessus comprend des définitions de couleurs qui remplacent les [couleurs système](#system-colors) (p. ex., `system_contentPrimary`, `system_accentPrimary`, etc.) ainsi que des définitions de couleurs personnalisées (`myColor1`, `myColor2`). Les contrôles échantillonnent **implicitement** les couleurs système lors de l'application du style, ce qui signifie que tout remplacement aura une incidence sur le style global de tous les contrôles (à moins qu'un contrôle ait 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-CA/reference/system/touchadaptationkit/types/game-streaming-touch-colorreference) (p. ex., `colors/myColor1`). De plus, les définitions de couleurs personnalisées **ne peuvent pas** utiliser le préfixe `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 lorsque le [mode de contraste élevé](/fr-CA/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-high-contrast-mode) est respectivement désactivé ou activé. Lorsque le mode de contraste élevé est désactivé, les couleurs sont échantillonnées à partir de `default`. Lorsqu'il est activé, les couleurs sont d'abord échantillonnées à partir de `highContrast`, avec un repli sur `default` si aucune définition n'existe. Si aucun remplacement de couleur système n'est 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 seront résolues selon que le mode de 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` |
## Couleurs système
Le tableau suivant résume 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 de 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 intermédiaires, 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 d'arrière-plan 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 d'ergo-edit. | `#8cc08cff` | `#8cc08cff` |
| system\_accentSecondary | Couleur utilisée pour styliser des composants tels que la roue extérieure d'ergo-edit. | `#61ab61ff` | `#61ab61ff` |
Pour obtenir une liste à jour, consultez les définitions précédées du préfixe `_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-CA/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview)\
[Mode de contraste élevé pour les dispositions Touch Adaptation](/fr-CA/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-high-contrast-mode)
## Related topics
- [Touch Adaptation Kit](/fr-CA/reference/system/touchadaptationkit/touchadaptationkit-reference.md)
- [Métadonnées d'accessibilité](/fr/publishing/game-publishing/concepts/metadata-accessibility.md)
- [Personnalisation de l'aperçu des contrôles tactiles](/fr/build/core-features/common/game-streaming/tak-editor/game-streaming-tak-editor-customize-preview.md)
- [Personnalisation de l'aperçu des commandes tactiles](/fr-CA/build/core-features/common/game-streaming/tak-editor/game-streaming-tak-editor-customize-preview.md)
- [Mode de contraste élevé](/fr-CA/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-high-contrast-mode.md)