資源使用

在頁面開發(fā)過程中，經(jīng)常需要用到顏色、字體、間距、圖片等資源，在不同的設(shè)備或配置中，這些資源的值可能不同。有兩種方式處理：

• [應(yīng)用資源]：借助資源文件能力，開發(fā)者在應(yīng)用中自定義資源，自行管理這些資源在不同的設(shè)備或配置中的表現(xiàn)。
• [系統(tǒng)資源]：開發(fā)者直接使用系統(tǒng)預(yù)置的資源定義（即分層參數(shù)）。
• 開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

應(yīng)用資源

資源文件介紹

應(yīng)用開發(fā)中使用的各類自定義資源文件，需要統(tǒng)一存放于應(yīng)用的resources目錄下，便于使用和維護。resources目錄包括兩大類目錄，一類為base目錄與限定詞目錄，另一類為rawfile目錄，其基礎(chǔ)目錄結(jié)構(gòu)如下所示。

resources
|---base  // 默認存在的目錄
|   |---element
|   |   |---string.json
|   |---media
|   |   |---icon.png
|---en_GB-vertical-car-mdpi // 限定詞目錄示例，需要開發(fā)者自行創(chuàng)建   
|   |---element
|   |   |---string.json
|   |---media
|   |   |---icon.png
|---rawfile  // rawfile目錄

base目錄默認存在，而限定詞目錄需要開發(fā)者自行創(chuàng)建，其名稱可以由一個或多個表征應(yīng)用場景或設(shè)備特征的限定詞組合而成。應(yīng)用使用某資源時，系統(tǒng)會根據(jù)當(dāng)前設(shè)備狀態(tài)優(yōu)先從相匹配的限定詞目錄中尋找該資源。只有當(dāng)resources目錄中沒有與設(shè)備狀態(tài)匹配的限定詞目錄，或者在限定詞目錄中找不到該資源時，才會去base目錄中查找。rawfile是原始文件目錄，它不會根據(jù)設(shè)備狀態(tài)去匹配不同的資源，故不在本文的討論范文內(nèi)。

說明：

• 了解限定詞目錄的命名規(guī)則、創(chuàng)建流程、匹配規(guī)則等，本文不展開介紹。
• 沒有設(shè)備狀態(tài)匹配的限定詞目錄，或者在限定詞目錄中找不到目標資源時，會繼續(xù)在base目錄中查找。 強烈建議對于所有應(yīng)用自定義資源都在base目錄中定義默認值 ，防止出現(xiàn)找不到資源值的異常場景。
• 類Web開發(fā)范式的資源文件路徑及資源限定詞的使用與聲明式范式不同。

base目錄與限定詞目錄下面可以創(chuàng)建資源組目錄（包括element、media等），用于存放特定類型的資源文件。

在element目錄的各個資源文件中，以“name-value”的形式定義資源，如下所示。而在media目錄中，直接以文件名作為name，故開發(fā)者將文件放入media目錄即可，無需再額外定義name。

// color.json 
{
    "color": [
        {
            "name": "color_red",
            "value": "#ffff0000"
        },
        {
            "name": "color_blue",
            "value": "#ff0000ff"
        }
    ]
}

訪問應(yīng)用資源

在工程中，通過 "$r('app.type.name')" 的形式引用應(yīng)用資源。app代表是應(yīng)用內(nèi)resources目錄中定義的資源；type 代表資源類型（或資源的存放位置），可以取 color、float、string、plural和media，name代表資源命名，由開發(fā)者添加資源時確定。

資源分類與訪問

應(yīng)用開發(fā)過程中，經(jīng)常需要用到顏色、字體、間距、圖片等資源，在不同的設(shè)備或配置中，這些資源的值可能不同。

• 應(yīng)用資源：借助資源文件能力，開發(fā)者在應(yīng)用中自定義資源，自行管理這些資源在不同的設(shè)備或配置中的表現(xiàn)。
• 系統(tǒng)資源：開發(fā)者直接使用系統(tǒng)預(yù)置的資源定義即[分層參數(shù)]，同一資源ID在設(shè)備類型、深淺色等不同配置下有不同的取值）。

資源分類

應(yīng)用開發(fā)中使用的各類資源文件，需要放入特定子目錄中存儲管理。資源目錄的示例如下所示，base目錄、限定詞目錄、rawfile目錄、resfile目錄稱為資源目錄，element、media、profile稱為資源組目錄。

說明

