基于ElementPlus封裝下拉分頁單選硕舆、多選組件

單選
多選
vue和elementPlus版本:

"vue": "^3.2.37",
"element-plus": "2.3.6",

組件源碼:

components/SelectMore/index.vue
<template>
    <el-select v-model="selectVal" class="more-wrap" :multiple="multiple" :collapse-tags="multiple"
        :collapse-tags-tooltip="multiple" :placeholder="placeholder" :popper-class="onlyId" :disabled="disabled"
        v-load-more-directive="getList" v-search-directive @visible-change="visibleChange" clearable
        @change="selectChange">
        <el-option v-for="item in list" :key="item[value]" :label="optionText(item[value], item[label])"
            :value="item[value]">
            <!-- option文字 -->
            <p class="option-wrap" v-if="multiple" :title="optionText(item[value], item[label])">
                <label class="el-checkbox">
                    <span class="el-checkbox__inner"></span>
                    <span class="option-text" v-text="optionText(item[value], item[label])"></span>
                </label>
            </p>
            <p v-else class="option-wrap option-text" v-text="optionText(item[value], item[label])"
                :title="optionText(item[value], item[label])"></p>
        </el-option>

        <el-option v-show="showLoading" value="" disabled>
            <el-icon class="is-loading loading-icon">
                <i-ep-loading />
            </el-icon>正在加載中...
        </el-option>
        <p class="no-data" v-show="!showLoading && !list.length">暫無數(shù)據(jù)</p>
    </el-select>

    <!-- select里input搜索框 -->
    <el-form @submit.prevent @click.stop :class="`more-filter-${onlyId}`" class="more-filter">
        <el-form-item>
            <el-input v-model.trim="keywords" size="default" clearable :placeholder="searchPlaceholder">
            </el-input>
        </el-form-item>
    </el-form>
</template>

<script setup>
import { useFormItem } from 'element-plus'
import { useTextEffect, useDirectivesEffect, useListEffect } from './index'

const props = defineProps({
    modelValue: { // v-model

    },
    text: { // v-model:text

    },
    url: { // 遠(yuǎn)程地址
        required: true,
        type: String,
        default: ''
    },
    /*
     當(dāng)需要編輯回填時,整體頁面需要加個loading龙屉,讓該組件不能點(diǎn)擊呐粘。
     或判斷是編輯頁面,將該組件置為disabled转捕,等有editName后,再把disabled置為false
    */
    editData: { // 編輯回填選中的列表唆垃,編輯時必須
        type: Array,
        default() {
            return []
        }
    },
    disabled: { // 是否禁用
        type: Boolean,
        default: false,
    },
    value: { // value配置項(xiàng)
        type: String,
        default: 'id'
    },
    label: { // label配置項(xiàng)
        type: String,
        default: 'name'
    },
    /*
     當(dāng)額外傳參是動態(tài)變化的五芝,需要用響應(yīng)式的方式傳進(jìn)來
    */
    otherParams: { // 接口傳參
        type: Object,
        default() {
            return {}
        }
    },
    handleResult: { // 處理接口返回的數(shù)據(jù),使其返回data和page的組合形式
        type: Function,
        default: (data) => {
            return data
        }
    },
    multiple: {
        type: Boolean, // 是否多選
        default: false,
    },
    pageSize: { // 每次傳參個數(shù)
        type: Number,
        default: 20,
    },
    keyName: { // 搜索條件的key名
        type: String,
        default: 'keywords'
    },
    pageNumName: { // 搜索條件的當(dāng)前頁名
        type: String,
        default: 'pageNum'
    },
    pageSizeName: { // 搜索條件的每頁個數(shù)名
        type: String,
        default: 'pageSize'
    },
    showId: { // 是否顯示id
        type: Boolean,
        default: true,
    },
    placeholder: { // select框文字
        type: String,
        default: '請選擇'
    },
    searchPldText: { // 搜索顯示文字
        type: String,
        default: ''
    },
})

const emits = defineEmits(['change', 'update:modelValue', 'update:text'])

// 動態(tài)配置項(xiàng)
const { optionText, searchPlaceholder } = useTextEffect(props)

// 指令
const { onlyId, vLoadMoreDirective, vSearchDirective } = useDirectivesEffect()

// 搜索和列表
const { formItem } = useFormItem()
const { selectVal, keywords, showLoading, list, getList, visibleChange, selectChange, clear, reset } = useListEffect(props, emits, formItem)

