Skip to content

luoxifeng/vue-swipertab

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Vue-SwiperTab

基于Vue的,支滑动过渡的tab切组件

Screenshots

  1. slidable (支持滑动,过渡,支持滑到一定位置,大于一定速度时自动滑动到下一项) slidable
  2. disable slide (禁止滑动以及动画过渡,简单的用法就是显示隐藏) disable slide

Usage

demo.vue

<template>
    <swiper-tab animate v-model="active">
        <swiper-tab-header>
            <swiper-tab-item>
                tab1标题
            </swiper-tab-item>
            <swiper-tab-item>
                tab2标题
            </swiper-tab-item>
            <swiper-tab-item>
                tab3标题
            </swiper-tab-item>
        </swiper-tab-header>
        <swiper-tab-body>
            <swiper-tab-item>
                tab1内容
            </swiper-tab-item>
            <swiper-tab-item>
                tab2内容
            </swiper-tab-item>
            <swiper-tab-item>
                tab3内容
            </swiper-tab-item>
        </swiper-tab-body>
    <swiper-tab>
</template>
import { SwiperTab, SwiperTabHeader, SwiperTabBody, SwiperTabItem } from "../components/swiper-tab"
export {
    data(){
        return {
           active: 1
        }
    },
    components: {
        SwiperTab, 
        SwiperTabHeader, 
        SwiperTabBody, 
        SwiperTabItem
    }
}

Settings

属性 用法说明 可选类型 可设置的值 默认值 依赖的属性 影响的属性 其他说明
wrapperCls 最外层容器的自定义样式class String 样式class "" 用来覆盖默认样式,允许用户自定义样式
show 设置组件显示隐藏 Boolean true, false true 允许用户在组件外部控制组件显示隐藏
slidable 设置内容区域是否可滑动 Boolean true, false false animate 当设置了slidable时,会覆盖animate属性,因为可以滑动的前提必须要启动动画设置
synctab 同步滑动改变tab的active状态 Boolean true, false false slidable 设置header区域的tab,是否根据内容滑动实时变化active状态
animate 启动动画过渡效果 Boolean true, false false 设置此属性点击header区域的tab内容会出现滑动的效果
value 初始化显示第几个 Number 0, 1....等tab索引值 0 从0开始, 默认第一个,使用的时候建议使用v-model="x",这样组件外部,用户可以获取到当前是显示的是第几个
speed tab切换一次,动画耗时 Number, String 100, 300等数字,或者可以转换成数字的字符串单位为毫秒 300 animate, slidable 此属性依赖动画,所以必须设置animateslidable启动动画,如没有设置动画,则属性会被忽略
distance 自动切换最小位置 Number, String 0.1, 0.6等在大于0,小于1的数字,或者可以转换成数字的字符串 0.5 slidable 0.5表示在可以滑动的基础上,内容区域滑动到容器的一半时,内容区域会自动滑向下一个tab,在使用此属性时,必须先设置slidable,让内容区域可以滑动,当没有设置slidable,此属性会被忽略
closebtn 显示关闭按钮 Boolean, String true,false,字符串 false 设置为布尔值的时候,或者经过trim以后为空的字符串,使用默认样式x的圆形关闭按钮;设置为非空字符串,展示一个长方形的带传入文案的按钮
cursor 启用header区域游标 Boolean, String true,false,可以表示颜色值字符串 false synccursor 当设置为布尔值true空字符串的时候,启动默认样式的游标;设置为表示颜色值的字符串(如 red,#eee, rgba, rgb等),则游标的颜色为设置的颜色, 若想更大程度的自定义,组件内部样式,可设置wrapperCls属性,进行自定义样式设置,同时这个属性和slidable影响synccursor属性,因为只有启动了游标,才可以设置同步移动的游标,不过默认游标就是同步的,如果不禁用同步移动,synccursor就可以不用设置了
synccursor 同步移动的游标 Boolean true,false true slidable, cursor 使用这个属性可以在滑动的时候,游标也跟着移动,效果同synctab,就是在滑动到设置的distance边界位置时,游标的中心会指向下一个tab,本属性依赖slidable(可滑动属性),同时也依赖cursor(启动游标的属性)
indicator 启动位置指示器 Boolean,Array true,false, [] false 此属性用来设置指示器,当设置为true时,使用默认样式,当设置我一个数组时,数组里面的文案会呈现出来
indicatorSwitch 指示器操作切换 Boolean true,false false indicatorhoverSwitch 首先设置 indicator ,启动了指示器。此属性用来设置指示器的每一项是否可以通过点击或者hover来切换tab,当设置为true时,默认是通过点击来切换,但是当设置了hoverSwitch后变成hover切换,但是这种情况只适用于pc端,手机端没有鼠标事件,所以在手机端会退回到点击模式
hoverSwitch hover操作切换 Boolean true,false false indicatorSwitch 设置了此属性后原本点击header区域的tab切换变成了hover切换,indicatorSwitch属性设置的点击指示器切换也变成了hover切换,此属性只在pc上有效果,原因是手机端没有鼠标事件,在手机上使用此属性,会被忽略,退回到点击切换