Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

docs(editor): device dropdown relayouts UI to the device aspect

esengined1b0f01dac2a
diff --git a/docs/astro/src/content/docs/guides/editor.mdx b/docs/astro/src/content/docs/guides/editor.mdx
index 0859cb12e..87ad28039 100644
--- a/docs/astro/src/content/docs/guides/editor.mdx
+++ b/docs/astro/src/content/docs/guides/editor.mdx
@@ -114,9 +114,10 @@ frame's corners, and a portrait resolution lays out as a portrait screen.
- **Design** dropdown (viewport toolbar) — picks the Canvas design resolution and reframes
to it (undoable; the authoritative value also lives on the Canvas in the Details panel).
This is the size your UI lays out against.
-- **Device** dropdown — *simulates* a target screen (iPhone / iPad / 1080p …) with letterbox
- bars and safe-area insets, to preview how the UI adapts. It's a preview only — it does
- **not** change your design resolution.
+- **Device** dropdown — *simulates* a target screen (iPhone / iPad / 1080p …): the UI
+ **relayouts to that device's aspect** (per the Canvas scale mode) inside letterbox bars and
+ safe-area insets, so you preview how it actually adapts. A preview only — it does **not**
+ change your design resolution.
## Building a scene
diff --git a/docs/astro/src/content/docs/zh-cn/guides/editor.mdx b/docs/astro/src/content/docs/zh-cn/guides/editor.mdx
index 0866a2d70..ff705adb1 100644
--- a/docs/astro/src/content/docs/zh-cn/guides/editor.mdx
+++ b/docs/astro/src/content/docs/zh-cn/guides/editor.mdx
@@ -100,8 +100,9 @@ Estella 编辑器是一个桌面应用(Electron + React),带 UE5 风格的**可
- **Design** 下拉(视口工具栏)——选择 Canvas 设计分辨率并成帧到它(可撤销;权威值同时在 Details
面板的 Canvas 上)。这就是你的 UI 布局所对的尺寸。
-- **Device** 下拉——*模拟*一个目标屏幕(iPhone / iPad / 1080p …),带 letterbox 黑边和安全区内缩,
- 预览 UI 如何适配。它只是预览,**不会**改动你的设计分辨率。
+- **Device** 下拉——*模拟*一个目标屏幕(iPhone / iPad / 1080p …):UI 会**按该设备的宽高比重新
+ 布局**(依 Canvas 缩放模式),配 letterbox 黑边和安全区内缩,预览它真实的适配效果。只是预览,
+ **不会**改动你的设计分辨率。
## 搭建场景