sap.ui.core.Configuration 的作用簡析

這個類的幫助文檔鏈接如下,繼承自: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 的嵌套對象中提供。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章