基於uniapp+vue3自定義增強版table表格組件「相容H5+小程式+App端」

来源:https://www.cnblogs.com/xiaoyan2017/p/18199130
-Advertisement-
Play Games

vue3+uniapp多端自定義table組件|uniapp加強版綜合表格組件 uv3-table:一款基於uniapp+vue3跨端自定義手機端增強版表格組件。支持固定表頭/列、邊框、斑馬紋、單選/多選,自定義表頭/表體插槽、左右固定列陰影高亮顯示。支持編譯相容H5+小程式端+App端。 如下圖: ...


vue3+uniapp多端自定義table組件|uniapp加強版綜合表格組件

uv3-table:一款基於uniapp+vue3跨端自定義手機端增強版表格組件。支持固定表頭/列、邊框、斑馬紋、單選/多選,自定義表頭/表體插槽、左右固定列陰影高亮顯示。支持編譯相容H5+小程式端+App端

如下圖:H5+小程式+App端,多端運行一致。

uv3-table表格插件是最新原創項目uniapp-os後臺管理系統的一個獨立版組件。

由於在開發uni-os手機後臺系統需要用到table表格組件。無奈uniapp官方及插件市場table表格組件無論功能及UI上都不滿足要求,於是自己爆肝一個多日夜開發了一款全新uniapp+vue3綜合表格組件。

目前該項目已經出階段性成果接近尾聲了,相信很快就能和大家見面,到時也會做一些技術分享,敬請期待!

uv3-table使用示例

將uv3-table組件放到uniapp項目components目錄下,無需在頁面再次引入,即可使用。

  • 基礎用法
<uv3-table :columns="columns" :dataSource="data.list" />
  • 自定義條紋樣式
<uv3-table
    :columns="columns"
    :dataSource="data.list"
    stripe
    stripeColor="#eee"
    padding="5px"
    height="450rpx"
/>
  • 綜合用法(固定表頭/列、自定義插槽內容)
<script setup>
    import { ref } from 'vue'
    import Mock from 'mockjs'

    const columns = ref([
        {type: 'selection', align: 'center', width: 80, fixed: true}, // 多選
        {type: 'index', label: 'ID', align: 'center', width: 80, fixed: true}, // 索引序號
        {prop: 'author', label: '作者', align: 'center', width: 120},
        {prop: 'title', label: '標題', align: 'left', width: 350},
        {prop: 'image', label: '圖片', align: 'center', width: 120},
        {prop: 'switch', label: '推薦', align: 'center', width: 100},
        {prop: 'tags', label: '標簽', align: 'center', width: 100},
        {prop: 'rate', label: '評分', align: 'center', width: 200},
        {prop: 'date', label: '發佈時間', align: 'left', width: 250}, // 時間
        {prop: 'action', label: '操作', align: 'center', width: 150, fixed: 'right'}, // 操作
    ])
    const data = ref(Mock.mock({
        total: 100,
        page: 1,
        pagesize: 10,
        'list|20': [
            {
                id: '@id()',
                author: '@cname()',
                title: '@ctitle(10, 20)',
                image: `https://api.yimian.xyz/img?id=@integer(100, 300)`,
                switch: '@boolean()',
                'tags|1': ['admin', 'test', 'dev'],
                rate: '@integer(1, 5)',
                date: '@datetime()',
                color: '@color()',
            }
        ]
    }))
</script>
<uv3-table
    :dataSource="data.list"
    :columns="columns"
    :headerBold="true"
    headerBackground="#ecf5ff"
    stripe
    border
    padding="5px"
    maxHeight="650rpx"
    @rowClick="handleRowClick"
    @select="handleSelect"
