- sap.ui.Device.media.attachHandler:注册给定的事件处理程序以依据应用指定名称设置的范畴更改屏幕宽度的事件。
每当屏幕宽度发生变化并且以后屏幕宽度处于与宽度变动之前不同的给定范畴集的距离时,就会触发该事件。
应用单个参数调用事件处理程序:一个映射 mParams,它提供无关输出距离的以下信息:
- mParams.from:作为数字输出的区间的起始值(包含)
- mParams.to:输出区间的完结值(不包含)范畴为数字或未定义的最初一个区间(无穷大)
- mParams.unit:用于上述值的单位,例如“像素”
- mParams.name:输出距离的名称(如果可用)
这个办法的实现地位,位于 Device.js
内:
sap.ui.Device.media.getCurrentRange
返回无关具备给定名称的范畴集的以后流动范畴的信息。
如果给定了可选参数 iWidth,则将为该宽度确定流动范畴,否则为以后窗口大小确定。
sap.ui.Device.media.initRangeSet
初始化屏幕宽度媒体查问范畴集。
此初始化步骤使范畴集筹备好用于命名空间 sap.ui.Device.media 中的其余函数之一。最重要的预约义范畴集会主动初始化。
要使尚未初始化的预约义范畴集可供使用,请应用要初始化的范畴集的名称调用此函数:
sap.ui.Device.media.initRangeSet(sap.ui.Device.media.RANGESETS.SAP_3STEPS);
或者,能够定义自定义范畴集,如下例所示:
sap.ui.Device.media.initRangeSet("MyRangeSet", [200, 400], "px", ["Small", "Medium", "Large"]);
此示例定义了以下命名范畴:
- Small:实用于小于 200 像素的屏幕。
- Medium:实用于大于或等于 200 像素且小于 400 像素的屏幕。
- Large:实用于大于或等于 400 像素的屏幕。
范畴名称是可选的。如果指定了 CSS 类(例如 sapUiMedia-MyRangeSet-Small),则还会依据以后流动范畴将其增加到文档根目录。这能够通过参数 bSuppressClasses 克制。