乐趣区

关于sap:sapuicoreConfiguration-的作用简析

这个类的帮忙文档链接如下,继承自: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 是小写的参数名称。
  • 布尔参数的值不辨别大小写,其中 truex 被解释为 true.

一些例子如下:

  • data-sap-ui-async: 此配置设置使模块加载器可能异步加载模块和库预加载文件。
  • bindingsyntax:此配置参数定义是应用简略绑定语法还是应用简单绑定语法。该参数仅影响定义为字符串的绑定,例如在控件的构造函数中,或者在申明性视图(如 XML 视图)中指定绑定时。
  • frameOptions:用于避免点击劫持等安全漏洞。应用 frameOptions 配置,开发人员能够定义是否容许 SAPUI5 在框架中嵌入运行,或者仅从受信赖的起源运行,或者基本不容许。

Configuration 有个办法 applySettings:一次对配置利用多项更改。

如果更改的设置蕴含本地化相干设置,如语言或日历类型,则只会触发一个 localizationChanged 事件。因为框架必须告诉所有现有组件、元素、模型等本地化更改,应用 applySettings 能够显着缩小屡次更改的开销,尤其是当它们在曾经创立 UI 之后产生时。

mSettings 能够蕴含此类的 API 中存在设置器办法 setXYZ 的任何属性 xyz。同样,格局设置 API 的值能够在名称为 formatSettings 的嵌套对象中提供。

退出移动版