defineExpose({
    reset, // reset與clear的區(qū)別是:reset執(zhí)行后辕万,再次打開select框枢步,數(shù)據(jù)會重新請求
    clear // 清空已選項(xiàng)
})
</script>

<style lang="scss" scoped>
@import '@/style/mixins.scss';

.more-filter {
    padding: 10px 10px 0;
    min-width: 230px;

    .el-form-item {
        margin-bottom: 0
    }
}

.option-wrap {
    margin: 0 -10px 0 -7px;
}

.option-text {
    @include ellipsis;
    max-width: 300px;
    font-weight: 400;
    margin-left: 5px;
}

.loading-icon {
    margin-right: 5px;
    vertical-align: middle;
}

/* 多選時顯示原有的標(biāo)簽樣式 */
.more-wrap :deep(.el-select-tags-wrapper.has-prefix) {
    display: flex;
    flex-wrap: nowrap;
}

.tool-tip-text {
    max-width: 400px;
}

/* 多選options樣式  */
.el-select-dropdown.is-multiple .el-select-dropdown__item.selected {
    &:after {
        display: none;
    }

    .el-checkbox .el-checkbox__inner {
        background-color: var(--el-checkbox-checked-bg-color);
        border-color: var(--el-checkbox-checked-input-border-color);

        &:after {
            transform: rotate(45deg) scaleY(1);
        }
    }

}

.no-data {
    text-align: center;
    font-size: 14px;
    color: #999;
}

:deep(.el-input__inner) {
    text-overflow: ellipsis;
}
</style>
<style>
/* 多選樣式選中文字彈出樣式 */
.el-select__collapse-tags {
    max-width: 500px;
    max-height: 200px;
    overflow: auto;
    padding-right: 10px;
}
</style>
</script>

<style lang="scss" scoped>
@import '@/style/mixins.scss';

.more-filter {
    padding: 10px 10px 0;
    min-width: 230px;

    .el-form-item {
        margin-bottom: 0
    }
}

.option-wrap {
    margin: 0 -10px 0 -7px;
}

.option-text {
    @include ellipsis;
    max-width: 300px;
    margin-left: 5px;
}

.loading-icon {
    margin-right: 5px;
    vertical-align: middle;
}

/* 多選時顯示原有的標(biāo)簽樣式 */
.more-wrap :deep(.el-select-tags-wrapper.has-prefix) {
    display: flex;
    flex-wrap: nowrap;
}

/* 多選時顯示文字樣式 */
.more-wrap-text {
    :deep(.el-select__tags) {
        display: none;
    }

    .more-sel-text {
        position: absolute;
        left: 0;
        top: 0;
        bottom: 0;
        right: 30px;
        z-index: var(--el-index-normal);

        .text-wrap {
            padding: 1px 11px;
        }
    }
}

.tool-tip-text {
    max-width: 400px;
}

/* 多選options樣式  */
.el-select-dropdown.is-multiple .el-select-dropdown__item.selected {
    &:after {
        display: none;
    }

    .el-checkbox .el-checkbox__inner {
        background-color: var(--el-checkbox-checked-bg-color);
        border-color: var(--el-checkbox-checked-input-border-color);

        &:after {
            transform: rotate(45deg) scaleY(1);
        }
    }

}

:deep(.el-input__inner) {
    text-overflow: ellipsis;
}
</style>
<style>
/* 多選樣式選中文字彈出樣式 */
.el-select__collapse-tags {
    max-width: 500px;
    max-height: 200px;
    overflow: auto;
    padding-right: 10px;
}
</style>
components/SelectMore/index.js
import { debounce } from '@/utils/tools'
import request from '@/utils/request'

let idIndex = 0

// 指令相關(guān)
export const useDirectivesEffect = () => {
    // 保證當(dāng)前組件唯一
    const onlyId = `more_${idIndex++}_${new Date().getTime()}`

    // 監(jiān)聽滾動到底部時,執(zhí)行
    const vLoadMoreDirective = {
        mounted(el, binding) {
            const selectDropDownWrap = document.querySelector(`.el-popper.${onlyId} .el-select-dropdown .el-select-dropdown__wrap`)
            selectDropDownWrap?.addEventListener('scroll', function () {
                const scrollToBottom = Math.floor(this.scrollHeight - this.scrollTop) <= this.clientHeight
                if (scrollToBottom) {
                    binding.value()
                }
            })
        }
    }

    // 下拉框內(nèi)插入搜索框
    const vSearchDirective = {
        mounted(el, binding) {
            const selectDropDown = document.querySelector(`.el-popper.${onlyId} .el-select-dropdown`)
            const searchDom = document.querySelector(`.more-filter-${onlyId}`)
            searchDom && selectDropDown?.prepend(searchDom)
        }
    }

    return { onlyId, vLoadMoreDirective, vSearchDirective }
}