stage模型多工程情況下，共有的資源文件放到AppScope下的resources目錄。

資源目錄示例：

resources
|---base
|   |---element
|   |   |---string.json
|   |---media
|   |   |---icon.png
|   |---profile
|   |   |---test_profile.json
|---en_US  // 默認存在的目錄，設(shè)備語言環(huán)境是美式英文時，優(yōu)先匹配此目錄下資源
|   |---element
|   |   |---string.json
|   |---media
|   |   |---icon.png
|   |---profile
|   |   |---test_profile.json
|---zh_CN  // 默認存在的目錄，設(shè)備語言環(huán)境是簡體中文時，優(yōu)先匹配此目錄下資源
|   |---element
|   |   |---string.json
|   |---media
|   |   |---icon.png
|   |---profile
|   |   |---test_profile.json
|---en_GB-vertical-car-mdpi // 自定義限定詞目錄示例，由開發(fā)者創(chuàng)建
|   |---element
|   |   |---string.json
|   |---media
|   |   |---icon.png
|   |---profile
|   |   |---test_profile.json
|---rawfile // 其他類型文件，原始文件形式保存，不會被集成到resources.index文件中。文件名可自定義。
|---resfile // 其他類型文件，原始文件形式保存，不會被集成到resources.index文件中。文件名可自定義。

資源目錄

base目錄

base目錄是默認存在的目錄，二級子目錄element用于存放字符串、顏色、布爾值等基礎(chǔ)元素，media、profile存放媒體、動畫、布局等資源文件。
目錄中的資源文件會被編譯成二進制文件，并賦予資源文件ID。通過指定資源類型（type）和資源名稱（name）引用。

限定詞目錄

en_US和zh_CN是默認存在的兩個限定詞目錄，其余限定詞目錄需要開發(fā)者根據(jù)開發(fā)需要自行創(chuàng)建。二級子目錄element、media、profile用于存放字符串、顏色、布爾值等基礎(chǔ)元素，以及媒體、動畫、布局等資源文件。
同樣，目錄中的資源文件會被編譯成二進制文件，并賦予資源文件ID。通過指定資源類型（type）和資源名稱（name）來引用。

限定詞目錄的命名要求

限定詞目錄可以由一個或多個表征應(yīng)用場景或設(shè)備特征的限定詞組合而成，包括移動國家碼和移動網(wǎng)絡(luò)碼、語言、文字、國家或地區(qū)、橫豎屏、設(shè)備類型、顏色模式和屏幕密度等維度，限定詞之間通過下劃線（_）或者中劃線（-）連接。開發(fā)者在創(chuàng)建限定詞目錄時，需要遵守限定詞目錄的命名規(guī)則。

• 限定詞的組合順序： 移動國家碼_移動網(wǎng)絡(luò)碼-語言_文字_國家或地區(qū)-橫豎屏-設(shè)備類型-顏色模式-屏幕密度 。開發(fā)者可以根據(jù)應(yīng)用的使用場景和設(shè)備特征，選擇其中的一類或幾類限定詞組成目錄名稱。
• 限定詞的連接方式：語言、文字、國家或地區(qū)之間采用下劃線（ ）連接，移動國家碼和移動網(wǎng)絡(luò)碼之間也采用下劃線（ ）連接，除此之外的其他限定詞之間均采用中劃線（-）連接。例如： zh_Hant_CN 、 zh_CN-car-ldpi 。
• 限定詞的取值范圍：每類限定詞的取值必須符合限定詞取值要求表中的條件，如表2。否則，將無法匹配目錄中的資源文件。

表2 限定詞取值要求

rawfile目錄

支持創(chuàng)建多層子目錄，子目錄名稱可以自定義，文件夾內(nèi)可以自由放置各類資源文件。
目錄中的資源文件會被直接打包進應(yīng)用，不經(jīng)過編譯，也不會被賦予資源文件ID。通過指定文件路徑和文件名引用。

resfile目錄

支持創(chuàng)建多層子目錄，子目錄名稱可以自定義，文件夾內(nèi)可以自由放置各類資源文件。
目錄中的資源文件會被直接打包進應(yīng)用，不經(jīng)過編譯，也不會被賦予資源文件ID。應(yīng)用安裝后，resfile資源會被解壓到應(yīng)用沙箱路徑，通過Context屬性[resourceDir]獲取到resfile資源目錄后，可通過文件路徑訪問。

資源組目錄

