这个类的帮助文档链接如下,继承自:sap.ui.base.Object
这个类用于收集并存储 SAP UI5 应用当前环境的配置。
Configuration 在创建 sap.ui.core.Core 时初始化一次。 有不同的方式来设置环境配置,罗列如下,按优先级升序排列
:
- 系统定义的默认值
- 服务器范围的默认值,从
/sap-ui-config.json
读取 - 全局配置对象 window["sap-ui-config"] 的属性
- bootstrap 标记的 data-sap-ui-config 属性中的配置字符串。
- bootstrap 标签的各个 data-sap-ui-xyz 属性
- 使用 url parameter
- 此 Configuration 对象中的 Setter(仅针对某些参数)
也就是说,DOM 引用的属性覆盖系统默认值,URL 参数覆盖 DOM 属性(其中空 URL 参数将参数设置回其系统默认值)。 在运行时调用 setter 将覆盖在对象创建期间计算的任何先前设置。
参数的命名约定是:
- 在 URL 中:sap-ui-PARAMETER-NAME="value"
- 在 DOM 中:data-sap-ui-PARAMETER-NAME="value"
- 其中 PARAMETER-NAME 是小写的参数名称。
- 布尔参数的值不区分大小写,其中
true
和x
被解释为 true.
一些例子如下:
-
data-sap-ui-async: 此配置设置使模块加载器能够异步加载模块和库预加载文件。
-
bindingsyntax:此配置参数定义是使用简单绑定语法还是使用复杂绑定语法。 该参数仅影响定义为字符串的绑定,例如在控件的构造函数中,或者在声明性视图(如 XML 视图)中指定绑定时。
-
frameOptions:用于防止点击劫持等安全漏洞。 使用 frameOptions 配置,开发人员可以定义是否允许 SAPUI5 在框架中嵌入运行,或者仅从受信任的来源运行,或者根本不允许。
Configuration 有个方法 applySettings
:一次对配置应用多项更改。
如果更改的设置包含本地化相关设置,如语言或日历类型,则只会触发一个 localizationChanged 事件。 由于框架必须通知所有现有组件、元素、模型等本地化更改,使用 applySettings 可以显着减少多次更改的开销,尤其是当它们在已经创建 UI 之后发生时。
mSettings 可以包含此类的 API 中存在设置器方法 setXYZ 的任何属性 xyz。 同样,格式设置 API 的值可以在名称为 formatSettings 的嵌套对象中提供。