资源限定与访问

说明：

屏幕密度从API Version 4 开始支持。

资源限定词

资源限定词可以由一个或多个表征应用场景或设备特征的限定词组合而成，包括屏幕密度等维度，限定词之间通过中划线（-）连接。开发者在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基准密度）

在为设备匹配对应的资源文件时，限定词目录匹配屏幕密度。在资源限定词目录均未匹配的情况下，则匹配默认资源限定文件。
如果限定词目录中包含资源限定词，则对应限定词的取值必须与当前的设备状态完全一致，该目录才能够参与设备的资源匹配。例如：资源限定文件res-hdpi.json与当前设备密度xhdpi无法匹配。

在应用开发的hml和js文件中使用$r的语法，可以对JS模块内的resources目录下的json资源进行格式化，获取相应的资源内容。

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

属性

类型

描述

(key: string) => string

获取资源限定下具体的资源内容。例如：this.$r('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>

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