feat: ✨ pageSearch组件，添加间距样式配置，自适应布局按钮位置配置，添加使用案例

src/components/CURD/PageSearch.vue

@@ -1,65 +1,68 @@
 <template>
-  <el-card
-    v-show="visible"
-    v-hasPerm="searchConfig?.pageName ? `${searchConfig.pageName}:query` : '*:*:*'"
-    v-bind="cardAttrs"
-    class="mb-2.5!"
-  >
-    <el-form ref="queryFormRef" :model="queryParams" :inline="true" :class="isGrid">
-      <template v-for="(item, index) in formItems" :key="item.prop">
-        <el-form-item
-          v-show="isExpand ? true : index < showNumber"
-          :label="item?.label"
-          :prop="item.prop"
-        >
-          <!-- Label -->
-          <template v-if="item?.tips" #label>
-            <span class="flex-y-center">
-              {{ item.label }}
-              <el-tooltip v-bind="getTooltipProps(item.tips)">
-                <QuestionFilled class="w-4 h-4 mx-1" />
-              </el-tooltip>
-              {{ searchConfig.colon ? ":" : "" }}
-            </span>
-          </template>
-          <template v-else #label>{{ item.label }} {{ searchConfig.colon ? ":" : "" }}</template>
-
-          <component
-            :is="componentMap[item?.type ? item?.type : 'input']"
-            v-model.trim="queryParams[item.prop]"
-            style="width: 100%"
-            v-bind="item.attrs"
-            :config="item.attrs"
-            v-on="item.events || {}"
+  <div v-show="visible" style="margin-bottom: 12px" v-bind="cardAttrs">
+    <el-card
+      v-hasPerm="searchConfig?.pageName ? `${searchConfig.pageName}:query` : '*:*:*'"
+      v-bind="cardAttrs"
+    >
+      <el-form ref="queryFormRef" :model="queryParams" v-bind="formAttrs" :class="isGrid">
+        <template v-for="(item, index) in formItems" :key="item.prop">
+          <el-form-item
+            v-show="isExpand ? true : index < showNumber"
+            :label="item?.label"
+            :prop="item.prop"
           >
-            <template v-if="item.type === 'select'">
-              <template v-for="opt in item.options">
-                <el-option :label="opt.label" :value="opt.value" />
-              </template>
+            <!-- Label -->
+            <template v-if="item?.tips" #label>
+              <span class="flex-y-center">
+                {{ item.label }}
+                <el-tooltip v-bind="getTooltipProps(item.tips)">
+                  <QuestionFilled class="w-4 h-4 mx-1" />
+                </el-tooltip>
+                {{ searchConfig.colon ? ":" : "" }}
+              </span>
             </template>
-          </component>
-        </el-form-item>
-      </template>
-      <el-form-item>
-        <el-button icon="search" type="primary" @click="handleQuery">搜索</el-button>
-        <el-button icon="refresh" @click="handleReset">重置</el-button>
-        <!-- 展开/收起 -->
-        <template v-if="isExpandable && formItems.length > showNumber">
-          <el-link class="ml-3" type="primary" :underline="false" @click="isExpand = !isExpand">
-            {{ isExpand ? "收起" : "展开" }}
-            <component :is="isExpand ? ArrowUp : ArrowDown" class="w-4 h-4 ml-2" />
-          </el-link>
+            <template v-else #label>{{ item.label }} {{ searchConfig.colon ? ":" : "" }}</template>
+
+            <el-cascader
+              v-if="item.type === 'cascader'"
+              v-model.trim="queryParams[item.prop]"
+              v-bind="{ style: { width: '100%' }, ...item.attrs }"
+              v-on="item.events || {}"
+            />
+            <component
+              :is="componentMap.get(item?.type ?? 'input')"
+              v-else
+              v-model.trim="queryParams[item.prop]"
+              v-bind="{ style: { width: '100%' }, ...item.attrs }"
+              v-on="item.events || {}"
+            >
+              <template v-if="item.type === 'select'">
+                <template v-for="opt in item.options">
+                  <el-option :label="opt.label" :value="opt.value" />
+                </template>
+              </template>
+            </component>
+          </el-form-item>
         </template>
-      </el-form-item>
-    </el-form>
-  </el-card>
+        <el-form-item :class="{ 'col-[auto/-1] justify-self-end': searchConfig?.grid === 'right' }">
+          <el-button icon="search" type="primary" @click="handleQuery">搜索</el-button>
+          <el-button icon="refresh" @click="handleReset">重置</el-button>
+          <!-- 展开/收起 -->
+          <template v-if="isExpandable && formItems.length > showNumber">
+            <el-link class="ml-3" type="primary" :underline="false" @click="isExpand = !isExpand">
+              {{ isExpand ? "收起" : "展开" }}
+              <component :is="isExpand ? ArrowUp : ArrowDown" class="w-4 h-4 ml-2" />
+            </el-link>
+          </template>
+        </el-form-item>
+      </el-form>
+    </el-card>
+  </div>
 </template>
 
 <script setup lang="ts">
 import type { IObject, ISearchConfig, ComponentType } from "./types";
 import { ArrowUp, ArrowDown } from "@element-plus/icons-vue";
-import { ElInput, ElInputNumber, ElInputTag, ElSelect, ElCascader } from "element-plus";
-import { ElTimePicker, ElTimeSelect, ElOption, ElDatePicker, ElTreeSelect } from "element-plus";
 import { type FormInstance } from "element-plus";
 import InputTag from "@/components/InputTag/index.vue";
 
@@ -71,18 +74,21 @@ const emit = defineEmits<{
   resetClick: [queryParams: IObject];
 }>();
 // 组件映射表
