refactor: optimize useAvailableHeight to improve resize event handling and performance

This commit is contained in:
jxxghp
2026-04-08 13:23:29 +08:00
parent b02a4f1347
commit 2d50bd7536

View File

@@ -4,12 +4,10 @@ import { usePWA } from '@/composables/usePWA'
/**
* 计算页面内容的可用高度,自动适配 iOS 安全区域和底部 Dock 栏。
*
* 在 appModePWA 小屏)下,底部 DockFooter通过 Teleport 挂载到 body
* 始终可见并悬浮在底部。本 composable 会测量 Dock 的实际 DOM 高度(已包含
* safe-area-inset-bottom从而自适应不同 iOS 设备的安全区域。
* 通过 DOM 测量获取布局的实际 padding含 safe-area-inset-top/bottom
* 以及 Footer Dock 的实际高度,确保在任何设备上都不会被 Dock 遮挡。
*
* 计算公式: viewport - navbarHeight - layoutPadding - footerDock - componentOffset
* 其中 componentOffset 是调用方指定的组件内部额外占用空间(如工具栏、分页栏等)
* 计算公式: viewport - layoutPaddingTop - layoutPaddingBottom - footerDock - componentOffset
*
* @param componentOffset - 组件内部额外占用的空间(工具栏、分页栏等,默认 64
* @param minHeight - 最小高度(默认 300
@@ -20,18 +18,26 @@ export function useAvailableHeight(
) {
const { appMode } = usePWA()
// 响应式的视口高度,监听 resize 事件
// 响应式测量值
const viewportHeight = ref(window.innerHeight || document.documentElement.clientHeight)
// Footer Dock 测量高度(响应式)
const layoutPaddingTop = ref(72)
const layoutPaddingBottom = ref(24)
const footerDockMeasuredHeight = ref(0)
function updateMeasurements() {
viewportHeight.value = window.innerHeight || document.documentElement.clientHeight
// 测量 .layout-page-content 的实际 padding含 env(safe-area-inset-top) 等)
const layoutEl = document.querySelector('.layout-page-content') as HTMLElement | null
if (layoutEl) {
const style = getComputedStyle(layoutEl)
layoutPaddingTop.value = parseFloat(style.paddingTop) || 72
layoutPaddingBottom.value = parseFloat(style.paddingBottom) || 24
}
// 测量 Footer Dock 的实际高度
// footer-nav-container 的 CSS 中已包含 env(safe-area-inset-bottom)
// 所以 offsetHeight 是包含安全区域的完整高度
// .footer-nav-container 是 position:fixed, padding-block-end 含 env(safe-area-inset-bottom)
// offsetHeight 是元素自身的渲染高度(含 padding即 Dock 遮挡的区域大小
if (appMode.value) {
const footerEl = document.querySelector('.footer-nav-container') as HTMLElement | null
footerDockMeasuredHeight.value = footerEl ? footerEl.offsetHeight : 70
@@ -41,11 +47,10 @@ export function useAvailableHeight(
}
onMounted(() => {
// 初始测量
updateMeasurements()
// 初始测量nextTick 确保 DOM 已渲染)
nextTick(updateMeasurements)
window.addEventListener('resize', updateMeasurements)
// iOS 虚拟键盘弹出/收起时 visualViewport 会变化
if (window.visualViewport) {
window.visualViewport.addEventListener('resize', updateMeasurements)
}
@@ -61,16 +66,16 @@ export function useAvailableHeight(
const availableHeight = computed(() => {
const vh = viewportHeight.value
// navbar 固定高度(对应 layout-page-content 的 padding-block-start: 4.5rem
const navbarHeight = 72
// 布局顶部 padding含 safe-area-inset-top + navbar 高度
const topPadding = layoutPaddingTop.value
// layout-page-content 的 padding-block-end (1.5rem = 24px)
const layoutBottomPadding = 24
// 布局底部 padding
const bottomPadding = layoutPaddingBottom.value
// 底部 Dock 栏高度appMode 下通过 DOM 测量,含 safe-area-inset-bottom
// 底部 Dock 栏遮挡高度appMode 下通过 DOM 测量,含 safe-area-inset-bottom
const footerDockHeight = footerDockMeasuredHeight.value
const available = vh - navbarHeight - layoutBottomPadding - footerDockHeight - componentOffset
const available = vh - topPadding - bottomPadding - footerDockHeight - componentOffset
return Math.max(available, minHeight)
})