212 lines
9.3 KiB
JavaScript
212 lines
9.3 KiB
JavaScript
// styleIsolation：组件样式隔离方式，具体配置选项参见：微信小程序自定义组件的样式
|
||
// 自定义组件 JSON 中的 styleIsolation 选项从基础库版本 2.10.1 开始支持。它支持以下取值：
|
||
// isolated 表示启用样式隔离，在自定义组件内外，使用 class 指定的样式将不会相互影响（一般情况下的默认值）；
|
||
// apply-shared 表示页面 wxss 样式将影响到自定义组件，但自定义组件 wxss 中指定的样式不会影响页面；
|
||
// shared 表示页面 wxss 样式将影响到自定义组件，自定义组件 wxss 中指定的样式也会影响页面和其他设置了 apply-shared 或 shared 的自定义组件。（这个选项在插件中不可用。）
|
||
|
||
const options = {
|
||
styleIsolation: 'shared',
|
||
virtualHost: true // [微信小程序、支付宝小程序（默认值为 true）] 将自定义节点设置成虚拟的，更加接近Vue组件的表现。我们不希望自定义组件的这个节点本身可以设置样式、响应 flex 布局等，而是希望自定义组件内部的第一层节点能够响应 flex 布局或者样式由自定义组件本身完全决定
|
||
// 微信（可以使用virtualHost配置）/QQ/百度/字节跳动这四家小程序，自定义组件在渲染时会比App/H5端多一级节点，导致flex无效，是否考虑在组件上增加class控制
|
||
}
|
||
|
||
|
||
|
||
const emits = [
|
||
"input",
|
||
'update:modelValue', // 更新v-model绑定的变量
|
||
'click', //点击标签时触发 回调参数：name：标识符，title：标题
|
||
'change', //当前激活的标签改变时触发 回调参数：name：标识符，title：标题
|
||
'disabled', //点击被禁用的标签时触发 回调参数：name：标识符，title：标题
|
||
'rendered', //标签内容首次渲染时触发（仅在开启延迟渲染后触发） 回调参数：name：标识符，title：标题
|
||
'sticky-change', //吸顶时触发，仅在 sticky 模式下生效 回调参数：name：标识符，title：标题
|
||
'loaded', //组件内部初始化完成后调用 回调参数：{ isFixed: 是否吸顶 }
|
||
'slide-change', //内容页滑动时触发（仅barAnimateMode为linear、worm、worm-ease时有效） 回调参数：{ dx：滑动距离； rate：当前滑动长度占滑动区域的比例；targetIndex：目标下标；}
|
||
'slide-end' //内容页滑动结束时触发（仅barAnimateMode为linear、worm、worm-ease时有效） 回调参数：{ targetIndex：目标下标；}
|
||
];
|
||
|
||
const props = {
|
||
// v-model绑定属性，绑定当前选中标签的标识符（标签的下标）
|
||
value: {
|
||
type: [Number, String],
|
||
default: 0,
|
||
},
|
||
modelValue: {
|
||
type: [Number, String],
|
||
default: 0,
|
||
},
|
||
// 样式风格类型，可选值为 text、card、button、line-button
|
||
type: {
|
||
type: String,
|
||
default: "line",
|
||
validator(value) {
|
||
return ['line', 'text', 'card', 'button', 'line-button'].includes(value)
|
||
}
|
||
},
|
||
color: {
|
||
type: [String, null],
|
||
default: "#0022AB"
|
||
}, //标签主题色, 默认值为"#0022AB"
|
||
background: {
|
||
type: [String, null],
|
||
// default: "#fff"
|
||
}, //标签栏背景色,默认值为"#fff"
|
||
// 标签栏样式
|
||
wrapStyle: {
|
||
type: [Object, null],
|
||
default: () => {}
|
||
},
|
||
// 标签栏的展示方位,可选值：vertical。
|
||
direction: {
|
||
type: String,
|
||
default: "horizontal",
|
||
validator(value) {
|
||
return ['horizontal', 'vertical'].includes(value)
|
||
}
|
||
},
|
||
titleActiveColor: String, //标题选中态颜色
|
||
titleInactiveColor: String, //标题默认态颜色
|
||
// 是否开启左侧收缩布局,开启后，所有的标签会向左侧收缩对齐。
|
||
shrink: {
|
||
type: Boolean,
|
||
default: false
|
||
},
|
||
|
||
// 动画时间，单位秒，默认为0.3s。仅支持type为line、button、line-button的滑块切换动画，切换标签内容时的转场动画、滚动导航下的内容定位动画。
|
||
duration: {
|
||
type: [Number, String],
|
||
default: 0.2,
|
||
},
|
||
// 滑块宽度，默认单位为px, 支持数字、rpx、vh、vw等单位及calc() 函数。 仅支持type为line、button、line-button。
|
||
// 标签栏水平/垂直展示时,type为line,宽度默认为20px/3px, 而type为button、line-button时,宽度默认为选中标签宽度-8px。
|
||
barWidth: [Number, String], //inherit：继承tab的宽高
|
||
// 滑块高度，默认单位为px, 支持数字、rpx、vh、vw等单位及calc() 函数。 仅支持type为line、button、line-button。
|
||
// 标签栏水平/垂直展示时,type为line,高度默认为3px/20px, 而type为button、line-button时,宽度默认为选中标签高度-8px。
|
||
barHeight: [Number, String],
|
||
//滑块样式，仅支持type为line、button、line-button。
|
||
barStyle: Object,
|
||
// 滑动切换tab内容时滑块的动画模式，默认值为line，即切换tab时滑块宽度保持不变，线性运动。可选值为worm(毛毛虫效果)、worm-ease(毛毛虫缓动)、none(不设置)。
|
||
// 可结合swiper组件使用，滑动效果更好。
|
||
// 仅支持type为line。
|
||
barAnimateMode: {
|
||
type: String,
|
||
default: "linear",
|
||
validator(value) {
|
||
return ['none', 'linear', 'worm', 'worm-ease'].includes(value);
|
||
}
|
||
},
|
||
// 标签宽高是否动态变化
|
||
// 表示标签切换了选中状态后宽高是否有变化，有则需要开启该属性，否则会导致滑块错位
|
||
isDynamic: {
|
||
type: Boolean,
|
||
default: false,
|
||
},
|
||
// 是否省略过长的标题文字。标签栏水平展示时，如果标签数量未超过滚动阈值则生效，垂直展示不限制。
|
||
ellipsis: {
|
||
type: Boolean,
|
||
default: true,
|
||
},
|
||
// 滚动阈值，标签数量超过阈值且总宽度超过标签栏宽度时开始横向滚动
|
||
scrollThreshold: {
|
||
type: [Number, String],
|
||
default: 5
|
||
},
|
||
// 标签栏滚动时当前标签居中
|
||
scrollToCenter: {
|
||
type: Boolean,
|
||
default: true,
|
||
},
|
||
// 切换标签前的回调函数，返回 false 可阻止切换，支持返回 Promise
|
||
beforeChange: Function,
|
||
// 是否开启延迟渲染（首次切换到标签时才触发内容渲染）
|
||
isLazyRender: Boolean,
|
||
// 是否开启切换动画
|
||
// 用于标签栏滚动动画、切换标签内容时的转场动画、滚动导航下的内容定位动画
|
||
animated: {
|
||
type: Boolean,
|
||
default: true
|
||
},
|
||
// 在滚动导航模式下，滚动到最后一个标签内容但其顶部未超过可视区域时，是否激活对应的标签项
|
||
activeLast: {
|
||
type: Boolean,
|
||
default: false,
|
||
},
|
||
// ---------------------------------- 用于内容区域左右滑动的配置 ----------------------------------------
|
||
// 是否开启手势滑动切换
|
||
swipeable: {
|
||
type: Boolean,
|
||
default: false,
|
||
},
|
||
// 是否开启标签内容滑动时的拖动动画
|
||
// swipeable为true时有效，建议设置is-lazy-render=false。（该属性开启时考虑给包裹内容的容器增加一个min-height，因为其他未显示的标签内容会沿用当前显示的高度，拖动切换后由于高度不一致会有回弹）
|
||
swipeAnimated: {
|
||
type: Boolean,
|
||
default: true,
|
||
},
|
||
// 滑动切换的滑动距离阈值，单位为px；表示开启手势滑动时，横向滑动多少px切换标签内容（快速滑动时不受限制）
|
||
swipeThreshold: {
|
||
type: [Number, String],
|
||
default: 120,
|
||
},
|
||
// ---------------------------------- 用于滚动吸顶的配置 ----------------------------------------
|
||
// 是否使用粘性定位布局进行滚动吸顶
|
||
sticky: Boolean,
|
||
// 粘性布局下与顶部的最小距离，单位为px
|
||
offsetTop: {
|
||
type: [Number, String],
|
||
default: 0
|
||
},
|
||
// 粘性布局下标签栏的z-index值
|
||
zIndex: {
|
||
type: [Number, String],
|
||
default: 99
|
||
},
|
||
// 粘性布局的判断阈值：表示在页面滚动过程中,标签栏距屏幕顶部多少px时，触发吸顶函数进行吸顶判断
|
||
stickyThreshold: {
|
||
type: [Number, String],
|
||
default: 0
|
||
},
|
||
// 页面滚动过程中,标题栏背景色是否透明渐变
|
||
// background属性值必须为rgba格式
|
||
transparent: {
|
||
type: Boolean,
|
||
default: false
|
||
},
|
||
// 标题栏背景色透明渐变的滚动距离
|
||
transparentOffset: {
|
||
type: [Number, String],
|
||
default: 100
|
||
},
|
||
// 是否开启滚动导航；该模式下，内容将会平铺展示
|
||
// 如果标签栏垂直展示，且内容平铺展示，就为侧边栏模式
|
||
scrollspy: Boolean,
|
||
// 滚动导航模式下，内容区域是否跟随页面滚动
|
||
// 为true时，整体区域跟随页面而滚动，为false时，内容区域是放在scroll-view中实现的局部滚动
|
||
pageScroll: {
|
||
type: Boolean,
|
||
default: true
|
||
},
|
||
}
|
||
export {
|
||
options,
|
||
emits,
|
||
props,
|
||
}
|
||
|
||
|
||
|
||
// 验证各端小程序是否兼容（快手使用ks+18位数字当测试的appid） ✔
|
||
// 毛毛虫蠕动动效 ✔
|
||
// swpier组件切换内容 ✔
|
||
// 增加u-popup里嵌套的案例 ✔
|
||
// 鼠标滚轮滚动释放锁 ✔
|
||
// 滑动距离超过阈值时切换tab样式，类似于各大网站标签页切换时tab颜色、字体大小会变化、过渡 ✔
|
||
// 是否滑动切换的时候提供slide-change、slide-end事件，滑动过程中锁住scroll-view的上下滑动 ✔
|
||
// swipe-threshold兼容bar-animate-mode为worm、worm-ease ✔
|
||
// barWidth增加auto值，自适应标签宽度 ✔
|
||
|
||
// 提供slotTitle prop以供只渲染标签栏，而非内容区域，这样可以避开vue3下小程序端循环生成标签项的嵌套插槽无法自定义标签的问题（vue3下部分小程序对具名的作用域插槽支持度不好，暂不考虑）
|
||
// 用户反映select-picker被遮挡：下拉区域使用absolute，被内容区域的overflow所裁剪，除非select组件使用fixed定位
|
||
|
||
// 考虑支持nvue
|
||
// barWidth增加auto值，自适应标签宽度
|