Comment nommer des ressources à l’aide de qualificateurs
Langage: HTML | XAML

Comment nommer des ressources à l’aide de qualificateurs (HTML)

[ Cet article est destiné aux développeurs Windows 8.x et Windows Phone 8.x qui créent des applications Windows Runtime. Si vous développez une application pour Windows 10, voir la Documentation ]

Vous pouvez nommer des ressources à l’aide de qualificateurs. Les qualificateurs identifient le contexte dans lequel une version d’une ressource doit être utilisée.

Qualificateurs de ressources

Vous pouvez adapter les ressources de type chaîne et de fichiers pour la prise en charge de plusieurs échelles d’affichage, langues d’interface utilisateur, paramètres de contraste élevé et plus encore. Les qualificateurs de ressources sont des modificateurs de noms de fichiers et de dossiers qui identifient le contexte dans lequel une version particulière d’une ressource doit être utilisée.

La convention d’affectation de noms standard est

foldername/qualifiername-value_qualifiername-value/filename.qualifiername-value_qualifiername-value.ext

Par exemple :

Images/en-US/homeregion-USA/logo.scale-100_contrast-white.png

est chargé en faisant référence à

Images/logo.png

Remarque  Nous vous conseillons de marquer la langue par défaut dans les fichiers de ressources de type chaîne (par exemple en-US\resources.resw) et l’échelle par défaut dans les images (par exemple logo.scale-100.png), même si ces fichiers ne sont pas localisés et si plusieurs images de résolution ne sont pas fournies.
 

Les noms de dossiers tout entiers sont analysés à la recherche de qualificateurs. Les noms de dossiers sont ensuite mis en correspondance avec un ensemble de qualificateurs ou sont considérés comme faisant partie du chemin d’accès logique des fichiers. Le segment doté de points dans le fichier et placé juste avant l’extension de ce dernier est considéré comme un jeton indiquant des qualificateurs. S’il y a plusieurs qualificateurs, ces derniers sont séparés par un trait de soulignement. Les qualificateurs sont généralement spécifiés avec leur nom et leur valeur (exception faite de la langue en cas d’utilisation dans un nom de dossier).

Les développeurs d’applications peuvent au choix utiliser les noms de dossier ou de fichier pour spécifier les ressources d’un ensemble donné de contextes, soit une combinaison des deux stratégies en fonction de leur flux de travail et des besoins de l’application

La ressource appropriée est automatiquement choisie au moment de l’exécution en fonction du qualificateur de chaque ressource et du contexte actuel. Par exemple, vous pouvez fournir les composants suivants :

en-us\logo.scale-100.png
en-us\logo.scale-140.png
fr-fr\logo.scale-100.png
fr-fr\logo.scale-140.png

Un utilisateur qui préfère l’anglais (États-Unis) sur une échelle de 140 verra alors apparaître l’image en-us\logo.scale-140.png. Pour en savoir plus sur la sélection de ressources dans des scénarios de secours plus complexes, voir Contexte des ressources.

Les sections restantes de cette rubrique détaillent l’ensemble des qualificateurs et leurs valeurs possibles pour chaque dimension prise en charge par l’infrastructure de ressources.

Important  Les formats décrits ici concernent le segment de qualificateur d'un nom de fichier (ou le nom du dossier dans le cas de langues). Un ou plusieurs qualificateurs doivent tous apparaître comme un segment dans le nom de fichier complet qui vient après le nom de ressource et avant l’extension de fichier, selon ce format, qui repose principalement sur des espaces réservés : name.qualifiers.ext. Ici, les points (.) sont importants, car ils jouent le rôle de séparateur de syntaxe entre les segments. En dehors de ce cas, vous ne pouvez pas utiliser de points dans l’ensemble des formats de qualificateur.
 

Langue (application)

Le qualificateur de langue détermine la langue BCP-47 de la ressource. Les noms de fichier nécessitent le qualificateur lang ou language en même temps que la balise de langue, alors que les dossiers n’ont besoin que de la balise de langue. Pour obtenir la liste des langues, voir le registre des sous-balises de langues IANA.

Formats des noms de dossiers :

  • <Any BCP-47 language tag>
  • lang-<Any BCP-47 language tag>
  • language-<toute balise de langue BCP-47>

