资源限定词可以由一个或多个表示应用场景或设备特征的限定词组合而成，包括屏幕密度等维度，限定词之间通过中划线（-）连接。开发者在resources目录下创建限定词文件时，需要掌握限定词文件的命名要求以及与限定词文件与设备状态的匹配规则。

表1 资源限定词

类型	含义与取值说明
屏幕密度	表示设备的屏幕密度（单位为dpi），取值如下： - ldpi：表示低密度屏幕（~120dpi）（0.75基准密度） - mdpi：表示中密度屏幕（~160dpi）（基准密度） - hdpi：表示高密度屏幕（~240dpi）（1.5基准密度） - xhdpi：表示加高密度屏幕（~320dpi）（2.0基准密度） - xxhdpi：表示超超高密度屏幕（~480dpi）（3.0基准密度） - xxxhdpi：表示超超超高密度屏幕（~640dpi）（4.0基准密度）

在为设备匹配对应的资源文件时，限定词目录匹配的优先级从高到低依次为：MCC和MNC> 横竖屏 > 深色模式 > 设备类型 > 屏幕密度。在资源限定词目录均未匹配的情况下，则匹配默认资源限定文件。
如果限定词目录中包含资源限定词，则对应限定词的取值必须与当前的设备状态完全一致，该目录才能够参与设备的资源匹配。例如：资源限定文件res-hdpi.json与当前设备密度xhdpi无法匹配。

在应用开发的hml和js文件中使用$r的语法，可以对JS模块内的resources目录下的json资源进行格式化，获取相应的资源内容，该目录与pages目录同级，具体目录结构请参考文件组织。

属性	类型	描述
$r	(key: string) => string	获取资源限定下具体的资源内容。例如：$r('strings.hello')。参数说明： - key：定义在资源限定文件中的键值，如strings.hello。

属性

类型

描述

(key: string) => string

获取资源限定下具体的资源内容。例如：$r('strings.hello')。

参数说明：

- key：定义在资源限定文件中的键值，如strings.hello。

res-defaults.json示例：

{
    "strings": {
        "hello": "hello world"
    }
}

resources/res-dark.json:

{
    "image": {
        "clockFace": "common/dark_face.png"
    },
    "colors": {
    "background": "#000000"
    }
}

resources/res-defaults.json:

{
    "image": {
        "clockFace": "common/face.png"
    },
    "colors": {
    "background": "#ffffff"
    }
}

<!-- xxx.hml -->
<div style="background-color: {{ $r('colors.background') }}">
    <image src="{{ $r('image.clockFace') }}"></image>
</div>

资源限定文件中不支持颜色枚举格式。

资源限定与访问