From 80b2e4fce43ce153f1989927602fc3f0043b8940 Mon Sep 17 00:00:00 2001
From: xingyu4j <xingyu4j@vip.qq.com>
Date: Wed, 24 Sep 2025 15:04:29 +0800
Subject: [PATCH] feat: add ContentWrap comp

---
 .../components/content-wrap/content-wrap.vue  | 102 ++++++++++++++++++
 .../src/components/content-wrap/index.ts      |   2 +
 .../src/components/content-wrap/types.ts      |  18 ++++
 3 files changed, 122 insertions(+)
 create mode 100644 packages/effects/common-ui/src/components/content-wrap/content-wrap.vue
 create mode 100644 packages/effects/common-ui/src/components/content-wrap/index.ts
 create mode 100644 packages/effects/common-ui/src/components/content-wrap/types.ts

diff --git a/packages/effects/common-ui/src/components/content-wrap/content-wrap.vue b/packages/effects/common-ui/src/components/content-wrap/content-wrap.vue
new file mode 100644
index 00000000..4bc153a3
--- /dev/null
+++ b/packages/effects/common-ui/src/components/content-wrap/content-wrap.vue
@@ -0,0 +1,102 @@
+<script setup lang="ts">
+import type { StyleValue } from 'vue';
+
+import type { ContentWrapProps } 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: 'ContentWrap',
+});
+
+const { autoContentHeight = false, heightOffset = 0 } =
+  defineProps<ContentWrapProps>();
+
+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 - ${footerHeight.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="bg-card text-card-foreground border-border relative flex min-h-full flex-col rounded-xl border"
+  >
+    <div
+      v-if="
+        description ||
+        $slots.description ||
+        title ||
+        $slots.title ||
+        $slots.extra
+      "
+      ref="headerRef"
+      :class="
+        cn(
+          '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('align-center flex px-6 py-4', footerClass)"
+    >
+      <slot name="footer"></slot>
+    </div>
+  </div>
+</template>
diff --git a/packages/effects/common-ui/src/components/content-wrap/index.ts b/packages/effects/common-ui/src/components/content-wrap/index.ts
new file mode 100644
index 00000000..5b0ede5d
--- /dev/null
+++ b/packages/effects/common-ui/src/components/content-wrap/index.ts
@@ -0,0 +1,2 @@
+export { default as ContentWrap } from './content-wrap.vue';
+export * from './types';
diff --git a/packages/effects/common-ui/src/components/content-wrap/types.ts b/packages/effects/common-ui/src/components/content-wrap/types.ts
new file mode 100644
index 00000000..803c6874
--- /dev/null
+++ b/packages/effects/common-ui/src/components/content-wrap/types.ts
@@ -0,0 +1,18 @@
+export interface ContentWrapProps {
+  title?: string;
+  description?: string;
+  message?: string;
+  contentClass?: string;
+  /**
+   * 根据content可见高度自适应
+   */
+  autoContentHeight?: boolean;
+  headerClass?: string;
+  footerClass?: string;
+  /**
+   * Custom height offset value (in pixels) to adjust content area sizing
+   * when used with autoContentHeight
+   * @default 0
+   */
+  heightOffset?: number;
+}