Langage: HTML | XAML

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

Applies to Windows and Windows Phone

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 seront pas localisés et si plusieurs images de résolution ne seront 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 soit les noms de dossiers ou de fichiers pour spécifier les composants d’un ensemble donné de contextes, soit une combinaison des deux stratégies en fonction de leur flux de travail.

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.png

Un utilisateur qui préfère l’anglais (États-Unis) sur un ordinateur d’échelle 140 verra alors l’image en-us\logo.scale-140.png apparaître. Pour plus d’informations 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.

Langue (langue de l’application)

Le qualificateur de langue détermine la langue BCP-47 de la ressource. Les noms de fichiers nécessitent le qualificateur "lang" ou "language" en même temps que la balise de langue tandis 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-<Any BCP-47 language tag>

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 avec une résolution PPP 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 utilisez le qualificateur d’échelle (scale) sur une ressource, n’utilisez pas le qualificateur de taille cible (targetsize).

scale-80 (only valid for resources specified in the Windows Store app manifest)
scale-100
scale-140
scale-180

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 valide 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 Contraste élevé n°1 et Contraste élevé n°2 correspondent à la valeur "Black" du qualificateur.

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 :

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 :

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.

Exemples :

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

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 à ce qualificateur. 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").

Exemples :

config-test
config-designer

Forme alternative

Vous pouvez utiliser le qualificateur « altform » pour proposer une forme alternative pour une ressource à des fins spéciales. 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 particulières. Il n’y a aucune valeur par défaut. N’utilisez pas le préfixe "msft-" pour vos propres valeurs personnalisées.

Format :

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 composants 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 ayant 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 1 :

DXFeatureLevel-<value>

Exemple :

DXFeatureLevel-DX10

Format 2 :

DXFL-<value>

Exemple :

DXFL-DX11

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:
© 2014 Microsoft