教程 框架 组件 接口 其他

应用配置 configuration 1060+

接口声明

无需声明

导入模块

import configuration from '@system.configuration'const configuration = require('@system.configuration')

接口定义

configuration.getLocale()

获取应用当前的语言环境。默认使用系统的语言环境,会因为设置或系统语言环境改变而发生变化

参数:

返回值:

参数名类型说明
languageString语言
countryOrRegionString国家或地区

示例:

const locale = configuration.getLocale()
console.log(locale.language)

configuration.setLocale(OBJECT)

设置应用的语言环境。设置完成后,应用会按照新的语言环境来更新页面,并回调 onConfigurationChanged1060+生命周期函数。当系统语言发生变化或应用重新进入时,当前语言环境会重置为系统语言;Web 组件与 Fetch 接口在请求 Header 中会携带对应的 Accept-Language

参数:

类型必填说明
Object要设置的 Locale 对象

示例:

configuration.setLocale({
  language: 'zh',
  countryOrRegion: 'CN'
})

configuration.getThemeMode() 1070+

获取应用当前的主题模式。

参数:

返回值:

返回当前主题模式值,类型为 Number,返回值是以下列表的其中一个:

参数值说明
0日间模式
1夜间模式

PS:获取主题模式值会有两种情况:

1.如果manifest.jsondisplay属性下的themeMode值为-1(跟随系统主题模式),则此时快应用主题模式会跟随系统。

此时返回值也跟随系统主题模式,返回0(日间模式)1(夜间模式)

2.如果manifest.jsondisplay属性下的themeMode值为0(日间模式)1(夜间模式)或没有设置(此时主题模式为默认值0(日间模式)),则此时快应用主题模式会设置为固定模式,不跟随系统主题模式

此时返回值会与manifest.jsondisplay属性下的themeMode值保持一致(没有设置themeMode值则返回 0 )。

示例:

const themeMode = configuration.getThemeMode()
console.log(`Theme mode is ${themeMode} now~`)

后台运行限制

无限制。 后台运行详细用法参见后台运行 脚本

条匹配 "" 的结果

    没有搜索到与 "" 相关的内容