From c09f05ac8d68b313fefa24d4548d96dff3934817 Mon Sep 17 00:00:00 2001
From: zhanghao <774378400@qq.com>
Date: Thu, 23 Jul 2026 10:22:51 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E9=99=90=E5=88=B6=E5=B9=B3=E5=8F=B0?=
 =?UTF-8?q?=E4=B8=8D=E8=83=BD=E7=AB=96=E5=B1=8F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/App.vue                       |  60 ++++++++++--
 src/components/LandscapeGuard.vue | 153 ++++++++++++++++++++++++++++++
 src/style.scss                    |  19 ++++
 src/views/Address.vue             |   2 +
 src/views/Home.vue                |  21 ----
 5 files changed, 227 insertions(+), 28 deletions(-)
 create mode 100644 src/components/LandscapeGuard.vue

diff --git a/src/App.vue b/src/App.vue
index ad7faf7..190afe1 100644
--- a/src/App.vue
+++ b/src/App.vue
@@ -1,12 +1,58 @@
 <template>
-  <router-view />
+  <LandscapeGuard>
+    <router-view />
+  </LandscapeGuard>
 </template>
 
-<script setup>
-// 按需引入会自动导入 useRouter / useRoute
-const router = useRouter()
+<script setup lang="ts">
+import { onMounted, onUnmounted } from 'vue'
+import LandscapeGuard from '@/components/LandscapeGuard.vue'
+import autofit from 'autofit.js'
+
+const autoFitOptions = {
+  dh: 1080,
+  dw: 1920,
+  el: '#app',
+  // 软键盘也会触发 resize，改为由下方逻辑识别真正的窗口变化。
+  resize: false
+}
+
+let viewportWidth = document.documentElement.clientWidth
+
+const initAutoFit = () => {
+  autofit.init(autoFitOptions, false)
+}
+
+const resetAutoFit = () => {
+  autofit.off('#app')
+  initAutoFit()
+  viewportWidth = document.documentElement.clientWidth
+}
+
+const handleResize = () => {
+  const nextWidth = document.documentElement.clientWidth
+
+  // 软键盘通常只改变可视高度；宽度不变时保持原缩放比例。
+  if (Math.abs(nextWidth - viewportWidth) <= 2) return
+
+  resetAutoFit()
+}
+
+onMounted(() => {
+  initAutoFit()
+  window.addEventListener('resize', handleResize)
+  window.addEventListener('orientationchange', resetAutoFit)
+  document.addEventListener('fullscreenchange', resetAutoFit)
+  document.addEventListener('webkitfullscreenchange', resetAutoFit)
+})
+
+onUnmounted(() => {
+  autofit.off('#app')
+  window.removeEventListener('resize', handleResize)
+  window.removeEventListener('orientationchange', resetAutoFit)
+  document.removeEventListener('fullscreenchange', resetAutoFit)
+  document.removeEventListener('webkitfullscreenchange', resetAutoFit)
+})
 </script>
 