資源組目錄包括element、media、profile三種類型的資源文件，用于存放特定類型資源。

表3 資源組目錄說明

媒體資源類型說明

表4 圖片資源類型說明

表5 音視頻資源類型說明

資源文件示例

color.json文件的內(nèi)容如下：

{
    "color": [
        {
            "name": "color_hello",
            "value": "#ffff0000"
        },
        {
            "name": "color_world",
            "value": "#ff0000ff"
        }
    ]
}

float.json文件的內(nèi)容如下：

{
    "float":[
        {
            "name":"font_hello",
            "value":"28.0fp"
        },
	{
            "name":"font_world",
            "value":"20.0fp"
        }
    ]
}

string.json文件的內(nèi)容如下：

{
    "string":[
        {
            "name":"string_hello",
            "value":"Hello"
        },
	{
            "name":"string_world",
            "value":"World"
        },
	{
            "name":"message_arrive",
            "value":"We will arrive at %1$s."
        },
  {
            "name":"message_notification",
            "value":"Hello, %1$s!,You have %2$d new messages."
  }
    ]
}

plural.json文件的內(nèi)容如下：

{
    "plural":[
        {
            "name":"eat_apple",
            "value":[
                {
                    "quantity":"one",
                    "value":"%d apple"
                },
                {
                    "quantity":"other",
                    "value":"%d apples"
                }
            ]
        }
    ]
}

創(chuàng)建資源目錄和資源文件

在resources目錄下，可按照限定詞目錄命名規(guī)則，以及資源組目錄支持的文件類型和說明，創(chuàng)建資源目錄和資源組目錄，添加特定類型資源。DevEco Studio支持同時創(chuàng)建資源目錄和資源文件，也支持單獨創(chuàng)建資源目錄或資源文件。

創(chuàng)建資源目錄和資源文件

在resources目錄右鍵菜單選擇“New > Resource File”，可同時創(chuàng)建資源目錄和資源文件，文件默認創(chuàng)建在base目錄的對應(yīng)資源組。如果選擇了限定詞，則會按照命名規(guī)范自動生成限定詞和資源組目錄，并將文件創(chuàng)建在限定詞目錄中。

圖中File name為需要創(chuàng)建的文件名。Resource type為資源組類型，默認是element。Root Element為資源類型。Avaliable qualifiers為供選擇的限定詞目錄，通過右邊的小箭頭可添加或者刪除。
創(chuàng)建的目錄名自動生成，格式固定為“限定詞.資源組”，例如：創(chuàng)建一個限定詞為dark的element目錄，自動生成的目錄名稱為“dark.element”。

創(chuàng)建資源目錄

在resources目錄右鍵菜單選擇“New > Resource Directory”，可創(chuàng)建資源目錄，默認創(chuàng)建的是base目錄。如果選擇了限定詞，則會按照命名規(guī)范自動生成限定詞和資源組目錄。確定限定詞后，選擇資源組類型，當(dāng)前資源組類型支持Element、Media、Profile三種，創(chuàng)建后生成資源目錄。

創(chuàng)建資源文件

在資源目錄（element、media、profile）的右鍵菜單選擇“New > XXX Resource File”，即可創(chuàng)建對應(yīng)資源組目錄的資源文件。例如，在element目錄下可新建Element Resource File。

資源可翻譯特性

功能介紹

資源需要翻譯時，可使用attr屬性標記字符串翻譯范圍和翻譯狀態(tài)。attr屬性不參與資源編譯，只標記字符串是否翻譯。

未配置attr屬性，默認需要翻譯。

"attr": {
  "translatable": false|true
  "priority": "code|translate|LT|customer"
}

attr支持屬性

使用約束

可翻譯特性使能范圍：base目錄下string、strarray、plural類型資源。

resources
|---base
|   |---element
|   |   |---string.json
|   |   |---strarray.json
|   |   |---plural.json

示例

string資源配置attr屬性示例如下：

{
  "string": [
    {
      "name": "string1",
      "value": "1",
      "attr": {
        "translatable": false
      }
    },
    {
      "name": "string2",
      "value": "Hello world!",
      "attr": {
        "translatable": true,
        "priority": "LT"
      }
    }
  ]
}

資源訪問

單HAP包應(yīng)用資源