-const componentMap: Record<ComponentType, Component> = {
-  input: markRaw(ElInput),
-  select: markRaw(ElSelect),
-  cascader: markRaw(ElCascader),
-  "input-number": markRaw(ElInputNumber),
-  "date-picker": markRaw(ElDatePicker),
-  "time-picker": markRaw(ElTimePicker),
-  "time-select": markRaw(ElTimeSelect),
-  "tree-select": markRaw(ElTreeSelect),
-  "input-tag": markRaw(ElInputTag),
-  "custom-tag": markRaw(InputTag),
-};
+const componentMap = new Map<ComponentType, Component>([
+  /* eslint-disable */
+  // @ts-ignore
+  ["input", markRaw(ElInput)], // @ts-ignore
+  ["select", markRaw(ElSelect)], // @ts-ignore
+  ["cascader", markRaw(ElCascader)], // @ts-ignore
+  ["input-number", markRaw(ElInputNumber)], // @ts-ignore
+  ["date-picker", markRaw(ElDatePicker)], // @ts-ignore
+  ["time-picker", markRaw(ElTimePicker)], // @ts-ignore
+  ["time-select", markRaw(ElTimeSelect)], // @ts-ignore
+  ["tree-select", markRaw(ElTreeSelect)], // @ts-ignore
+  ["input-tag", markRaw(ElInputTag)], // @ts-ignore
+  ["custom-tag", markRaw(InputTag)],
+  /* eslint-enable */
+]);
 
 const queryFormRef = ref<FormInstance>();
 // 是否显示
@@ -97,11 +103,13 @@ const isExpand = ref(false);
 const showNumber = computed(() =>
   isExpandable.value ? (props.searchConfig?.showNumber ?? 3) : formItems.length
 );
-// 卡片组件自定义属性（累名、阴影、权限等）
+// 卡片组件自定义属性（阴影、自定义边距样式等）
 const cardAttrs = computed<IObject>(() => {
-  return props.searchConfig?.cardAttrs && props.searchConfig.cardAttrs instanceof Object
-    ? { shadow: "never", ...props.searchConfig.cardAttrs }
-    : { shadow: "never" };
+  return { shadow: "never", ...props.searchConfig?.cardAttrs };
+});
+// 表单组件自定义属性（label位置、宽度、对齐方式等）
+const formAttrs = computed(() => {
+  return { inline: true, ...props.searchConfig?.form };
 });
 // 是否使用自适应网格布局
 const isGrid = computed(() =>
@@ -119,7 +127,7 @@ const getTooltipProps = (tips: any) => {
 onMounted(() => {
   formItems.forEach((item) => {
     item.initFn && item.initFn(item);
-    if (item.type === "input-tag" || item.type === "custom-tag") {
+    if (["input-tag", "custom-tag", "cascader"].includes(item?.type ?? "")) {
       queryParams[item.prop] = Array.isArray(item.initialValue) ? item.initialValue : [];
     } else if (item.type === "input-number") {
       queryParams[item.prop] = item.initialValue ?? null;

src/components/CURD/types.ts

@@ -13,6 +13,7 @@ import type PageContent from "./PageContent.vue";
 import type PageForm from "./PageForm.vue";
 import type PageModal from "./PageModal.vue";
 import type PageSearch from "./PageSearch.vue";
+import { CSSProperties } from "vue";
 
 export type PageSearchInstance = InstanceType<typeof PageSearch>;
 export type PageContentInstance = InstanceType<typeof PageContent>;
@@ -71,9 +72,11 @@ export interface ISearchConfig {
   // 默认展示的表单项数量(默认：3)
   showNumber?: number;
   // 卡片属性
-  cardAttrs?: Partial<CardProps>;
+  cardAttrs?: Partial<CardProps> & { style?: CSSProperties };
+  // form组件属性
+  form?: IForm;
   // 自适应网格布局(使用时表单不要添加 style: { width: "200px" })
-  grid?: boolean;
+  grid?: boolean | "left" | "right";
 }
 
 export interface IContentConfig<T = any> {

src/components/InputTag/index.vue

@@ -1,26 +1,29 @@
 <template>
-  <div class="flex-y-center gap-2">
-    <el-tag
-      v-for="tag in tags"
-      :key="tag"
-      closable
-      :disable-transitions="false"
-      v-bind="config.tagAttrs"
-      @close="handleClose(tag)"
-    >
-      {{ tag }}
-    </el-tag>
-    <el-input
-      v-if="inputVisible"
-      ref="inputRef"
-      v-model.trim="inputValue"
-      @keyup.enter.stop.prevent="handleInputConfirm"
-      @blur.stop.prevent="handleInputConfirm"
-    />
-    <el-button v-else v-bind="config.buttonAttrs" @click="showInput">
-      {{ config.buttonAttrs.btnText ? config.buttonAttrs.btnText : "+ New Tag" }}
-    </el-button>
-  </div>
+  <el-scrollbar>
+    <div class="flex-y-center gap-2">
+      <el-tag
+        v-for="tag in tags"
+        :key="tag"
+        closable
+        :disable-transitions="false"
+        v-bind="config.tagAttrs"
+        @close="handleClose(tag)"
+      >
+        {{ tag }}
+      </el-tag>
+      <el-input
+        v-if="inputVisible"
+        ref="inputRef"
+        v-model.trim="inputValue"
+        style="min-width: 100px"
+        @keyup.enter.stop.prevent="handleInputConfirm"
+        @blur.stop.prevent="handleInputConfirm"
+      />
+      <el-button v-else v-bind="config.buttonAttrs" @click="showInput">
+        {{ config.buttonAttrs.btnText ? config.buttonAttrs.btnText : "+ New Tag" }}
+      </el-button>
+    </div>
+  </el-scrollbar>
 </template>
 <script setup lang="ts">
 import type { InputInstance } from "element-plus";