小程序diamante

jiangping

2023-10-26 627c3e0a6920131d75eafa4646db373ccc936546

 minipro_standard/uni_modules/uview-ui/libs/mixin/mixin.js

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,160 @@
module.exports = {
    // å®šä¹‰æ¯ä¸ªç»„件都可能需要用到的外部样式以及类名
    props: {
        // æ¯ä¸ªç»„件都有的父组件传递的样式，可以为字符串或者对象形式
        customStyle: {
            type: [Object, String],
            default: () => ({})
        },
        customClass: {
            type: String,
            default: ''
        },
        // è·³è½¬çš„页面路径
        url: {
            type: String,
            default: ''
        },
        // é¡µé¢è·³è½¬çš„类型
        linkType: {
            type: String,
            default: 'navigateTo'
        }
    },
    data() {
        return {}
    },
    onLoad() {
        // getRect挂载到$u上，因为这方法需要使用in(this)，所以无法把它独立成一个单独的文件导出
        this.$u.getRect = this.$uGetRect
    },
    created() {
        // ç»„件当中，只有created声明周期，为了能在组件使用，故也在created中将方法挂载到$u
        this.$u.getRect = this.$uGetRect
    },
    computed: {
        // åœ¨2.x版本中，将会把$u挂载到uni对象下，导致在模板中无法使用uni.$u.xxx形式
        // æ‰€ä»¥è¿™é‡Œé€šè¿‡computed计算属性将其附加到this.$u上，就可以在模板或者js中使用uni.$u.xxx
        // åªåœ¨nvue环境通过此方式引入完整的$u，其他平台会出现性能问题，非nvue则按需引入（主要原因是props过大）
        $u() {
            // #ifndef APP-NVUE
            // åœ¨éžnvue端，移除props，http，mixin等对象，避免在小程序setData时数据过大影响性能
            return uni.$u.deepMerge(uni.$u, {
                props: undefined,
                http: undefined,
                mixin: undefined
            })
            // #endif
            // #ifdef APP-NVUE
            return uni.$u
            // #endif
        },
        /**
         * ç”Ÿæˆbem规则类名
         * ç”±äºŽå¾®ä¿¡å°ç¨‹åºï¼ŒH5，nvue之间绑定class的差异，无法通过:class="[bem()]"的形式进行同用
         * æ•…采用如下折中做法，最后返回的是数组（一般平台）或字符串（支付宝和字节跳动平台），类似['a', 'b', 'c']或'a b c'的形式
         * @param {String} name ç»„件名称
         * @param {Array} fixed ä¸€ç›´ä¼šå­˜åœ¨çš„类名
         * @param {Array} change ä¼šæ ¹æ®å˜é‡å€¼ä¸ºtrue或者false而出现或者隐藏的类名
         * @returns {Array|string}
         */
        bem() {
            return function (name, fixed, change) {
                // ç±»åå‰ç¼€
                const prefix = `u-${name}--`
                const classes = {}
                if (fixed) {
                    fixed.map((item) => {
                        // è¿™é‡Œçš„类名，会一直存在
                        classes[prefix + this[item]] = true
                    })
                }
                if (change) {
                    change.map((item) => {
                        // è¿™é‡Œçš„类名，会根据this[item]的值为true或者false，而进行添加或者移除某一个类
                        this[item] ? (classes[prefix + item] = this[item]) : (delete classes[prefix + item])
                    })
                }
                return Object.keys(classes)
                    // æ”¯ä»˜å®ï¼Œå¤´æ¡å°ç¨‹åºæ— æ³•åŠ¨æ€ç»‘定一个数组类名，否则解析出来的结果会带有","，而导致失效
                    // #ifdef MP-ALIPAY || MP-TOUTIAO || MP-LARK
                    .join(' ')
                    // #endif
            }
        }
    },
    methods: {
        // è·³è½¬æŸä¸€ä¸ªé¡µé¢
        openPage(urlKey = 'url') {
            const url = this[urlKey]
            if (url) {
                // æ‰§è¡Œç±»ä¼¼uni.navigateTo的方法
                uni[this.linkType]({
                    url
                })
            }
        },
        // æŸ¥è¯¢èŠ‚点信息
        // ç›®å‰æ­¤æ–¹æ³•åœ¨æ”¯ä»˜å®å°ç¨‹åºä¸­æ— æ³•èŽ·å–组件跟接点的尺寸，为支付宝的bug(2020-07-21)
        // è§£å†³åŠžæ³•ä¸ºåœ¨ç»„件根部再套一个没有任何作用的view元素
        $uGetRect(selector, all) {
            return new Promise((resolve) => {
                uni.createSelectorQuery()
                    .in(this)[all ? 'selectAll' : 'select'](selector)
                    .boundingClientRect((rect) => {
                        if (all && Array.isArray(rect) && rect.length) {
                            resolve(rect)
                        }
                        if (!all && rect) {
                            resolve(rect)
                        }
                    })
                    .exec()
            })
        },
        getParentData(parentName = '') {
            // é¿å…åœ¨created中去定义parent变量
            if (!this.parent) this.parent = {}
            // è¿™é‡Œçš„本质原理是，通过获取父组件实例(也即类似u-radio的父组件u-radio-group的this)
            // å°†çˆ¶ç»„件this中对应的参数，赋值给本组件(u-radio的this)的parentData对象中对应的属性
            // ä¹‹æ‰€ä»¥éœ€è¦è¿™ä¹ˆåšï¼Œæ˜¯å› ä¸ºæ‰€æœ‰ç«¯ä¸­ï¼Œå¤´æ¡å°ç¨‹åºä¸æ”¯æŒé€šè¿‡this.parent.xxx去监听父组件参数的变化
            // æ­¤å¤„并不会自动更新子组件的数据，而是依赖父组件u-radio-group去监听data的变化，手动调用更新子组件的方法去重新获取
            this.parent = uni.$u.$parent.call(this, parentName)
            if (this.parent.children) {
                // å¦‚果父组件的children不存在本组件的实例，才将本实例添加到父组件的children中
                this.parent.children.indexOf(this) === -1 && this.parent.children.push(this)
            }
            if (this.parent && this.parentData) {
                // åŽ†éparentData中的属性，将parent中的同名属性赋值给parentData
                Object.keys(this.parentData).map((key) => {
                    this.parentData[key] = this.parent[key]
                })
            }
        },
        // é˜»æ­¢äº‹ä»¶å†’泡
        preventEvent(e) {
            e && typeof (e.stopPropagation) === 'function' && e.stopPropagation()
        },
        // ç©ºæ“ä½œ
        noop(e) {
            this.preventEvent(e)
        }
    },
    onReachBottom() {
        uni.$emit('uOnReachBottom')
    },
    beforeDestroy() {
        // åˆ¤æ–­å½“前页面是否存在parent和chldren，一般在checkbox和checkbox-group父子联动的场景会有此情况
        // ç»„件销毁时，移除子组件在父组件children数组中的实例，释放资源，避免数据混乱
        if (this.parent && uni.$u.test.array(this.parent.children)) {
            // ç»„件销毁时，移除父组件中的children数组中对应的实例
            const childrenList = this.parent.children
            childrenList.map((child, index) => {
                // å¦‚果相等，则移除
                if (child === this) {
                    childrenList.splice(index, 1)
                }
            })
        }
    }
}