v1.0
This commit is contained in:
hupeng
7
uni_modules/uv-sticky/changelog.md
Normal file
7
uni_modules/uv-sticky/changelog.md
Normal file
@ -0,0 +1,7 @@
|
||||
## 1.0.2（2023-08-27）
|
||||
1. 优化
|
||||
## 1.0.1（2023-05-16）
|
||||
1. 优化组件依赖，修改后无需全局引入，组件导入即可使用
|
||||
2. 优化部分功能
|
||||
## 1.0.0（2023-05-10）
|
||||
uv-sticky 吸顶
|
||||
41
uni_modules/uv-sticky/components/uv-sticky/props.js
Normal file
41
uni_modules/uv-sticky/components/uv-sticky/props.js
Normal file
@ -0,0 +1,41 @@
|
||||
export default {
|
||||
props: {
|
||||
// 吸顶容器到顶部某个距离的时候，进行吸顶，在H5平台，NavigationBar为44px
|
||||
offsetTop: {
|
||||
type: [String, Number],
|
||||
default: 0
|
||||
},
|
||||
// 自定义导航栏的高度
|
||||
customNavHeight: {
|
||||
type: [String, Number],
|
||||
// #ifdef H5
|
||||
// H5端的导航栏属于“自定义”导航栏的范畴，因为它是非原生的，与普通元素一致
|
||||
default: 44,
|
||||
// #endif
|
||||
// #ifndef H5
|
||||
default: 0
|
||||
// #endif
|
||||
},
|
||||
// 是否禁用吸顶功能
|
||||
disabled: {
|
||||
type: Boolean,
|
||||
default: false
|
||||
},
|
||||
// 吸顶区域的背景颜色
|
||||
bgColor: {
|
||||
type: String,
|
||||
default: 'transparent'
|
||||
},
|
||||
// z-index值
|
||||
zIndex: {
|
||||
type: [String, Number],
|
||||
default: ''
|
||||
},
|
||||
// 列表中的索引值
|
||||
index: {
|
||||
type: [String, Number],
|
||||
default: ''
|
||||
},
|
||||
...uni.$uv?.props?.sticky
|
||||
}
|
||||
}
|
||||
216
uni_modules/uv-sticky/components/uv-sticky/uv-sticky.vue
Normal file
216
uni_modules/uv-sticky/components/uv-sticky/uv-sticky.vue
Normal file
@ -0,0 +1,216 @@
|
||||
<template>
|
||||
<view
|
||||
class="uv-sticky"
|
||||
:id="elId"
|
||||
:style="[style]"
|
||||
>
|
||||
<view
|
||||
:style="[stickyContent]"
|
||||
class="uv-sticky__content"
|
||||
>
|
||||
<slot />
|
||||
</view>
|
||||
</view>
|
||||
</template>
|
||||
|
||||
<script>
|
||||
import mpMixin from '@/uni_modules/uv-ui-tools/libs/mixin/mpMixin.js'
|
||||
import mixin from '@/uni_modules/uv-ui-tools/libs/mixin/mixin.js'
|
||||
import props from './props.js';;
|
||||
/**
|
||||
* sticky 吸顶
|
||||
* @description 该组件与CSS中position: sticky属性实现的效果一致，当组件达到预设的到顶部距离时， 就会固定在指定位置，组件位置大于预设的顶部距离时，会重新按照正常的布局排列。
|
||||
* @tutorial https://www.uvui.cn/components/sticky.html
|
||||
* @property {String ｜ Number} offsetTop 吸顶时与顶部的距离，单位px（默认 0 ）
|
||||
* @property {String ｜ Number} customNavHeight 自定义导航栏的高度 （h5 默认44 其他默认 0 ）
|
||||
* @property {Boolean} disabled 是否开启吸顶功能 （默认 false ）
|
||||
* @property {String} bgColor 组件背景颜色（默认 '#ffffff' ）
|
||||
* @property {String ｜ Number} zIndex 吸顶时的z-index值
|
||||
* @property {String ｜ Number} index 自定义标识，用于区分是哪一个组件
|
||||
* @property {Object} customStyle 组件的样式，对象形式
|
||||
* @example <uv-sticky offsetTop="200"><view>塞下秋来风景异，衡阳雁去无留意</view></uv-sticky>
|
||||
*/
|
||||
export default {
|
||||
name: 'uv-sticky',
|
||||
mixins: [mpMixin, mixin, props],
|
||||
data() {
|
||||
return {
|
||||
cssSticky: false, // 是否使用css的sticky实现
|
||||
stickyTop: 0, // 吸顶的top值，因为可能受自定义导航栏影响，最终的吸顶值非offsetTop值
|
||||
elId: '',
|
||||
left: 0, // js模式时，吸顶的内容因为处于postition: fixed模式，为了和原来保持一致的样式，需要记录并重新设置它的left，height，width属性
|
||||
width: 'auto',
|
||||
height: 'auto',
|
||||
fixed: false, // js模式时，是否处于吸顶模式
|
||||
}
|
||||
},
|
||||
computed: {
|
||||
style() {
|
||||
const style = {}
|
||||
if(!this.disabled) {
|
||||
if (this.cssSticky) {
|
||||
style.position = 'sticky'
|
||||
style.zIndex = this.uZindex
|
||||
style.top = this.$uv.addUnit(this.stickyTop)
|
||||
} else {
|
||||
style.height = this.fixed ? this.height + 'px' : 'auto'
|
||||
}
|
||||
} else {
|
||||
// 无需吸顶时，设置会默认的relative(nvue)和非nvue的static静态模式即可
|
||||
// #ifdef APP-NVUE
|
||||
style.position = 'relative'
|
||||
// #endif
|
||||
// #ifndef APP-NVUE
|
||||
style.position = 'static'
|
||||
// #endif
|
||||
}
|
||||
style.backgroundColor = this.bgColor
|
||||
return this.$uv.deepMerge(this.$uv.addStyle(this.customStyle), style)
|
||||
},
|
||||
// 吸顶内容的样式
|
||||
stickyContent() {
|
||||
const style = {}
|
||||
if (!this.cssSticky) {
|
||||
style.position = this.fixed ? 'fixed' : 'static'
|
||||
style.top = this.stickyTop + 'px'
|
||||
style.left = this.left + 'px'
|
||||
style.width = this.width == 'auto' ? 'auto' : this.width + 'px'
|
||||
style.zIndex = this.uZindex
|
||||
}
|
||||
return style
|
||||
},
|
||||
uZindex() {
|
||||
return this.zIndex ? this.zIndex : 970
|
||||
}
|
||||
},
|
||||
created() {
|
||||
this.elId = this.$uv.guid();
|
||||
},
|
||||
mounted() {
|
||||
this.init()
|
||||
},
|
||||
methods: {
|
||||
init() {
|
||||
this.getStickyTop()
|
||||
// 判断使用的模式
|
||||
this.checkSupportCssSticky()
|
||||
// 如果不支持css sticky，则使用js方案，此方案性能比不上css方案
|
||||
if (!this.cssSticky) {
|
||||
!this.disabled && this.initObserveContent()
|
||||
}
|
||||
},
|
||||
initObserveContent() {
|
||||
// 获取吸顶内容的高度，用于在js吸顶模式时，给父元素一个填充高度，防止"塌陷"
|
||||
this.$uvGetRect('#' + this.elId).then((res) => {
|
||||
this.height = res.height
|
||||
this.left = res.left
|
||||
this.width = res.width
|
||||
this.$nextTick(() => {
|
||||
this.observeContent()
|
||||
})
|
||||
})
|
||||
},
|
||||
observeContent() {
|
||||
// 先断掉之前的观察
|
||||
this.disconnectObserver('contentObserver')
|
||||
const contentObserver = uni.createIntersectionObserver({
|
||||
// 检测的区间范围
|
||||
thresholds: [0.95, 0.98, 1]
|
||||
})
|
||||
// 到屏幕顶部的高度时触发
|
||||
contentObserver.relativeToViewport({
|
||||
top: -this.stickyTop
|
||||
})
|
||||
// 绑定观察的元素
|
||||
contentObserver.observe(`#${this.elId}`, res => {
|
||||
this.setFixed(res.boundingClientRect.top)
|
||||
})
|
||||
this.contentObserver = contentObserver
|
||||
},
|
||||
setFixed(top) {
|
||||
// 判断是否出于吸顶条件范围
|
||||
const fixed = top <= this.stickyTop
|
||||
this.fixed = fixed
|
||||
},
|
||||
disconnectObserver(observerName) {
|
||||
// 断掉观察，释放资源
|
||||
const observer = this[observerName]
|
||||
observer && observer.disconnect()
|
||||
},
|
||||
getStickyTop() {
|
||||
this.stickyTop = this.$uv.getPx(this.offsetTop) + this.$uv.getPx(this.customNavHeight)
|
||||
},
|
||||
async checkSupportCssSticky() {
|
||||
// #ifdef H5
|
||||
// H5，一般都是现代浏览器，是支持css sticky的，这里使用创建元素嗅探的形式判断
|
||||
if (this.checkCssStickyForH5()) {
|
||||
this.cssSticky = true
|
||||
}
|
||||
// #endif
|
||||
|
||||
// 如果安卓版本高于8.0，依然认为是支持css sticky的(因为安卓7在某些机型，可能不支持sticky)
|
||||
if (this.$uv.os() === 'android' && Number(this.$uv.sys().system) > 8) {
|
||||
this.cssSticky = true
|
||||
}
|
||||
|
||||
// APP-Vue和微信平台，通过computedStyle判断是否支持css sticky
|
||||
// #ifdef APP-VUE || MP-WEIXIN
|
||||
this.cssSticky = await this.checkComputedStyle()
|
||||
// #endif
|
||||
|
||||
// ios上，从ios6开始，都是支持css sticky的
|
||||
if (this.$uv.os() === 'ios') {
|
||||
this.cssSticky = true
|
||||
}
|
||||
|
||||
// nvue，是支持css sticky的
|
||||
// #ifdef APP-NVUE
|
||||
this.cssSticky = true
|
||||
// #endif
|
||||
},
|
||||
// 在APP和微信小程序上，通过uni.createSelectorQuery可以判断是否支持css sticky
|
||||
checkComputedStyle() {
|
||||
// 方法内进行判断，避免在其他平台生成无用代码
|
||||
// #ifdef APP-VUE || MP-WEIXIN
|
||||
return new Promise(resolve => {
|
||||
uni.createSelectorQuery().in(this).select('.uv-sticky').fields({
|
||||
computedStyle: ["position"]
|
||||
}).exec(e => {
|
||||
resolve('sticky' === e[0].position)
|
||||
})
|
||||
})
|
||||
// #endif
|
||||
},
|
||||
// H5通过创建元素的形式嗅探是否支持css sticky
|
||||
// 判断浏览器是否支持sticky属性
|
||||
checkCssStickyForH5() {
|
||||
// 方法内进行判断，避免在其他平台生成无用代码
|
||||
// #ifdef H5
|
||||
const vendorList = ['', '-webkit-', '-ms-', '-moz-', '-o-'],
|
||||
vendorListLength = vendorList.length,
|
||||
stickyElement = document.createElement('div')
|
||||
for (let i = 0; i < vendorListLength; i++) {
|
||||
stickyElement.style.position = vendorList[i] + 'sticky'
|
||||
if (stickyElement.style.position !== '') {
|
||||
return true
|
||||
}
|
||||
}
|
||||
return false;
|
||||
// #endif
|
||||
}
|
||||
},
|
||||
beforeDestroy() {
|
||||
this.disconnectObserver('contentObserver')
|
||||
}
|
||||
}
|
||||
</script>
|
||||
|
||||
<style lang="scss" scoped>
|
||||
@import '@/uni_modules/uv-ui-tools/libs/css/components.scss';
|
||||
.uv-sticky {
|
||||
/* #ifdef APP-VUE || MP-WEIXIN */
|
||||
// 此处默认写sticky属性，是为了给微信和APP通过uni.createSelectorQuery查询是否支持css sticky使用
|
||||
position: sticky;
|
||||
/* #endif */
|
||||
}
|
||||
</style>
|
||||
87
uni_modules/uv-sticky/package.json
Normal file
87
uni_modules/uv-sticky/package.json
Normal file
@ -0,0 +1,87 @@
|
||||
{
|
||||
"id": "uv-sticky",
|
||||
"displayName": "uv-sticky 吸顶 全面兼容小程序、nvue、vue2、vue3等多端",
|
||||
"version": "1.0.2",
|
||||
"description": "吸顶组件与CSS中position: sticky属性实现的效果一致，当组件达到预设的到顶部距离时， 就会固定在指定位置，组件位置大于预设的顶部距离时，会重新按照正常的布局排列。",
|
||||
"keywords": [
|
||||
"uv-sticky",
|
||||
"uvui",
|
||||
"uv-ui",
|
||||
"sticky",
|
||||
"吸顶"
|
||||
],
|
||||
"repository": "",
|
||||
"engines": {
|
||||
"HBuilderX": "^3.1.0"
|
||||
},
|
||||
"dcloudext": {
|
||||
"type": "component-vue",
|
||||
"sale": {
|
||||
"regular": {
|
||||
"price": "0.00"
|
||||
},
|
||||
"sourcecode": {
|
||||
"price": "0.00"
|
||||
}
|
||||
},
|
||||
"contact": {
|
||||
"qq": ""
|
||||
},
|
||||
"declaration": {
|
||||
"ads": "无",
|
||||
"data": "插件不采集任何数据",
|
||||
"permissions": "无"
|
||||
},
|
||||
"npmurl": ""
|
||||
},
|
||||
"uni_modules": {
|
||||
"dependencies": [
|
||||
"uv-ui-tools"
|
||||
],
|
||||
"encrypt": [],
|
||||
"platforms": {
|
||||
"cloud": {
|
||||
"tcb": "y",
|
||||
"aliyun": "y"
|
||||
},
|
||||
"client": {
|
||||
"Vue": {
|
||||
"vue2": "y",
|
||||
"vue3": "y"
|
||||
},
|
||||
"App": {
|
||||
"app-vue": "y",
|
||||
"app-nvue": "y"
|
||||
},
|
||||
"H5-mobile": {
|
||||
"Safari": "y",
|
||||
"Android Browser": "y",
|
||||
"微信浏览器(Android)": "y",
|
||||
"QQ浏览器(Android)": "y"
|
||||
},
|
||||
"H5-pc": {
|
||||
"Chrome": "y",
|
||||
"IE": "y",
|
||||
"Edge": "y",
|
||||
"Firefox": "y",
|
||||
"Safari": "y"
|
||||
},
|
||||
"小程序": {
|
||||
"微信": "y",
|
||||
"阿里": "y",
|
||||
"百度": "y",
|
||||
"字节跳动": "y",
|
||||
"QQ": "y",
|
||||
"钉钉": "u",
|
||||
"快手": "u",
|
||||
"飞书": "u",
|
||||
"京东": "u"
|
||||
},
|
||||
"快应用": {
|
||||
"华为": "u",
|
||||
"联盟": "u"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
11
uni_modules/uv-sticky/readme.md
Normal file
11
uni_modules/uv-sticky/readme.md
Normal file
@ -0,0 +1,11 @@
|
||||
## Sticky 吸顶
|
||||
|
||||
> **组件名：uv-sticky**
|
||||
|
||||
该组件与CSS中position: sticky属性实现的效果一致，当组件达到预设的到顶部距离时， 就会固定在指定位置，组件位置大于预设的顶部距离时，会重新按照正常的布局排列。
|
||||
|
||||
### <a href="https://www.uvui.cn/components/sticky.html" target="_blank">查看文档</a>
|
||||
|
||||
### [完整示例项目下载 | 关注更多组件](https://ext.dcloud.net.cn/plugin?name=uv-ui)
|
||||
|
||||
#### 如使用过程中有任何问题，或者您对uv-ui有一些好的建议，欢迎加入 uv-ui 交流群：<a href="https://ext.dcloud.net.cn/plugin?id=12287" target="_blank">uv-ui</a>、<a href="https://www.uvui.cn/components/addQQGroup.html" target="_blank">官方QQ群</a>
|
||||
Reference in New Issue
Block a user