• 通過"$r"或"$rawfile"引用資源。
  對于“color”、“float”、“string”、“plural”、“media”、“profile”等類型的資源，通過"$r('app.type.name')"形式引用。其中，app為resources目錄中定義的資源；type為資源類型或資源的存放位置；name為資源名，開發(fā)者定義資源時確定。
  對于string.json中使用多個占位符的情況，通過$r('app.string.label','aaa','bbb',444)形式引用。
  對于rawfile目錄資源，通過"$rawfile('filename')"形式引用。其中，filename為rawfile目錄下文件的相對路徑，文件名需要包含后綴，路徑開頭不可以"/"開頭。

[資源組目錄]下的“資源文件示例”顯示了.json文件內(nèi)容，包含color.json文件、string.json文件和plural.json文件，訪問應(yīng)用資源時需先了解.json文件的使用規(guī)范。
資源的具體使用方法如下：

Text('Hello')
  .fontColor($r('sys.color.ohos_id_color_emphasize'))
  .fontSize($r('sys.float.ohos_id_text_size_headline1'))
  .fontFamily($r('sys.string.ohos_id_text_font_family_medium'))
  .backgroundColor($r('sys.color.ohos_id_color_palette_aux1'))

  Image($r('sys.media.ohos_app_icon'))
  .border({
    color: $r('sys.color.ohos_id_color_palette_aux1'),
    radius: $r('sys.float.ohos_id_corner_radius_button'), width: 2
  })
  .margin({
    top: $r('sys.float.ohos_id_elements_margin_horizontal_m'),
    bottom: $r('sys.float.ohos_id_elements_margin_horizontal_l')
  })
  .height(200)
  .width(300)

• 通過本應(yīng)用上下文獲取ResourceManager后，調(diào)用不同[資源管理接口]訪問不同資源。
  例如：getContext.resourceManager.getStringByNameSync('app.string.XXX') 可獲取字符串資源；getContext.resourceManager.getRawFd('rawfilepath') 可獲取Rawfile所在hap包的descriptor信息，訪問rawfile文件時需{fd, offset, length}一起使用。

跨HAP/HSP包應(yīng)用資源

bundle不同，跨bundle訪問（僅支持系統(tǒng)應(yīng)用使用）

• 通過createModuleContext(bundleName, moduleName)接口創(chuàng)建對應(yīng)HAP/HSP包的上下文，獲取resourceManager對象后，調(diào)用不同[資源管理接口]訪問不同資源。
  例如：getContext.createModuleContext(bundleName， moduleName).resourceManager.getStringByNameSync('app.string.XXX')。

bundle相同，跨module訪問

• 通過createModuleContext(moduleName)接口創(chuàng)建同應(yīng)用中不同module的上下文，獲取resourceManager對象后，調(diào)用不同接口訪問不同資源。
  例如：getContext.createModuleContext(moduleName).resourceManager.getStringByNameSync('app.string.XXX')。

• 通過"$r"或"$rawfile"引用資源。具體操作如下：
  1.這里是列表文本[hsp].type.name獲取資源。其中，hsp為hsp模塊名，type為資源類型，name為資源名稱，示例如下：

  Text($r('[hsp].string.test_string'))
      .fontSize($r('[hsp].float.font_size'))
      .fontColor($r('[hsp].color.font_color'))  
    Image($rawfile('[hsp].icon.png'))
  

  2.使用變量獲取資源。示例如下：

  @Entry
   @Component
   struct Index {
     text: string = '[hsp].string.test_string';
     fontSize: string = '[hsp].float.font_size';
     fontColor: string = '[hsp].color.font_color';
     image: string = '[hsp].media.string';
     rawfile: string = '[hsp].icon.png';
  
     build() {
       Row() {
         Text($r(this.text))
           .fontSize($r(this.fontSize))
           .fontColor($r(this.fontColor))
  
         Image($r(this.image))
  
         Image($rawfile(this.rawfile))
       }
     }
   }
  

  說明

  hsp包名必須寫在[]內(nèi)，rawfile下有多層目錄，需要從rawfile下面第一個目錄開始寫，如"$rawfile('[hsp].oneFile/twoFile/icon.png')"，使用"$r"和"$rawfile"跨包訪問HSP包資源無法提供編譯時的資源校驗，需要開發(fā)者自行保證使用資源存在于對應(yīng)包中。

系統(tǒng)資源

除了自定義資源，開發(fā)者也可以使用系統(tǒng)中預(yù)定義的資源，統(tǒng)一應(yīng)用的視覺風(fēng)格。可以查看[應(yīng)用UX設(shè)計中關(guān)于資源的介紹]，獲取支持的系統(tǒng)資源ID及其在不同配置下的取值。

