mixin.js 7.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163
  1. export default {
  2. // 定义每个组件都可能需要用到的外部样式以及类名
  3. props: {
  4. // 每个组件都有的父组件传递的样式,可以为字符串或者对象形式
  5. customStyle: {
  6. type: [Object, String],
  7. default: () => ({})
  8. },
  9. customClass: {
  10. type: String,
  11. default: ''
  12. },
  13. // 跳转的页面路径
  14. url: {
  15. type: String,
  16. default: ''
  17. },
  18. // 页面跳转的类型
  19. linkType: {
  20. type: String,
  21. default: 'navigateTo'
  22. }
  23. },
  24. data() {
  25. return {}
  26. },
  27. onLoad() {
  28. // getRect挂载到$u上,因为这方法需要使用in(this),所以无法把它独立成一个单独的文件导出
  29. this.$u.getRect = this.$uGetRect
  30. },
  31. created() {
  32. // 组件当中,只有created声明周期,为了能在组件使用,故也在created中将方法挂载到$u
  33. this.$u.getRect = this.$uGetRect
  34. },
  35. computed: {
  36. // 在2.x版本中,将会把$u挂载到uni对象下,导致在模板中无法使用uni.$u.xxx形式
  37. // 所以这里通过computed计算属性将其附加到this.$u上,就可以在模板或者js中使用uni.$u.xxx
  38. // 只在nvue环境通过此方式引入完整的$u,其他平台会出现性能问题,非nvue则按需引入(主要原因是props过大)
  39. $u() {
  40. // #ifndef APP-NVUE
  41. // 在非nvue端,移除props,http,mixin等对象,避免在小程序setData时数据过大影响性能
  42. return uni.$u.deepMerge(uni.$u, {
  43. props: undefined,
  44. http: undefined,
  45. mixin: undefined
  46. })
  47. // #endif
  48. // #ifdef APP-NVUE
  49. return uni.$u
  50. // #endif
  51. },
  52. /**
  53. * 生成bem规则类名
  54. * 由于微信小程序,H5,nvue之间绑定class的差异,无法通过:class="[bem()]"的形式进行同用
  55. * 故采用如下折中做法,最后返回的是数组(一般平台)或字符串(支付宝和字节跳动平台),类似['a', 'b', 'c']或'a b c'的形式
  56. * @param {String} name 组件名称
  57. * @param {Array} fixed 一直会存在的类名
  58. * @param {Array} change 会根据变量值为true或者false而出现或者隐藏的类名
  59. * @returns {Array|string}
  60. */
  61. bem() {
  62. return function (name, fixed, change) {
  63. // 类名前缀
  64. const prefix = `u-${name}--`
  65. const classes = {}
  66. if (fixed) {
  67. fixed.map((item) => {
  68. // 这里的类名,会一直存在
  69. classes[prefix + this[item]] = true
  70. })
  71. }
  72. if (change) {
  73. change.map((item) => {
  74. // 这里的类名,会根据this[item]的值为true或者false,而进行添加或者移除某一个类
  75. this[item] ? (classes[prefix + item] = this[item]) : (delete classes[prefix + item])
  76. })
  77. }
  78. return Object.keys(classes)
  79. // 支付宝,头条小程序无法动态绑定一个数组类名,否则解析出来的结果会带有",",而导致失效
  80. // #ifdef MP-ALIPAY || MP-TOUTIAO || MP-LARK
  81. .join(' ')
  82. // #endif
  83. }
  84. }
  85. },
  86. methods: {
  87. // 跳转某一个页面
  88. openPage(urlKey = 'url') {
  89. const url = this[urlKey]
  90. if (url) {
  91. // h5官方回应:发行h5会自动摇树优化,所有使用uni的地方,都会被直接转换成具体的API调用 https://ask.dcloud.net.cn/question/161523?notification_id-1201922__rf-false__item_id-226372
  92. // 使用封装的 route 进行跳转(直接调用方法),不使用 uni 对象
  93. this.$u.route({ type: this.linkType, url })
  94. // 执行类似uni.navigateTo的方法
  95. // uni[this.linkType]({
  96. // url
  97. // })
  98. }
  99. },
  100. // 查询节点信息
  101. // 目前此方法在支付宝小程序中无法获取组件跟接点的尺寸,为支付宝的bug(2020-07-21)
  102. // 解决办法为在组件根部再套一个没有任何作用的view元素
  103. $uGetRect(selector, all) {
  104. return new Promise((resolve) => {
  105. uni.createSelectorQuery()
  106. .in(this)[all ? 'selectAll' : 'select'](selector)
  107. .boundingClientRect((rect) => {
  108. if (all && Array.isArray(rect) && rect.length) {
  109. resolve(rect)
  110. }
  111. if (!all && rect) {
  112. resolve(rect)
  113. }
  114. })
  115. .exec()
  116. })
  117. },
  118. getParentData(parentName = '') {
  119. // 避免在created中去定义parent变量
  120. if (!this.parent) this.parent = {}
  121. // 这里的本质原理是,通过获取父组件实例(也即类似u-radio的父组件u-radio-group的this)
  122. // 将父组件this中对应的参数,赋值给本组件(u-radio的this)的parentData对象中对应的属性
  123. // 之所以需要这么做,是因为所有端中,头条小程序不支持通过this.parent.xxx去监听父组件参数的变化
  124. // 此处并不会自动更新子组件的数据,而是依赖父组件u-radio-group去监听data的变化,手动调用更新子组件的方法去重新获取
  125. this.parent = uni.$u.$parent.call(this, parentName)
  126. if (this.parent.children) {
  127. // 如果父组件的children不存在本组件的实例,才将本实例添加到父组件的children中
  128. this.parent.children.indexOf(this) === -1 && this.parent.children.push(this)
  129. }
  130. if (this.parent && this.parentData) {
  131. // 历遍parentData中的属性,将parent中的同名属性赋值给parentData
  132. Object.keys(this.parentData).map((key) => {
  133. this.parentData[key] = this.parent[key]
  134. })
  135. }
  136. },
  137. // 阻止事件冒泡
  138. preventEvent(e) {
  139. e && typeof (e.stopPropagation) === 'function' && e.stopPropagation()
  140. },
  141. // 空操作
  142. noop(e) {
  143. this.preventEvent(e)
  144. }
  145. },
  146. onReachBottom() {
  147. uni.$emit('uOnReachBottom')
  148. },
  149. beforeDestroy() {
  150. // 判断当前页面是否存在parent和chldren,一般在checkbox和checkbox-group父子联动的场景会有此情况
  151. // 组件销毁时,移除子组件在父组件children数组中的实例,释放资源,避免数据混乱
  152. if (this.parent && uni.$u.test.array(this.parent.children)) {
  153. // 组件销毁时,移除父组件中的children数组中对应的实例
  154. const childrenList = this.parent.children
  155. childrenList.map((child, index) => {
  156. // 如果相等,则移除
  157. if (child === this) {
  158. childrenList.splice(index, 1)
  159. }
  160. })
  161. }
  162. }
  163. }