// 頁面數(shù)據(jù)
export const useListEffect = (props, emits, formItem) => {
    const list = ref([]) // 列表數(shù)據(jù)
    const keywords = ref('') // 搜索關(guān)鍵字
    let originListInfo = {} // 源數(shù)據(jù)詳情
    const searchSet = reactive({
        init: true, // 是否是第一次加載
        pageNum: 1, // 當(dāng)前頁數(shù)
        loading: false, // 正在請求接口
        isFinish: false,  // 數(shù)據(jù)加載完成
    })

    // 請求接口獲取數(shù)據(jù)
    let controller // 接口api
    const getList = async () => {
        // 加載完成或正在加載時渐尿,取消加載
        if (searchSet.isFinish || searchSet.loading) {
            return false
        }

        // 中斷上次的請求醉途。防止加載分頁數(shù)據(jù)時,搜索內(nèi)容的結(jié)果是上一次的分頁內(nèi)容
        controller && controller.abort()
        controller = new AbortController()

        searchSet.loading = true
        const pageNum = searchSet.pageNum++;
        const pageSize = props.pageSize;
        const params = Object.assign({}, props.otherParams, {
            [props.pageNumName]: pageNum,
            [props.pageSizeName]: pageSize,
            [props.keyName]: keywords.value
        })

        const result = await request.post(props.url, params, {
            signal: controller.signal
        })

        if (result.code === 'ERR_CANCELED') { // 已取消不再往下執(zhí)行
            return false
        }

        searchSet.loading = false
        const { page, data = [] } = props.handleResult(result)
        searchSet.isFinish = pageNum * pageSize >= page?.total
        list.value = list.value.concat(data)
    }

    // select框的值
    const selectVal = computed({
        get: function () {
            return props.modelValue
        },
        set: function () {

        }
    })

    // change事件
    const selectChange = (selectId) => {
        const idKey = props.value
        const textKey = props.label
        let updateId = undefined // 選中的id
        let updateText = undefined // 選中的text
        let updateOriginData = undefined // 選中的數(shù)據(jù)信息

        const listValue = toRaw(list.value)
        if (props.multiple) { // 多選
            updateId = []
            updateText = []
            updateOriginData = []

            selectId?.forEach(itemId => {
                let originInfo = originListInfo[itemId]
                if (!originInfo) {
                    originInfo = listValue.find(itemObj => itemObj[idKey] === itemId)
                    originListInfo[itemId] = originInfo
                }
                updateId.push(originInfo[idKey])
                updateText.push(originInfo[textKey])
                updateOriginData.push(originInfo)
            })
        } else { // 非多選
            let originInfo = selectId ? originListInfo[selectId] : {}
            if (selectId && !originInfo) {
                originInfo = listValue.find(itemObj => itemObj[idKey] === selectId)
                originListInfo[selectId] = originInfo
            }

            updateId = originInfo[idKey]
            updateText = originInfo[textKey]
            updateOriginData = originInfo
        }

        emits('update:modelValue', updateId)
        emits('update:text', updateText)
        emits('change', updateOriginData)
        formItem?.validate('change') // 觸發(fā)表單校驗(yàn)
    }

    // 展示加載更多選項(xiàng)
    const showLoading = computed(() => {
        return !searchSet.isFinish
    })

    // 重置請求數(shù)據(jù)
    const resetList = () => {
        // 重置請求狀態(tài)
        searchSet.pageNum = 1
        searchSet.loading = false
        searchSet.isFinish = false
        list.value = []

        // 請求數(shù)據(jù)
        getList()
    }

    // 展示時請求接口
    const visibleChange = (visible) => {
        if (visible && searchSet.init) {
            searchSet.init = false
            resetList()
        }
    }

    /**
     * 清空已選項(xiàng)
     * @param {*} triggerChange 是否觸發(fā)change事件
     */
    const clear = (triggerChange) => {
        const val = props.multiple ? [] : undefined

        selectVal.value = val

        if (triggerChange) { // 觸發(fā)change事件
            selectChange()
        } else { // 更新id和text的值
            emits('update:modelValue', val)
            emits('update:text', val)
        }
    }

    /**
     * 清空已選項(xiàng)請重新請求列表數(shù)據(jù)(與clear的區(qū)別是:reset執(zhí)行后砖茸,再次打開select框隘擎,數(shù)據(jù)會重新請求)
     * @param {*} triggerChange 是否觸發(fā)change事件
     */
    const reset = (triggerChange) => {
        searchSet.init = true
        clear(triggerChange)
    }

    // 搜索
    watch(keywords, debounce(resetList, 300))

    // 監(jiān)聽傳參改變,需要把已選值置空凉夯,當(dāng)再次展開時货葬,重新請求接口
    watch(() => props.otherParams, (newVal, oldVal) => {
        if (JSON.stringify(oldVal) === JSON.stringify(newVal)) {
            return false
        }
        reset(true)
    }, { deep: true })

    // 編輯回填
    watch(() => props.editData, (editData) => {
        editData = toRaw(editData)

        if (!editData?.length) {
            return false
        }

        searchSet.init = true // 更改值時采幌,將init重置為true

        list.value = editData // 回填選項(xiàng)

        // 回填id和text,并保存源數(shù)據(jù)
        let editIdArr = []
        let updateText = []
        const idKey = props.value
        const textKey = props.label
        editData.forEach((item) => {
            editIdArr.push(item[idKey])
            updateText.push(item[textKey])
            originListInfo[item[props.value]] = item // 保存源數(shù)據(jù)
        })

        const selectId = props.multiple ? editIdArr : editIdArr[0]
        const selectText = props.multiple ? updateText : updateText[0]

        selectVal.value = selectId // 回填select框id

        emits('update:modelValue', selectId) // 觸發(fā)id改變
        emits('update:text', selectText) // 觸發(fā)text改變
    })

    return { selectVal, keywords, showLoading, list, getList, visibleChange, selectChange, clear, reset }
}