在開發(fā)過程中，分層參數(shù)的用法與資源限定詞基本一致。對于系統(tǒng)資源，可以通過“$r('sys.type.resource_id')”的形式引用。其中，sys為系統(tǒng)資源；type為資源類型，取值包括“color”、“float”、“string”、“media”；resource_id為資源id。

說明：

• 僅聲明式開發(fā)范式支持使用系統(tǒng)資源。
• 對于系統(tǒng)預(yù)置應(yīng)用，建議使用系統(tǒng)資源；對于三方應(yīng)用，可以根據(jù)需要選擇使用系統(tǒng)資源或自定義應(yīng)用資源。
• 界面加載的系統(tǒng)資源字體進行顯示時，可以在配置中system/etc/fontconfig.json文件查看。默認字體為HarmonyOS Sans。

Text('Hello')
  .fontColor($r('sys.color.ohos_id_color_emphasize'))
  .fontSize($r('sys.float.ohos_id_text_size_headline1'))
  .fontFamily($r('sys.string.ohos_id_text_font_family_medium'))
  .backgroundColor($r('sys.color.ohos_id_color_palette_aux1'))

Image($r('sys.media.ohos_app_icon'))
  .border({
    color: $r('sys.color.ohos_id_color_palette_aux1'),
    radius: $r('sys.float.ohos_id_corner_radius_button'), width: 2
  })
  .margin({
    top: $r('sys.float.ohos_id_elements_margin_horizontal_m'),
    bottom: $r('sys.float.ohos_id_elements_margin_horizontal_l')
  })
  .height(200)
  .width(300)

資源匹配

應(yīng)用使用某資源時，系統(tǒng)會根據(jù)當(dāng)前設(shè)備狀態(tài)優(yōu)先從相匹配的限定詞目錄中尋找該資源。只有當(dāng)resources目錄中沒有與設(shè)備狀態(tài)匹配的限定詞目錄，或者在限定詞目錄中找不到該資源時，才會去base目錄中查找。rawfile是原始文件目錄，不會根據(jù)設(shè)備狀態(tài)去匹配不同的資源。

限定詞目錄與設(shè)備狀態(tài)的匹配規(guī)則

• 在為設(shè)備匹配對應(yīng)的資源文件時，限定詞目錄匹配的優(yōu)先級從高到低依次為：移動國家碼和移動網(wǎng)絡(luò)碼 > 區(qū)域（可選組合：語言、語言_文字、語言_國家或地區(qū)、語言_文字_國家或地區(qū)）> 橫豎屏 > 設(shè)備類型 > 顏色模式 > 屏幕密度。
• 如果限定詞目錄中包含移動國家碼和移動網(wǎng)絡(luò)碼、語言、文字、橫豎屏、設(shè)備類型、顏色模式限定詞，則對應(yīng)限定詞的取值必須與當(dāng)前的設(shè)備狀態(tài)完全一致，該目錄才能夠參與設(shè)備的資源匹配。例如，限定詞目錄“zh_CN-car-ldpi”不能參與“en_US”設(shè)備的資源匹配。

應(yīng)用界面加載資源規(guī)則，更多請參考國際化和本地化文檔。

overlay機制

overylay是一種資源替換機制，針對不同品牌、產(chǎn)品的顯示風(fēng)格，開發(fā)者可以在不重新打包業(yè)務(wù)邏輯hap的情況下，通過配置和使用overlay資源包，實現(xiàn)應(yīng)用界面風(fēng)格變換。overlay資源包只包含資源文件、資源索引文件和配置文件。

• 動態(tài)overlay使用方式

1、對應(yīng)的overlay資源包需要放在對應(yīng)應(yīng)用安裝路徑下，通過hdc install的方式安裝。如應(yīng)用com.example.overlay的安裝路徑：data/app/el1/bundle/public/com.example.overlay/。

2、應(yīng)用通過[addResource(path)]，實現(xiàn)資源覆蓋；通過[removeResource(path)]，實現(xiàn)overlay刪除。overlay資源路徑需經(jīng)過元能力的getContext().BundleCodeDir獲取此應(yīng)用對應(yīng)的沙箱根目錄，由應(yīng)用的沙箱根目錄+overlay資源包名稱組成。如：let path = getContext().bundleCodeDir + "overlay資源包名稱"，其對應(yīng)沙箱路徑為：/data/storage/el1/bundle/overlay資源包名稱。

