---
title: "window.resized"
description: "窗口尺寸变化时推送当前宽高。"
---


> 窗口尺寸变化时推送当前宽高。

## 签名

```ts
KSM.events.on<{ width: number; height: number }>(
  'window.resized',
  (payload) => void
): () => void
```

## 平台与权限

| Windows | Android |权限 |
| --- | --- | --- |
|支持 |支持 |无 |

## 载荷

|字段 |类型 |说明 |
| --- | --- | --- |
| `width` | `number` |当前窗口宽度 |
| `height` | `number` |当前窗口高度 |

两个字段都是有限数值，单位由宿主窗口系统提供。

## 订阅行为

普通事件，需要 `event.subscribe`。推荐使用 `KSM.events.on()`，它会自动完成第一个
监听器订阅和最后一个监听器退订。也可以显式调用
[subscribe](/docs/kasumi/api/events/subscribe)。

## 示例

```ts
const off = KSM.events.on<{ width: number; height: number }>(
  'window.resized',
  ({ width, height }) => {
    document.documentElement.style.setProperty(
      '--window-width',
      `${width}px`
    );
  }
);

off();
```

## 错误

|错误 |场景 |
| --- | --- |
|普通 `TypeError` |事件名未注册 |
|普通 `Error` |桥接未初始化 |
|异步订阅错误 |监听器被回滚移除 |

## 相关

- [on](/docs/kasumi/api/events/on)
- [window](/docs/kasumi/api/window)