扩展组件(uni-ui)之uni-swipe-action

519 阅读1分钟

uni-swipe-action 是 uni-app 的 uni-ui 组件库中的一个组件,用于创建可滑动操作的列表项。这种组件常用于实现像邮件应用中的侧滑删除功能,允许用户通过滑动列表项来显示更多操作选项,如删除、收藏、标记等。

基本用法

在使用 uni-swipe-action 之前,你需要确保已经正确安装了 uni-ui 库,并在页面中引入了 uni-swipe-actionuni-swipe-action-item 组件。

引入组件

<template>
    <uni-swipe-action>
        <uni-swipe-action-item 
            @click="onItemClick" 
            @change="onItemChange"
            :options="swipeOptions">
            这里是列表项内容
        </uni-swipe-action-item>
    </uni-swipe-action>
</template>

<script>
    import uniSwipeAction from '@dcloudio/uni-ui/lib/uni-swipe-action/uni-swipe-action.vue'
    import uniSwipeActionItem from '@dcloudio/uni-ui/lib/uni-swipe-action-item/uni-swipe-action-item.vue'

    export default {
        components: { uniSwipeAction, uniSwipeActionItem },
        data() {
            return {
                swipeOptions: [
                    {
                        text: '选项1',
                        style: { backgroundColor: '#007aff' }
                    },
                    {
                        text: '选项2',
                        style: { backgroundColor: '#dd524d' }
                    }
                ]
            }
        },
        methods: {
            onItemClick(item) {
                console.log('点击了操作项', item);
            },
            onItemChange(e) {
                console.log('侧滑状态改变', e);
            }
        }
    }
</script>

属性

  • uni-swipe-action 组件本身不带有特殊的属性。
  • uni-swipe-action-item 的主要属性包括:
    • options:数组,定义侧滑时出现的操作项,每个操作项是一个对象,包含 textstyle 等字段。

事件

  • click:点击操作项时触发的事件。
  • change:侧滑状态改变时触发的事件。

示例

创建一个带有侧滑操作的列表项:

<uni-swipe-action>
    <uni-swipe-action-item 
        :options="swipeOptions" 
        @click="onItemClick">
        列表项内容
    </uni-swipe-action-item>
</uni-swipe-action>

注意事项

  • 每个 uni-swipe-action-item 都可以定义自己的侧滑操作选项。
  • options 属性中的每个对象代表一个侧滑操作项,你可以自定义文本、样式等。
  • 通过监听 clickchange 事件来处理用户的操作和响应侧滑状态的改变。

更多关于 uni-swipe-action 组件的使用细节,可以查阅 uni-ui 官方文档 或 uni-ui 库的相关文档。