Skip to main content

<svelte:window>

<svelte:window onevent={handler} />
<svelte:window bind:prop={value} />

<svelte:window> 元素允许您向 window 对象添加事件监听器,而无需担心在组件销毁时移除它们,或在服务端渲染时检查 window 是否存在。

此元素只能出现在组件的顶层 — 它不能在块或元素内部。

<script>
	function handleKeydown(event) {
		alert(`按下了 ${event.key} 键`);
	}
</script>

<svelte:window onkeydown={handleKeydown} />

你还可以绑定以下属性:

  • innerWidth
  • innerHeight
  • outerWidth
  • outerHeight
  • scrollX
  • scrollY
  • onlinewindow.navigator.onLine 的别名
  • devicePixelRatio

除了 scrollXscrollY 外,其他都是只读的。

<svelte:window bind:scrollY={y} />

注意,页面不会滚动到初始值以避免可访问性问题。只有对 scrollXscrollY 绑定变量的后续更改才会导致滚动。如果你有正当理由在组件渲染时滚动,请在 $effect 中调用 scrollTo()

在 GitHub 编辑此页面