这个类的帮忙文档链接如下,继承自: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 的嵌套对象中提供。