跳到主要内容

resizability

空间场景的初始化属性之一，resizability 会影响空间场景创建后被用户拖拽调整大小时的约束，可以分别限制宽度和高度的最小值与最大值。

适用范围与设置方式​

项目内容
适用于所有可调整大小的空间场景。
新场景通过 initScene 设置。
起始场景通过 Web App Manifest 设置。
默认值无

类型定义​

resizability 类型
{
  minWidth?: number | string
  minHeight?: number | string
  maxWidth?: number | string
  maxHeight?: number | string
}

示例​

使用 initScene​

通过 initScene 设置新场景的 resizability
import { initScene } from "@webspatial/react-sdk";

initScene("newSceneName", defaultConfig => {
  return {
    ...defaultConfig,
    type: "volume",
    resizability: {
      minWidth: 100,
      minHeight: "100px",
      maxWidth: 200,
      maxHeight: 200,
    },
  };
});
window.open(newSceneUrl, "newSceneName");

使用 Web App Manifest​

Manifest 属性命名

在 Web App Manifest 里，建议把 minWidth 这样的驼峰属性名改成 min_width 这样的全小写下划线写法。

通过 Web App Manifest 设置起始场景的 resizability
{
  "name": "example app",
  "start_url": "/",
  "xr_main_scene": {
    "resizability": {
      "min_width": 100,
      "min_height": "100px",
      "max_width": 200,
      "max_height": 200
    }
  }
}

默认值​

无

可接受的值​

字段可接受的值
minWidth数字（默认单位是 px）或带单位后缀的字符串，比如 "100px"、"2m"。
minHeight数字（默认单位是 px）或带单位后缀的字符串，比如 "100px"、"2m"。
maxWidth数字（默认单位是 px）或带单位后缀的字符串，比如 "100px"、"2m"。
maxHeight数字（默认单位是 px）或带单位后缀的字符串，比如 "100px"、"2m"。