Formats des noms de fichiers :

  • lang-<Any BCP-47 language tag>
  • language-<Any BCP-47 language tag>

Exemples :

es-MX/resources.resw
language-de-DE/UI.resw
images/logo.lang-fr-FR.png

Le qualificateur de langue est mis en correspondance avec la liste de langues des applications. Les modifications apportées à la langue de l’application au moment de l’exécution sont propagées en tant qu’événements (voir ResourceContext.QualifierValues). Une application n’a pas besoin de définir ni de remplacer la langue.

Échelle

Le qualificateur d’échelle détermine le facteur d’échelle de la ressource. Il est généralement utilisé pour des images consultées sur un périphérique présentant une résolution plus élevée, ou lorsque vous effectuez un zoom sur l’application. L’échelle d’une ressource correspond à la valeur de Windows.Graphics.Display.DisplayProperties.ResolutionScale ou à la ressource à l’échelle la plus grande suivante. Si vous appliquez le qualificateur d’échelle à une ressource, n’utilisez pas le qualificateur targetsize.

Qualificateurs d’échelle :

  • scale-80 (valable uniquement pour les ressources spécifiées dans le manifeste de l’application)
  • scale-100
  • scale-140
  • scale-180 (Windows)
  • scale-240 (Windows Phone)

Les modifications apportées à l’échelle au moment de l’exécution sont propagées en tant qu’événements (voir ResourceContext.QualifierValues).

Contraste

Le qualificateur de contraste spécifie le thème à contraste du système. Le paramètre Standard est utilisé lorsque tous les thèmes à contraste élevé sont désactivés. Le paramètre High est valable lorsque vous utilisez l’un des modes de contraste élevé. Le paramètre Black est utilisé si vous préférez travailler avec des images dotées d’un arrière-plan noir et d’un premier plan blanc. Le paramètre White est utilisé si vous préférez travailler avec des images dotées d’un arrière-plan blanc et d’un premier plan noir. Les paramètres de thème High Contrast #1 et High Contrast #2 correspondent à la valeur du qualificateur Black.

contrast-standard
contrast-high
contrast-black
contrast-white

Région

Le qualificateur de région désigne le domicile de l’utilisateur. Il est généralement précisé lors de l’installation de Windows et est accessible à partir du Panneau de configuration. Ce qualificateur (ResourceContext.QualifierValues) est souvent remplacé si un autre fournisseur de données est connu pour le lieu géographique. La valeur peut être une balise de région BCP-47 valide quelconque, c’est-à-dire un code de région alpha-2 ISO 3166-1 quelconque à deux lettres, plus un ensemble de codes géographiques numériques ISO 3166-1 à trois chiffres pour les régions composées (voir Composition M49 United Nations Statistic Division pour les codes des régions.) Notez que les codes pour les "groupements sélectionnés économiques et d’autres groupements" ne sont pas valides.

Format de la région d’accueil (homeregion) :

homeregion-<Region Code>

Exemples :

homeregion-us
homeregion-jp
homeregion-419

Le qualificateur de région correspond à une région composée parente.

Taille cible

Le qualificateur de taille cible (targetsize) permet de spécifier des ressources avec une taille précise (exprimée en pixels). Il sert principalement à définir des icônes d’association de types de fichiers ou des icônes de protocole affichées dans l’Explorateur Windows. Ce qualificateur est habituellement employé pour des images carrées ou des icônes et précise une seule dimension d’image. Le système ou l’application qui sollicite la ressource (ResourceContext.QualifierValues) doit explicitement spécifier un qualificateur targetsize. Il n’y a aucune valeur par défaut. Si vous utilisez le qualificateur targetsize sur une ressource, n’utilisez pas le qualificateur scale.

Format du paramètre targetsize :

targetSize-<any positive integer>

Exemples :

targetsize-16
targetsize-96

Le contexte targetsize correspond à la plus importante ressource qualifiée suivante.

Sens de disposition