// 頁面配置文字
export const useTextEffect = (props) => {
    const optionText = (id, name) => {
        return props.showId ? `【${id}】${name}` : name
    }

    const searchPlaceholder = computed(() => props.searchPldText || (props.showId ? '模糊搜索ID或名稱' : '模糊搜索名稱'))

    return { optionText, searchPlaceholder }
}

基礎(chǔ)用法:

引入組件震桶,設(shè)置v-modelurl即可休傍。

 <select-more v-model="" url=""></select-more>

完整示例見以下代碼:

<template>
    <el-form :model="formData" :rules="rules" label-width="130px">

        <h4>單選</h4>
        <el-form-item label="訂單:" prop="order">
            <select-more v-model="formData.order" v-model:text="formData.orderText"
                url="/api/put-name">
            </select-more>
        </el-form-item>

        <h4>單選-拓展</h4>
        <el-form-item label="admin:" prop="admin">
            <select-more v-model="formData.admin" url="/api/getList" label="showText"
                pageSizeName="perPageCount" :other-params="adminParams" :defaultList="formData.defaultList"
                placeholder="全部" searchPlaceholder="模糊搜索id和名稱" :handleResult="handleResult" @change="selectChange">
            </select-more>
        </el-form-item>

        <h4>編輯回填</h4>
        <el-form-item label="廣告主:" prop="adver">
            <select-more v-model="formData.adver" url="/api/put-name" @change="changeAdver"
                :edit-data="formData.editAdverData">
            </select-more>
        </el-form-item>

        <h4>聯(lián)動關(guān)系</h4>
        <el-form-item label="廣告位:" prop="adunit">
            <select-more ref="adunit" v-model="formData.adunit" url="/api/put-name"
                :other-params="adunitOtherParams" :disabled="!formData.adver" :edit-data="formData.editAdunitData">
            </select-more>
        </el-form-item>

        <h4>多選</h4>
        <el-form-item label="投放:" prop="invest">
            <select-more v-model="formData.invest" multiple
                url="/api/put-name" :edit-data="formData.editInvestData">
            </select-more>
        </el-form-item>
    </el-form>
</template>

<script setup>
import selectMore from '@/components/selectMore/index.vue'

const formData = reactive({
    order: undefined,
    orderText: '',
    admin: '',
    defaultList: [{
        id: '-1',
        text: '全部',
        showText: '全部'
    }],
    adver: '',
    invest: [],
    adunit: '',
    editAdverData: [],
    editInvestData: [],
    editAdunitData: [],
})
const rules = reactive({
    order: [
        { required: true, message: '請選擇訂單', trigger: 'change' }
    ],
    adver: [
        { required: true, message: '請選擇廣告主', trigger: 'change' }
    ],
    invest: [
        { required: true, message: '請選擇投放', trigger: 'change' }
    ],
    adunit: [
        { required: true, message: '請選擇廣告位', trigger: 'change' }
    ],
})