>
    <!-- 自定義header插槽內容 -->
    <template #headerCell="{ key, col, index }">
        <template v-if="key == 'title'">
            <view class="flex-c">{{col.label}} <input placeholder="搜索" size="small" /></view>
        </template>
        <template v-else-if="key == 'date'">
            <uni-icons type="calendar"></uni-icons> {{col.label}}
        </template>
        <template v-else>{{col.label}}</template>
    </template>
    
    <!-- 自定義body插槽內容(由於小程式不支持動態:name插槽,通過key標識來自定義表格內容) -->
    <template #default="{ key, value, row, col, index }">
        <template v-if="key == 'image'">
            <uv-image :src="value" lazyLoad observeLazyLoad @click="previewImage(value)" />
        </template>
        <template v-else-if="key == 'switch'">
            <switch :checked="value" style="transform:scale(0.6);" />
        </template>
        <template v-else-if="key == 'tags'">
            <uv-tags :text="value" :color="row.color" :borderColor="row.color" plain size="mini" />
        </template>
        <template v-else-if="key == 'rate'">
            <uni-rate :value="value" size="14" readonly />
        </template>
        <template v-else-if="key == 'action'">
            <uni-icons type="compose" color="#00aa7f" @click="handleEdit(row)" />
            <uni-icons type="trash" color="#ff007f" style="margin-left: 5px;" @click="handleDel(row)" />
        </template>
        <template v-else>{{value}}</template>
    </template>
</uv3-table>

rowClick點擊表格行,會返回該行數據。

select單選/多選,會返回表格選中數據。

uv3Table編碼實現

  • uv3-table表格參數配置
const props = defineProps({
    // 表格數據
    dataSource: {
        type: Array,
        default() {
            return []
        }
    },
    /**
     * @params {string} background 對應列背景色
     * @params {string} type 對應列類型(多選selection 索引index)
     * @params {string} label 顯示的列標題
     * @params {string} prop 對應的列欄位名
     * @params {string} align 列水平對齊方式(left center right)
     * @params {number|string} width 對應列寬度
     * @params {boolean|string} fixed 該列固定到左側(fixed:true|'left')或右側(fixed:'right')
     * @params {string} columnStyle 對應列自定義樣式
     * @params {string} className/class 表格列的類名className
     */
    columns: {
        type: Array,
        default() {
            return []
        }
    },
    // 表格寬度
    width: { type: [Number, String] },
    // 表格高度
    height: { type: [Number, String] },
    // 表格最大高度
    maxHeight: { type: [Number, String] },
    // 是否為斑馬紋
    stripe: { type: [Boolean, String] },
    // 斑馬紋背景
    stripeColor: { type: String, default: '#fafafa' },
    // 是否帶有邊框
    border: { type: [Boolean, String] },
    // 列寬度(推薦預設rpx)
    columnWidth: { type: [Number, String], default: 200 },
    // 單元格間距
    padding: { type: String, default: '5rpx 10rpx' },
    // 是否顯示表頭
    showHeader: { type: [Boolean, String], default: true },
    // 表頭背景色
    headerBackground: { type: String, default: '#ebeef5' },
    // 表頭顏色
    headerColor: { type: String, default: '#333' },
    // 表頭字體加粗
    headerBold: { type: [Boolean, String], default: true },
    // 表格背景色
    background: { type: String, default: '#fff' },
    // 表格顏色
    color: { type: String, default: '#606266' },
    // 空數據時顯示的文本內容,也可以通過 #empty 設置
    emptyText: { type: String, default: '暫無數據' }
})
  • 模板結構如下
<template>
    <view
        class="uv3__table"
        ...
    >
        <!-- 表頭 -->
        <view v-if="showHeader" class="uv3__table-thead" :style="{'background': headerBackground}">
            <view
                v-for="(col, cindex) in columns"
                :key="cindex"
                class="uv3__thead-th"
                :class="[
                    {
                        'fixedLeft': col.fixed == true || col.fixed == 'left',
                        'fixedRight': col.fixed == 'right',
                        'fixedLeftShadow': cindex == fixedLeftIndex,
                        'fixedRightShadow': cindex == fixedRightIndex,
                    },
                    col.className || col.class
                ]"
                ...
                @click="handleHeaderClick(col)"
            >
                ...
            </view>
        </view>
        <!-- 表體 -->
        <view class="uv3__table-tbody">
            ...
        </view>
    </view>
