@microbt/environment 1.2.6 → 1.2.7

package/README.md

@@ -160,6 +160,37 @@ console.log(versionInfo);
 // 在非 SuperAcme 应用中输出：{ version: "unknown" }
 ```
 
+### `getStatusBarHeight()`
+
+获取 SuperAcme 应用的状态栏高度信息。
+
+**返回值**: 返回一个包含状态栏高度信息的对象：
+
+```json
+{
+  top: number;    // 顶部状态栏高度，单位为像素
+  bottom: number; // 底部状态栏高度，单位为像素
+}
+```
+
+如果不在 SuperAcme 应用中或无法解析高度信息，将返回默认值：
+
+```json
+{
+  "top": 0,
+  "bottom": 0
+}
+```
+
+**示例** :
+
+```typescript
+const statusBarHeight = getStatusBarHeight();
+console.log(statusBarHeight);
+// 可能输出：{ top: 20, bottom: 0 }
+// 在非 SuperAcme 应用中输出：{ top: 0, bottom: 0 }
+```
+
 ## 平台相关函数
 
 ### `iOSWebview`

package/dist/esm/hybrid.d.ts

@@ -9,3 +9,7 @@ export declare function superAcmeVersion(): {
     minor: number;
     patch: number;
 };
+export declare function getStatusBarHeight(): {
+    top: number;
+    bottom: number;
+};

package/dist/esm/hybrid.js

@@ -75,6 +75,8 @@ function inSuperAcme() {
   return navigator.userAgent.toLowerCase().includes("superacme");
 }
 var VERSION_REGEX = /AppVersion\s([\d.]+)/;
+var STATUSBAR_TOP_REGEX = /statusBarTop:([\d.]+)/;
+var STATUSBAR_BOTTOM_REGEX = /statusBarBottom:([\d.]+)/;
 function superAcmeVersion() {
   const ua = navigator.userAgent;
   const UNKNOWN = {
@@ -96,9 +98,26 @@ function superAcmeVersion() {
   }
   return UNKNOWN;
 }
+function getStatusBarHeight() {
+  const ua = navigator.userAgent;
+  const DEFAULT_HEIGHT = {
+    top: 0,
+    bottom: 0
+  };
+  if (!inSuperAcme()) {
+    return DEFAULT_HEIGHT;
+  }
+  const topMatch = ua.match(STATUSBAR_TOP_REGEX);
+  const bottomMatch = ua.match(STATUSBAR_BOTTOM_REGEX);
+  return {
+    top: topMatch ? parseFloat(topMatch[1]) : DEFAULT_HEIGHT.top,
+    bottom: bottomMatch ? parseFloat(bottomMatch[1]) : DEFAULT_HEIGHT.bottom
+  };
+}
 export {
   bridgeBootstrap,
   bridgeCall,
+  getStatusBarHeight,
   inSuperAcme,
   superAcmeVersion
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microbt/environment",
-  "version": "1.2.6",
+  "version": "1.2.7",
   "description": "microbt app library for environment",
   "keywords": [],
   "license": "MIT",