• 靜態(tài)overlay配置方式

包內(nèi)overlay資源包中的配置文件module.json5中支持的字段：

"app":{
    "bundleName": "com.example.myapplication.overlay",
    "vendor" : "example",
    "versinCode": "1000000",
    "versionName": "1.0.0.1",
    "icon": "$media:app_icon",
    "label": "$string:app_name",
  },
  "module":{
    "name": "entry_overlay_module_name",
    "type": "shared",
    "description": "$string:entry_overlay_desc",
    "deviceTypes": [
      "default",
      "tablet",
    ],
    "deliverywithInstall": true,

    "targetModuleName": "entry_module_name",
    "targetPriority": 1,
  }
}

包間overlay資源包中的配置文件module.json5中支持的字段，僅對系統(tǒng)應(yīng)用開放：

"app":{
    "bundleName": "com.example.myapplication.overlay",
    "vendor" : "example",
    "versinCode": "1000000",
    "versionName": "1.0.0.1",
    "icon": "$media:app_icon",
    "label": "$string:app_name",
    "targetBundleName": "com.example.myapplication",
    "targetPariority": 1,
  },
  "module":{
    "name": "entry_overlay_module_name",
    "type": "shared",
    "description": "$string:entry_overlay_desc",
    "deviceTypes": [
      "default",
      "tablet",
    ],
    "deliverywithInstall": true,

    "targetModuleName": "entry_module_name",
    "targetPriority": 1,
  }
}

說明：

• targetBundleName: 字符串類型，指定要overlay的bundleName
• targetModuleName: 字符串類型，指定要overlay的應(yīng)用中的目標module
• targetPriority： 整數(shù)類型，指定overlay優(yōu)先級
• 不支持Ability、ExtensionAbility、Permission等其他字段的配置
• overlay不支持json類型的圖片配置。

在IDE中創(chuàng)建應(yīng)用工程時，module的配置文件module.json5中包含targetModuleName和targetPriority字段時，該module將會在安裝階段被識別為overlay特征的module。overlay特征的module一般是為設(shè)備上存在的非overlay特征的module提供覆蓋的資源文件，以便于targetModuleName指向的module在運行階段可以使用overlay資源文件展示不同的顏色，標簽，主題等等。

示例

在應(yīng)用的resources目錄下，創(chuàng)建名為tablet的限定詞子目錄，并按照下表所示，在base目錄和tablet限定詞目錄中添加相應(yīng)的資源。

在代碼中通過 "$r('app.type.name')" 的形式使用應(yīng)用資源，并分別在默認設(shè)備和平板上查看代碼的運行效果，可以發(fā)現(xiàn)同一資源在不同設(shè)備上的取值不同。

@Entry
@Component
struct Index {
  build() {
    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
      Text($r("app.string.my_string"))
        .fontSize($r("app.float.my_float"))
        .fontColor($r("app.color.my_color"))
      Image($r("app.media.my_image"))
        .width(100)
        .height(100)
    }
    .width('100%')
    .height('100%')
  }
}

`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`

系統(tǒng)資源

除了自定義資源，開發(fā)者也可以使用系統(tǒng)中預(yù)定義的資源（即[分層參數(shù)]，同一資源ID在設(shè)備類型、深淺色等不同配置下有不同的取值）。

在開發(fā)過程中，分層參數(shù)的用法與資源限定詞基本一致。開發(fā)者可以通過"$r('sys.type.resource_id')"的形式引用系統(tǒng)資源。sys代表是系統(tǒng)資源；type代表資源類型，值可以取color、float、string和media；resource_id代表資源id。

說明：

• 僅聲明式開發(fā)范式支持使用分層參數(shù)，類Web開發(fā)范式不支持。
• 系統(tǒng)資源可以保證不同團隊開發(fā)出的應(yīng)用有較為一致的視覺風(fēng)格。對于系統(tǒng)預(yù)置應(yīng)用，強烈建議使用系統(tǒng)資源；對于三方應(yīng)用，可以根據(jù)需要選擇使用系統(tǒng)資源或自定義應(yīng)用資源。
• 可以查看[resources代碼倉]了解系統(tǒng)預(yù)置資源的實現(xiàn)，這里的目錄結(jié)構(gòu)與工程中的resources目錄類似，也是通過資源限定詞匹配不同的設(shè)備或設(shè)備狀態(tài)。

審核編輯 黃宇