</template>

目前uv3-table表格組件作為獨立版本,已經發佈到我的作品集,歡迎去下載使用。

uniapp+vue3增強版自定義表格組件

Props參數

columns參數

  • background 對應列背景色
  • type 對應列類型(多選selection 索引index)
  • label 顯示的列標題
  • prop 對應的列欄位名
  • align 列水平對齊方式(left center right)
  • width 對應列寬度
  • fixed 該列固定到左側(fixed:true|‘left’) 或 右側(fixed:‘right’)
  • columnStyle 對應列自定義樣式
  • className/class 表格列的類名className

事件

  • @headerClick 點擊表頭
  • @rowClick 點擊行觸發
  • @select 多選/單選

自定義插槽

  • headerCell 自定義表頭內容
  • default 預設表體內容
  • empty 無數據插槽

希望以上分享對大家有些幫助,開發不易,一起fighting~~

您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 一、開發卡片頁面 HarmonyOS元服務卡片頁面(Metaservice Card Page)是指在HarmonyOS系統中,用於展示元服務的頁面界面。元服務是指一組提供特定功能或服務的組件,例如天氣服務、音樂播放服務等。元服務卡片頁面可以顯示元服務的相關信息和操作選項,用戶可以通過點擊卡片頁 ...
  • 一、服務卡片的模塊和創建 在HarmonyOS中,服務卡片是一種提供即時信息和快速操作的小組件,類似於Android中的通知欄。服務卡片可以顯示各種類型的信息,包括通知、天氣、日曆事件、音樂播放器、快捷方式等。用戶可以根據自己的需求配置服務卡片,並通過輕掃或點擊來查看詳細信息或執行操作。此外,服 ...
  • 一、是什麼 單點登錄(Single Sign On),簡稱為 SSO,是目前比較流行的企業業務整合的解決方案之一 SSO的定義是在多個應用系統中,用戶只需要登錄一次就可以訪問所有相互信任的應用系統 SSO 一般都需要一個獨立的認證中心(passport),子系統的登錄均得通過passport,子系統 ...
  • 點贊 + 收藏 = 學會! 本篇我們介紹radash中函數柯里化和Number 相關的方法使用和源碼解析。深入學習radash中的方法思想和底層實現。 ...
  • 前言 在之前的 面試官:來說說vue3是怎麼處理內置的v-for、v-model等指令? 文章中講了transform階段處理完v-for、v-model等指令後,會生成一棵javascript AST抽象語法樹。這篇文章我們來接著講generate階段是如何根據這棵javascript AST抽象 ...
  • 在XML Schema(XSD)中,複雜元素包含其他元素和/或屬性,分為4類:空元素、僅含元素、僅含文本和既含元素也含文本。定義複雜元素可通過直接聲明或引用預定義的複雜類型。複雜空元素僅含屬性,而僅含元素的類型則只包含其他子元素。XSD提供了`<xs:sequence>`、`<xs:all>`、`<... ...
  • 一、是什麼 事件代理,俗地來講,就是把一個元素響應事件(click、keydown......)的函數委托到另一個元素 前面講到,事件流的都會經過三個階段: 捕獲階段 -> 目標階段 -> 冒泡階段,而事件委托就是在冒泡階段完成 事件委托,會把一個或者一組元素的事件委托到它的父層或者更外層元素上,真 ...
  • 之前已經出了一篇關於loading動畫的隨筆《博客園美化:給網頁加上loading動畫》,但是每次載入都必須等loading動畫載入完成才能進行下一步點擊,很浪費時間,所以pass掉了...... 這次做了一個頂部的loading進度條,載入的同時不影響瀏覽點擊網頁,並且進度條顏色十分酷炫( 非主流 ...
一周排行
    -Advertisement-
    Play Games
  • 前言 微服務架構已經成為搭建高效、可擴展系統的關鍵技術之一,然而,現有許多微服務框架往往過於複雜,使得我們普通開發者難以快速上手並體驗到微服務帶了的便利。為瞭解決這一問題,於是作者精心打造了一款最接地氣的 .NET 微服務框架,幫助我們輕鬆構建和管理微服務應用。 本框架不僅支持 Consul 服務註 ...
  • 先看一下效果吧: 如果不會寫動畫或者懶得寫動畫,就直接交給Blend來做吧; 其實Blend操作起來很簡單,有點類似於在操作PS,我們只需要設置關鍵幀,滑鼠點來點去就可以了,Blend會自動幫我們生成我們想要的動畫效果. 第一步:要創建一個空的WPF項目 第二步:右鍵我們的項目,在最下方有一個,在B ...
  • Prism:框架介紹與安裝 什麼是Prism? Prism是一個用於在 WPF、Xamarin Form、Uno 平臺和 WinUI 中構建鬆散耦合、可維護和可測試的 XAML 應用程式框架 Github https://github.com/PrismLibrary/Prism NuGet htt ...
  • 在WPF中,屏幕上的所有內容,都是通過畫筆(Brush)畫上去的。如按鈕的背景色,邊框,文本框的前景和形狀填充。藉助畫筆,可以繪製頁面上的所有UI對象。不同畫筆具有不同類型的輸出( 如:某些畫筆使用純色繪製區域,其他畫筆使用漸變、圖案、圖像或繪圖)。 ...
  • 前言 嗨,大家好!推薦一個基於 .NET 8 的高併發微服務電商系統,涵蓋了商品、訂單、會員、服務、財務等50多種實用功能。 項目不僅使用了 .NET 8 的最新特性,還集成了AutoFac、DotLiquid、HangFire、Nlog、Jwt、LayUIAdmin、SqlSugar、MySQL、 ...
  • 本文主要介紹攝像頭(相機)如何採集數據,用於類似攝像頭本地顯示軟體,以及流媒體數據傳輸場景如傳屏、視訊會議等。 攝像頭採集有多種方案,如AForge.NET、WPFMediaKit、OpenCvSharp、EmguCv、DirectShow.NET、MediaCaptre(UWP),網上一些文章以及 ...
  • 前言 Seal-Report 是一款.NET 開源報表工具,擁有 1.4K Star。它提供了一個完整的框架,使用 C# 編寫,最新的版本採用的是 .NET 8.0 。 它能夠高效地從各種資料庫或 NoSQL 數據源生成日常報表,並支持執行複雜的報表任務。 其簡單易用的安裝過程和直觀的設計界面,我們 ...
  • 背景需求: 系統需要對接到XXX官方的API,但因此官方對接以及管理都十分嚴格。而本人部門的系統中包含諸多子系統,系統間為了穩定,程式間多數固定Token+特殊驗證進行調用,且後期還要提供給其他兄弟部門系統共同調用。 原則上:每套系統都必須單獨接入到官方,但官方的接入複雜,還要官方指定機構認證的證書 ...
  • 本文介紹下電腦設備關機的情況下如何通過網路喚醒設備,之前電源S狀態 電腦Power電源狀態- 唐宋元明清2188 - 博客園 (cnblogs.com) 有介紹過遠程喚醒設備,後面這倆天瞭解多了點所以單獨加個隨筆 設備關機的情況下,使用網路喚醒的前提條件: 1. 被喚醒設備需要支持這WakeOnL ...
  • 前言 大家好,推薦一個.NET 8.0 為核心,結合前端 Vue 框架,實現了前後端完全分離的設計理念。它不僅提供了強大的基礎功能支持,如許可權管理、代碼生成器等,還通過採用主流技術和最佳實踐,顯著降低了開發難度,加快了項目交付速度。 如果你需要一個高效的開發解決方案,本框架能幫助大家輕鬆應對挑戰,實 ...