SAP UI5 sap.ui.Device.media.RANGESETS 的使用介绍

这是一个 namespace，来自 sap.ui.core：包含预定义屏幕宽度媒体查询范围集(media query range sets)的名称和设置的枚举。

在 Chrome 开发者工具 Console 面板里能够查看到所有可能的值：

sap.ui.Device.media.RANGESETS.SAP_3STEPS

一个 3 步范围集 (S-L)。

这组的范围是：

• S：适用于小于 520 像素的屏幕。
• M：适用于大于或等于 520 像素且小于 960 像素的屏幕。
• L：适用于大于或等于 960 像素的屏幕。

要使用此范围集，必须显式初始化它 (sap.ui.Device.media.initRangeSet)。

如果此范围集已初始化，则会将 CSS 类添加到页面根（html 标记），指示当前屏幕宽度范围：sapUiMedia-3Step-NAME_OF_THE_INTERVAL.

sap.ui.Device.media.RANGESETS.SAP_4STEP

4 步范围设置 (S-XL)。

这组的范围是：

• S：适用于小于 520 像素的屏幕。
• M：适用于大于或等于 520 像素且小于 760 像素的屏幕。
• L：适用于大于或等于 760 像素且小于 960 像素的屏幕。
• XL：适用于大于或等于 960 像素的屏幕。

要使用此范围集，您必须显式初始化它 (sap.ui.Device.media.initRangeSet)。

如果此范围集已初始化，则会将 CSS 类添加到页面根（html 标记），指示当前屏幕宽度范围：sapUiMedia-4Step-NAME_OF_THE_INTERVAL。

sap.ui.Device.media.RANGESETS.SAP_STANDARD

一个 3 步范围集（Phone, Tablet, Desktop）。

这组的范围是：

• phone：适用于小于 600 像素的屏幕。
• Tablet: 适用于大于或等于 600 像素且小于 1024 像素的屏幕。
• Desktop: 适用于大于或等于 1024 像素的屏幕。

默认情况下自动初始化此范围集。不需要通过 sap.ui.Device.media.initRangeSet 进行初始化。

将一个 CSS 类添加到页面根（html 标记），指示当前屏幕宽度范围：sapUiMedia-Std-NAME_OF_THE_INTERVAL。此外，还有 5 个额外的 CSS 类可以根据屏幕宽度隐藏元素：

• sapUiHideOnPhone：如果屏幕有 600px 或更少，将被隐藏
• sapUiHideOnTablet：如果屏幕大于 600px 小于 1023px 将被隐藏
• sapUiHideOnDesktop：如果屏幕大于 1024px 将被隐藏
• sapUiVisibleOnlyOnPhone：仅当屏幕小于 600px 时才可见
• sapUiVisibleOnlyOnTablet：仅当屏幕有 600px 或更大但小于 1024px 时才可见
• sapUiVisibleOnlyOnDesktop：仅当屏幕有 1024px 或更大时才可见