Utilisez le qualificateur de disposition pour spécifier des ressources qui appliquent la direction pour un ordre de lecture et un alignement de texte précis. Par exemple, une image peut nécessiter une mise en miroir pour une langue qui s’écrit et se lit de droite à gauche, comme l’arabe ou l’hébreu. La plupart des applications peuvent recourir à des mécanismes de rotation pour mettre des images en miroir au moment de l’exécution. Cependant, ce qualificateur cible des cas où une simple rotation ne convient pas. Pour plus d’informations, voir Comment ajuster la disposition pour les langues qui s’écrivent de droite à gauche et localiser les polices.

Format du sens de la disposition (layoutdir) :

  • layoutdir-LTR
  • layoutdir-RTL
  • layoutdir-TTBLTR
  • layoutdir-TTBRTL

Configuration

Utilisez le qualificateur de configuration pour spécifier des ressources applicables uniquement à un environnement de création donné, comme les ressources réservées aux tests. La plupart des développeurs d’applications n’auront pas besoin de faire appel à cet élément. La variable d’environnement MS_CONFIGURATION_ATTRIBUTE_VALUE peut être définie sur la valeur de chaîne qui a été affectée aux ressources pertinentes (par exemple, test).

Format de configuration (config) :

config-<MS_CONFIGURATION_ATTRIBUTE_VALUE>

Exemples :

config-test
config-designer

Forme alternative

Vous pouvez utiliser le qualificateur « altform » pour proposer une forme alternative d’une ressource à des fins spécifiques. Ce qualificateur est généralement utilisé par les développeurs d’applications japonais pour créer une chaîne furigana, pour laquelle la valeur msft-phonetic est réservée. Le système ou l’application doit fournir une valeur permettant d’utiliser ce qualificateur dans des situations spécifiques. Il n’y a aucune valeur par défaut. N’utilisez pas le préfixe msft- pour vos propres valeurs personnalisées.

Format de la forme alternative (altform) :

altform-<Any string between 1 and 16 chars>

Exemples :

altform-msft-phonetic
altform-myapp-special

Niveau de fonctionnalité DirectX

Le qualificateur de niveau de fonctionnalité DirectX représente le niveau de fonctionnalité DirectX des cartes graphiques qui seront utilisées pour afficher la ressource. On l’utilise généralement pour les ressources d’affichage Direct3D dans les jeux. Le niveau de fonctionnalité DirectX d’une ressource correspondra à une valeur définie de manière explicite sur un contexte de ressource par l’application. Si aucune ressource présentant exactement la même valeur de niveau de fonctionnalité DirectX n’est disponible, la ressource ayant la valeur inférieure la plus proche est utilisée.

Remarque  Le qualificateur de niveau de fonctionnalité DirectX est pris en charge à compter de Windows 8.1.
 

Il existe deux formats possibles pour le qualificateur de niveau de fonctionnalité DirectX. Les valeurs prises en charge sont DX9, DX10 et DX11.

Format du niveau de fonctionnalité DirectX (DXFeatureLevel)

  • DXFeatureLevel-<value>
  • DXFL-<value>

Exemples :

DXFeatureLevel-DX10
DXFL-DX11

Remarques

Comme indiqué précédemment, les différents formats de l’ensemble de qualificateurs peuvent être combinés s’il est nécessaire de prendre en charge plusieurs modèles de qualificateur dans le cadre d’un même scénario de ressources. Le séparateur à utiliser entre les modèles de qualificateur est le trait de soulignement (_). Par exemple, voici un chemin d’accès à un fichier de ressources qui prend en charge la configuration, la mise à l’échelle et l’orientation de la disposition et ce, de manière explicite : logo.config-test_scale-100_layoutdir-LTR.png.

Rubriques associées

Recommandations sur la mise à l’échelle d’après la densité en pixels
Prise en charge de thèmes à contraste élevé
Comment gérer la langue et la région
Comment ajuster la disposition pour les langues qui s’écrivent de droite à gauche et localiser les polices
Comment se préparer à la localisation
Comment affecter une icône personnalisée à un type de fichier
Ajout d’icônes, d’aperçus et de menus de raccourcis
Windows.ApplicationModel.Resources.Core.ResourceContext.QualifierValues
Windows.Graphics.Display.DisplayProperties.ResolutionScale
Liens externes
Balise de langue BCP-47
Registre des sous-balises de langues IANA
Composition M49 United Nations Statistic Division pour les codes des régions

 

 

Afficher:
© 2016 Microsoft