
* perf: Page supports custom height offset for flexible content height control. 允许通过 height 属性调整页面内容高度计算。修改了 Page 组件以支持自定义高度偏移量,用于更灵活的内容高度控制。 * chore: typo * perf(page): replace height with heightOffset for flexible content sizing The `height` prop was replaced with `heightOffset` to better describe its purpose when used with `autoContentHeight`. The new prop allows custom offset values (in pixels) to adjust content area sizing, with clearer documentation.
107 lines
2.5 KiB
Vue
107 lines
2.5 KiB
Vue
<script setup lang="ts">
|
|
import type { StyleValue } from 'vue';
|
|
|
|
import type { PageProps } from './types';
|
|
|
|
import { computed, nextTick, onMounted, ref, useTemplateRef } from 'vue';
|
|
|
|
import { CSS_VARIABLE_LAYOUT_CONTENT_HEIGHT } from '@vben-core/shared/constants';
|
|
import { cn } from '@vben-core/shared/utils';
|
|
|
|
defineOptions({
|
|
name: 'Page',
|
|
});
|
|
|
|
const { autoContentHeight = false, heightOffset = 0 } =
|
|
defineProps<PageProps>();
|
|
|
|
const headerHeight = ref(0);
|
|
const footerHeight = ref(0);
|
|
const shouldAutoHeight = ref(false);
|
|
|
|
const headerRef = useTemplateRef<HTMLDivElement>('headerRef');
|
|
const footerRef = useTemplateRef<HTMLDivElement>('footerRef');
|
|
|
|
const contentStyle = computed<StyleValue>(() => {
|
|
if (autoContentHeight) {
|
|
return {
|
|
height: `calc(var(${CSS_VARIABLE_LAYOUT_CONTENT_HEIGHT}) - ${headerHeight.value}px - ${typeof heightOffset === 'number' ? `${heightOffset}px` : heightOffset})`,
|
|
overflowY: shouldAutoHeight.value ? 'auto' : 'unset',
|
|
};
|
|
}
|
|
return {};
|
|
});
|
|
|
|
async function calcContentHeight() {
|
|
if (!autoContentHeight) {
|
|
return;
|
|
}
|
|
await nextTick();
|
|
headerHeight.value = headerRef.value?.offsetHeight || 0;
|
|
footerHeight.value = footerRef.value?.offsetHeight || 0;
|
|
setTimeout(() => {
|
|
shouldAutoHeight.value = true;
|
|
}, 30);
|
|
}
|
|
|
|
onMounted(() => {
|
|
calcContentHeight();
|
|
});
|
|
</script>
|
|
|
|
<template>
|
|
<div class="relative">
|
|
<div
|
|
v-if="
|
|
description ||
|
|
$slots.description ||
|
|
title ||
|
|
$slots.title ||
|
|
$slots.extra
|
|
"
|
|
ref="headerRef"
|
|
:class="
|
|
cn(
|
|
'bg-card border-border relative flex items-end border-b px-6 py-4',
|
|
headerClass,
|
|
)
|
|
"
|
|
>
|
|
<div class="flex-auto">
|
|
<slot name="title">
|
|
<div v-if="title" class="mb-2 flex text-lg font-semibold">
|
|
{{ title }}
|
|
</div>
|
|
</slot>
|
|
|
|
<slot name="description">
|
|
<p v-if="description" class="text-muted-foreground">
|
|
{{ description }}
|
|
</p>
|
|
</slot>
|
|
</div>
|
|
|
|
<div v-if="$slots.extra">
|
|
<slot name="extra"></slot>
|
|
</div>
|
|
</div>
|
|
|
|
<div :class="cn('h-full p-4', contentClass)" :style="contentStyle">
|
|
<slot></slot>
|
|
</div>
|
|
|
|
<div
|
|
v-if="$slots.footer"
|
|
ref="footerRef"
|
|
:class="
|
|
cn(
|
|
'bg-card align-center absolute bottom-0 left-0 right-0 flex px-6 py-4',
|
|
footerClass,
|
|
)
|
|
"
|
|
>
|
|
<slot name="footer"></slot>
|
|
</div>
|
|
</div>
|
|
</template>
|