// 依賴其它選項(xiàng)傳參
const adminParams = { key_pair: 1 }
const adunitOtherParams = computed(() => {
    return {
        no_policy: 0,
        investId: formData.adver
    }
})

// 接口返回結(jié)果特殊處理
const handleResult = (res) => {
    const data = res.data
    return {
        data: data.data,
        page: {
            total: data.total
        }
    }
}

// 模擬接口回填信息
setTimeout(async () => {
    formData.editAdverData = [{ // 廣告主回填
        id: 63787,
        name: 'vv-iptv'
    }]

    await nextTick() // 有聯(lián)動關(guān)系時,需要等前一個的更新后蹲姐,再更新當(dāng)前值
    formData.editAdunitData = [{ // 廣告位回填
        id: 63843,
        name: 'vv-聯(lián)合控量-test'
    }]

    formData.editInvestData = [{ // 投放回填
        id: 63787,
        name: 'vv-iptv'
    }, {
        id: 63843,
        name: 'vv-聯(lián)合控量-test'
    }]

    await nextTick()
    formData.editLoading = false
}, 500)
</script>

<style scoped>
.page-title {
    margin-top: 20px;
}
</style>
參數(shù)說明:

注:原創(chuàng)磨取,如需轉(zhuǎn)載請注明出處

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市柴墩,隨后出現(xiàn)的幾起案子忙厌,更是在濱河造成了極大的恐慌,老刑警劉巖拐邪,帶你破解...
    沈念sama閱讀 217,084評論 6 503
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件慰毅,死亡現(xiàn)場離奇詭異,居然都是意外死亡扎阶,警方通過查閱死者的電腦和手機(jī)汹胃,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,623評論 3 392
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來东臀,“玉大人着饥,你說我怎么就攤上這事《韪常” “怎么了宰掉?”我有些...
    開封第一講書人閱讀 163,450評論 0 353
  • 文/不壞的土叔 我叫張陵,是天一觀的道長赁濒。 經(jīng)常有香客問我轨奄,道長,這世上最難降的妖魔是什么拒炎? 我笑而不...
    開封第一講書人閱讀 58,322評論 1 293
  • 正文 為了忘掉前任挪拟,我火速辦了婚禮,結(jié)果婚禮上击你,老公的妹妹穿的比我還像新娘玉组。我一直安慰自己,他們只是感情好丁侄,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,370評論 6 390
  • 文/花漫 我一把揭開白布惯雳。 她就那樣靜靜地躺著,像睡著了一般鸿摇。 火紅的嫁衣襯著肌膚如雪石景。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,274評論 1 300
  • 那天,我揣著相機(jī)與錄音鸵钝,去河邊找鬼糙臼。 笑死,一個胖子當(dāng)著我的面吹牛恩商,可吹牛的內(nèi)容都是我干的变逃。 我是一名探鬼主播,決...
    沈念sama閱讀 40,126評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼怠堪,長吁一口氣:“原來是場噩夢啊……” “哼揽乱!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起粟矿,我...
    開封第一講書人閱讀 38,980評論 0 275
  • 序言:老撾萬榮一對情侶失蹤凰棉,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后陌粹,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體撒犀,經(jīng)...
    沈念sama閱讀 45,414評論 1 313
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,599評論 3 334
  • 正文 我和宋清朗相戀三年掏秩,在試婚紗的時候發(fā)現(xiàn)自己被綠了或舞。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 39,773評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡蒙幻,死狀恐怖映凳,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情邮破,我是刑警寧澤诈豌,帶...
    沈念sama閱讀 35,470評論 5 344
  • 正文 年R本政府宣布,位于F島的核電站抒和,受9級特大地震影響矫渔,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜摧莽,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,080評論 3 327
  • 文/蒙蒙 一蚌斩、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧范嘱,春花似錦、人聲如沸员魏。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,713評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽撕阎。三九已至受裹,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背棉饶。 一陣腳步聲響...
    開封第一講書人閱讀 32,852評論 1 269
  • 我被黑心中介騙來泰國打工厦章, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人照藻。 一個月前我還...
    沈念sama閱讀 47,865評論 2 370
  • 正文 我出身青樓袜啃,卻偏偏與公主長得像,于是被迫代替她去往敵國和親幸缕。 傳聞我的和親對象是個殘疾皇子群发,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,689評論 2 354

推薦閱讀更多精彩內(nèi)容