148 lines
5.4 KiB
Vue
148 lines
5.4 KiB
Vue
<script setup>
|
||||
|
|
// 通用远程分页下拉(2026-11-17 主控包项A):远程模糊搜索 + 触底加载下一页 + 排序与对应列表页一致。
|
|||
|
|
// 设计要点:
|
|||
|
|
// 1. 排序口径不在此组件定义——选项完全来自 url 接口,接口排序即列表页排序(下拉与列表同源,天然一致)。
|
|||
|
|
// 2. 触底加载:展开后给下拉浮层滚动条挂一次 scroll 监听,滚到底部自动取下一页并追加(按 valueKey 去重)。
|
|||
|
|
// 3. 硬上限 maxItems(默认1000):防止用户一直下拉拖垮后端,超出后停止翻页。
|
|||
|
|
// 4. 两种分页协议:mode='offset'(keyword+limit+offset)或 'page'(page/pageSize+keyword),按后端接口选。
|
|||
|
|
import { ref, nextTick } from 'vue'
|
|||
|
|
import request from '../utils/request'
|
|||
|
|
|
|||
|
|
const props = defineProps({
|
|||
|
|
modelValue: { type: [String, Number, Array], default: '' },
|
|||
|
|
multiple: { type: Boolean, default: false },
|
|||
|
|
clearable: { type: Boolean, default: true },
|
|||
|
|
placeholder: { type: String, default: '搜索选择' },
|
|||
|
|
width: { type: String, default: '100%' },
|
|||
|
|
url: { type: String, required: true }, // 列表接口(与对应列表页同一个,保证排序一致)
|
|||
|
|
valueKey: { type: String, default: 'id' }, // 选项值字段
|
|||
|
|
labelKey: { type: String, default: 'name' }, // 选项显示字段(简单场景);复杂场景用 labelFn
|
|||
|
|
labelFn: { type: Function, default: null }, // (row)=>string 自定义显示
|
|||
|
|
keywordParam: { type: String, default: 'keyword' },
|
|||
|
|
mode: { type: String, default: 'page' }, // 'page' | 'offset'
|
|||
|
|
pageSize: { type: Number, default: 100 },
|
|||
|
|
maxItems: { type: Number, default: 1000 },
|
|||
|
|
extraParams: { type: Object, default: () => ({}) },
|
|||
|
|
popperClass: { type: String, default: 'rps-popper' }
|
|||
|
|
})
|
|||
|
|
const emit = defineEmits(['update:modelValue', 'change', 'options-change', 'row-change'])
|
|||
|
|
|
|||
|
|
const options = ref([])
|
|||
|
|
const loading = ref(false)
|
|||
|
|
const keyword = ref('')
|
|||
|
|
const page = ref(1)
|
|||
|
|
const offset = ref(0)
|
|||
|
|
const hasMore = ref(true)
|
|||
|
|
|
|||
|
|
function labelOf(row) {
|
|||
|
|
return props.labelFn ? props.labelFn(row) : (row?.[props.labelKey] ?? '')
|
|||
|
|
}
|
|||
|
|
function baseParams() {
|
|||
|
|
return { ...props.extraParams, [props.keywordParam]: keyword.value }
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 首页/搜索:重置游标并拉第一页
|
|||
|
|
async function search(kw) {
|
|||
|
|
keyword.value = kw || ''
|
|||
|
|
page.value = 1
|
|||
|
|
offset.value = 0
|
|||
|
|
hasMore.value = true
|
|||
|
|
loading.value = true
|
|||
|
|
try {
|
|||
|
|
const params = baseParams()
|
|||
|
|
if (props.mode === 'offset') {
|
|||
|
|
params.limit = props.pageSize
|
|||
|
|
params.offset = 0
|
|||
|
|
} else {
|
|||
|
|
params.page = 1
|
|||
|
|
params.pageSize = props.pageSize
|
|||
|
|
}
|
|||
|
|
const data = await request.get(props.url, { params })
|
|||
|
|
const rows = Array.isArray(data) ? data : (data?.list || [])
|
|||
|
|
options.value = rows
|
|||
|
|
if (props.mode === 'offset') {
|
|||
|
|
offset.value = rows.length
|
|||
|
|
hasMore.value = rows.length >= props.pageSize
|
|||
|
|
} else {
|
|||
|
|
page.value = 1
|
|||
|
|
hasMore.value = rows.length >= props.pageSize
|
|||
|
|
}
|
|||
|
|
emit('options-change', options.value)
|
|||
|
|
} catch {
|
|||
|
|
options.value = []
|
|||
|
|
hasMore.value = false
|
|||
|
|
} finally {
|
|||
|
|
loading.value = false
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 触底追加下一页,按 valueKey 去重
|
|||
|
|
async function loadMore() {
|
|||
|
|
if (!hasMore.value || loading.value || options.value.length >= props.maxItems) return
|
|||
|
|
loading.value = true
|
|||
|
|
try {
|
|||
|
|
const params = baseParams()
|
|||
|
|
if (props.mode === 'offset') {
|
|||
|
|
params.limit = props.pageSize
|
|||
|
|
params.offset = offset.value
|
|||
|
|
} else {
|
|||
|
|
params.page = page.value + 1
|
|||
|
|
params.pageSize = props.pageSize
|
|||
|
|
}
|
|||
|
|
const data = await request.get(props.url, { params })
|
|||
|
|
const rows = Array.isArray(data) ? data : (data?.list || [])
|
|||
|
|
const seen = new Set(options.value.map((o) => o[props.valueKey]))
|
|||
|
|
let added = 0
|
|||
|
|
for (const r of rows) {
|
|||
|
|
const k = r[props.valueKey]
|
|||
|
|
if (!seen.has(k) && options.value.length < props.maxItems) {
|
|||
|
|
options.value.push(r)
|
|||
|
|
seen.add(k)
|
|||
|
|
added++
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
if (props.mode === 'offset') offset.value += rows.length
|
|||
|
|
else page.value += 1
|
|||
|
|
hasMore.value = rows.length >= props.pageSize && options.value.length < props.maxItems
|
|||
|
|
if (added) emit('options-change', options.value)
|
|||
|
|
} catch {
|
|||
|
|
hasMore.value = false
|
|||
|
|
} finally {
|
|||
|
|
loading.value = false
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 浮层 teleport 到 body:展开后按 popperClass 精确定位滚动条,只挂一次监听
|
|||
|
|
function onVisibleChange(visible) {
|
|||
|
|
if (!visible) return
|
|||
|
|
nextTick(() => {
|
|||
|
|
const wrap = document.querySelector('.' + props.popperClass + ' .el-select-dropdown__wrap')
|
|||
|
|
if (!wrap || wrap.dataset.rpsBound === props.popperClass) return
|
|||
|
|
wrap.dataset.rpsBound = props.popperClass
|
|||
|
|
wrap.addEventListener('scroll', () => {
|
|||
|
|
if (wrap.scrollHeight - wrap.scrollTop <= wrap.clientHeight + 1) loadMore()
|
|||
|
|
})
|
|||
|
|
})
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
function onChange(v) {
|
|||
|
|
emit('update:modelValue', v)
|
|||
|
|
emit('change', v)
|
|||
|
|
const row = options.value.find((o) => o[props.valueKey] === v) || null
|
|||
|
|
emit('row-change', row)
|
|||
|
|
}
|
|||
|
|
function reload() { search(keyword.value) }
|
|||
|
|
search('')
|
|||
|
|
|
|||
|
|
defineExpose({ reload, search })
|
|||
|
|
</script>
|
|||
|
|
|
|||
|
|
<template>
|
|||
|
|
<el-select :model-value="modelValue" :multiple="multiple" :clearable="clearable" filterable remote
|
|||
|
|
:remote-method="search" :loading="loading" :placeholder="placeholder"
|
|||
|
|
:style="{ width }" :popper-class="popperClass"
|
|||
|
|
@change="onChange" @visible-change="onVisibleChange">
|
|||
|
|
<el-option v-for="row in options" :key="row[valueKey]" :value="row[valueKey]" :label="labelOf(row)" />
|
|||
|
|
</el-select>
|
|||
|
|
</template>
|