-<style lang="scss" scoped>
-
-</style>
\ No newline at end of file
+<style lang="scss" scoped></style>
diff --git a/src/components/LandscapeGuard.vue b/src/components/LandscapeGuard.vue
new file mode 100644
index 0000000..780e398
--- /dev/null
+++ b/src/components/LandscapeGuard.vue
@@ -0,0 +1,153 @@
+<template>
+  <div v-show="!isPortraitTablet" class="landscape-guard__content">
+    <slot />
+  </div>
+
+  <Teleport to="body">
+    <div
+      v-if="isPortraitTablet"
+      class="landscape-guard__mask"
+      role="alert"
+      aria-live="assertive"
+    >
+      <div class="landscape-guard__icon" aria-hidden="true">
+        <span class="landscape-guard__device"></span>
+        <span class="landscape-guard__arrow">↻</span>
+      </div>
+      <p>请将平板横屏使用</p>
+    </div>
+  </Teleport>
+</template>
+
+<script setup>
+import { onBeforeUnmount, onMounted, ref } from 'vue'
+
+const isPortraitTablet = ref(false)
+
+let portraitMediaQuery
+
+const isTablet = () => {
+  const userAgent = navigator.userAgent
+  const isIPad = /iPad/i.test(userAgent)
+    || (navigator.platform === 'MacIntel' && navigator.maxTouchPoints > 1)
+  const isAndroidTablet = /Android/i.test(userAgent) && !/Mobile/i.test(userAgent)
+  const shortestScreenSide = Math.min(screen.width, screen.height)
+  const isTouchTabletSize = navigator.maxTouchPoints > 1
+    && shortestScreenSide >= 600
+    && shortestScreenSide <= 1366
+
+  return isIPad || isAndroidTablet || isTouchTabletSize
+}
+
+const updateOrientation = () => {
+  const isPortrait = portraitMediaQuery?.matches ?? window.innerHeight > window.innerWidth
+  isPortraitTablet.value = isTablet() && isPortrait
+  document.documentElement.classList.toggle('is-portrait-tablet', isPortraitTablet.value)
+}
+
+const tryLockLandscape = async () => {
+  if (!isTablet() || !screen.orientation?.lock) return
+
+  try {
+    await screen.orientation.lock('landscape')
+  } catch {
+    // 普通浏览器页面通常无权锁定方向，竖屏遮罩会作为兜底。
+  }
+}
+
+onMounted(() => {
+  portraitMediaQuery = window.matchMedia('(orientation: portrait)')
+  updateOrientation()
+  tryLockLandscape()
+
+  portraitMediaQuery.addEventListener?.('change', updateOrientation)
+  window.addEventListener('resize', updateOrientation)
+  window.addEventListener('orientationchange', updateOrientation)
+  document.addEventListener('fullscreenchange', tryLockLandscape)
+})
+
+onBeforeUnmount(() => {
+  document.documentElement.classList.remove('is-portrait-tablet')
+  portraitMediaQuery?.removeEventListener?.('change', updateOrientation)
+  window.removeEventListener('resize', updateOrientation)
+  window.removeEventListener('orientationchange', updateOrientation)
+  document.removeEventListener('fullscreenchange', tryLockLandscape)
+})
+</script>
+
+<style scoped lang="scss">
+.landscape-guard__content {
+  width: 100%;
+  height: 100%;
+}
+
+.landscape-guard__mask {
+  position: fixed;
+  inset: -2px;
+  z-index: 2147483647;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  gap: 32px;
+  box-sizing: border-box;
+  width: auto;
+  height: auto;
+  min-width: calc(100vw + 4px);
+  min-height: calc(100vh + 4px);
+  min-height: calc(100dvh + 4px);
+  padding: calc(32px + env(safe-area-inset-top))
+    calc(32px + env(safe-area-inset-right))
+    calc(32px + env(safe-area-inset-bottom))
+    calc(32px + env(safe-area-inset-left));
+  overflow: hidden;
+  color: #fff;
+  background: #0b1526;
+  font-family: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  font-size: clamp(24px, 4vw, 42px);
+  font-weight: 600;
+  text-align: center;
+}
+
+.landscape-guard__icon {
+  position: relative;
+  width: 150px;
+  height: 120px;
+}
+
+.landscape-guard__device {
+  position: absolute;
+  top: 11px;
+  left: 46px;
+  box-sizing: border-box;
+  width: 58px;
+  height: 98px;
+  border: 6px solid currentColor;
+  border-radius: 10px;
+}
+
+.landscape-guard__device::after {
+  position: absolute;
+  bottom: 4px;
+  left: 50%;
+  width: 6px;
+  height: 6px;
+  border-radius: 50%;
+  background: currentColor;
+  content: '';
+  transform: translateX(-50%);
+}
+
+.landscape-guard__arrow {
+  position: absolute;
+  right: 0;
+  bottom: 0;
+  color: #58b7ff;
+  font-size: 68px;
+  line-height: 1;
+}
+
+.landscape-guard__mask p {
+  margin: 0;
+}
+</style>
diff --git a/src/style.scss b/src/style.scss
index f6812c6..f188935 100644
--- a/src/style.scss
+++ b/src/style.scss
@@ -29,6 +29,7 @@
 * {
   padding: 0;
   margin: 0;
+  box-sizing: border-box;
 }
 
 html,
@@ -37,3 +38,21 @@ body,
   width: 100%;
   height: 100%;
 }
+
+body {
+  overflow: hidden;
+}
+
+html.is-portrait-tablet,
+html.is-portrait-tablet body {
+  overflow: hidden !important;
+  background: #0b1526;
+}
+
+html.is-portrait-tablet #app {
+  visibility: hidden;
+}
+
+html.is-portrait-tablet .landscape-guard__mask {
+  visibility: visible;
+}
diff --git a/src/views/Address.vue b/src/views/Address.vue
index d5693b2..cd3f511 100644
--- a/src/views/Address.vue
+++ b/src/views/Address.vue
@@ -144,6 +144,8 @@ const testConnect = async () => {
 
         :deep(.el-input__inner) {
             height: 40px;
+            // 避免 iPad Safari 聚焦小字号输入框时自动缩放页面。
+            font-size: 16px;
         }
 
         .connect {
diff --git a/src/views/Home.vue b/src/views/Home.vue
index 4255e2c..8f90ace 100644
--- a/src/views/Home.vue
+++ b/src/views/Home.vue
@@ -36,14 +36,6 @@ import MechanicalArm from './arm/MechanicalArm.vue';
 import Camera from './camera/index.vue'
 import { useRouter } from 'vue-router';
 
-import autofit from 'autofit.js'
-autofit.init({
-    designHeight: 1080,
-    designWidth: 1920,
-    renderDom: '#app',
-    resize: true
-  })
-
 const router = useRouter()
 
 const currentTime = ref('')
@@ -83,25 +75,12 @@ const back = () => {
     router.back()
 }
 
-const resetAutoFit = () => {
-    autofit.destroy() // 销毁旧缩放
-    autofit.init({
-    designHeight: 1080,
-    designWidth: 1920,
-    renderDom: '#app',
-    resize: true
-  })
-}
-
 let clockTimer, binaryTimer;
 onMounted(() => {
     updateClock();
     clockTimer = setInterval(updateClock, 1000);
     animateBinary()
     binaryTimer = setInterval(animateBinary, 400);
-
-    document.addEventListener('fullscreenchange', resetAutoFit)
-    document.addEventListener('webkitfullscreenchange', resetAutoFit)
 })
 
 onUnmounted(() => {