uni-events-helper-wx
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

296 lines
9.5 KiB

3 years ago
  1. <template>
  2. <view
  3. class="u-rate"
  4. :id="elId"
  5. ref="u-rate"
  6. :style="[$u.addStyle(customStyle)]"
  7. >
  8. <view
  9. class="u-rate__content"
  10. @touchmove.stop="touchMove"
  11. @touchend.stop="touchEnd"
  12. >
  13. <view
  14. class="u-rate__content__item"
  15. v-for="(item, index) in Number(count)"
  16. :key="index"
  17. :class="[elClass]"
  18. >
  19. <view
  20. class="u-rate__content__item__icon-wrap"
  21. ref="u-rate__content__item__icon-wrap"
  22. @tap.stop="clickHandler($event, index + 1)"
  23. >
  24. <u-icon
  25. :name="
  26. Math.floor(activeIndex) > index
  27. ? activeIcon
  28. : inactiveIcon
  29. "
  30. :color="
  31. disabled
  32. ? '#c8c9cc'
  33. : Math.floor(activeIndex) > index
  34. ? activeColor
  35. : inactiveColor
  36. "
  37. :custom-style="{
  38. padding: `0 ${$u.addUnit(gutter / 2)}`,
  39. }"
  40. :size="size"
  41. ></u-icon>
  42. </view>
  43. <view
  44. v-if="allowHalf"
  45. @tap.stop="clickHandler($event, index + 1)"
  46. class="u-rate__content__item__icon-wrap u-rate__content__item__icon-wrap--half"
  47. :style="[{
  48. width: $u.addUnit(rateWidth / 2),
  49. }]"
  50. ref="u-rate__content__item__icon-wrap"
  51. >
  52. <u-icon
  53. :name="
  54. Math.ceil(activeIndex) > index
  55. ? activeIcon
  56. : inactiveIcon
  57. "
  58. :color="
  59. disabled
  60. ? '#c8c9cc'
  61. : Math.ceil(activeIndex) > index
  62. ? activeColor
  63. : inactiveColor
  64. "
  65. :custom-style="{
  66. padding: `0 ${$u.addUnit(gutter / 2)}`
  67. }"
  68. :size="size"
  69. ></u-icon>
  70. </view>
  71. </view>
  72. </view>
  73. </view>
  74. </template>
  75. <script>
  76. import props from './props.js';
  77. // #ifdef APP-NVUE
  78. const dom = weex.requireModule("dom");
  79. // #endif
  80. /**
  81. * rate 评分
  82. * @description 该组件一般用于满意度调查星型评分的场景
  83. * @tutorial https://www.uviewui.com/components/rate.html
  84. * @property {String | Number} value 用于v-model双向绑定选中的星星数量 (默认 1 )
  85. * @property {String | Number} count 最多可选的星星数量 默认 5
  86. * @property {Boolean} disabled 是否禁止用户操作 默认 false
  87. * @property {String | Number} size 星星的大小单位px 默认 18
  88. * @property {String} inactiveColor 未选中星星的颜色 默认 '#b2b2b2'
  89. * @property {String} activeColor 选中的星星颜色 默认 '#FA3534'
  90. * @property {String | Number} gutter 星星之间的距离 默认 4
  91. * @property {String | Number} minCount 最少选中星星的个数 默认 1
  92. * @property {Boolean} allowHalf 是否允许半星选择 默认 false
  93. * @property {String} activeIcon 选中时的图标名只能为uView的内置图标 默认 'star-fill'
  94. * @property {String} inactiveIcon 未选中时的图标名只能为uView的内置图标 默认 'star'
  95. * @property {Boolean} touchable 是否可以通过滑动手势选择评分 默认 'true'
  96. * @property {Object} customStyle 组件的样式对象形式
  97. * @event {Function} change 选中的星星发生变化时触发
  98. * @example <u-rate :count="count" :value="2"></u-rate>
  99. */
  100. export default {
  101. name: "u-rate",
  102. mixins: [uni.$u.mpMixin, uni.$u.mixin,props],
  103. data() {
  104. return {
  105. // 生成一个唯一id,否则一个页面多个评分组件,会造成冲突
  106. elId: uni.$u.guid(),
  107. elClass: uni.$u.guid(),
  108. rateBoxLeft: 0, // 评分盒子左边到屏幕左边的距离,用于滑动选择时计算距离
  109. activeIndex: this.value,
  110. rateWidth: 0, // 每个星星的宽度
  111. // 标识是否正在滑动,由于iOS事件上touch比click先触发,导致快速滑动结束后,接着触发click,导致事件混乱而出错
  112. moving: false,
  113. };
  114. },
  115. watch: {
  116. value(val) {
  117. this.activeIndex = val;
  118. },
  119. },
  120. methods: {
  121. init() {
  122. uni.$u.sleep().then(() => {
  123. this.getRateItemRect();
  124. this.getRateIconWrapRect();
  125. })
  126. },
  127. // 获取评分组件盒子的布局信息
  128. async getRateItemRect() {
  129. await uni.$u.sleep();
  130. // uView封装的获取节点的方法,详见文档
  131. // #ifndef APP-NVUE
  132. this.$uGetRect("#" + this.elId).then((res) => {
  133. this.rateBoxLeft = res.left;
  134. });
  135. // #endif
  136. // #ifdef APP-NVUE
  137. dom.getComponentRect(this.$refs["u-rate"], (res) => {
  138. this.rateBoxLeft = res.size.left;
  139. });
  140. // #endif
  141. },
  142. // 获取单个星星的尺寸
  143. getRateIconWrapRect() {
  144. // uView封装的获取节点的方法,详见文档
  145. // #ifndef APP-NVUE
  146. this.$uGetRect("." + this.elClass).then((res) => {
  147. this.rateWidth = res.width;
  148. });
  149. // #endif
  150. // #ifdef APP-NVUE
  151. dom.getComponentRect(
  152. this.$refs["u-rate__content__item__icon-wrap"][0],
  153. (res) => {
  154. this.rateWidth = res.size.width;
  155. }
  156. );
  157. // #endif
  158. },
  159. // 手指滑动
  160. touchMove(e) {
  161. // 如果禁止通过手动滑动选择,返回
  162. if (!this.touchable) {
  163. return;
  164. }
  165. this.preventEvent(e);
  166. const x = e.changedTouches[0].pageX;
  167. this.getActiveIndex(x);
  168. },
  169. // 停止滑动
  170. touchEnd(e) {
  171. // 如果禁止通过手动滑动选择,返回
  172. if (!this.touchable) {
  173. return;
  174. }
  175. this.preventEvent(e);
  176. const x = e.changedTouches[0].pageX;
  177. this.getActiveIndex(x);
  178. },
  179. // 通过点击,直接选中
  180. clickHandler(e, index) {
  181. // ios上,moving状态取消事件触发
  182. if (uni.$u.os() === "ios" && this.moving) {
  183. return;
  184. }
  185. this.preventEvent(e);
  186. let x = 0;
  187. // 点击时,在nvue上,无法获得点击的坐标,所以无法实现点击半星选择
  188. // #ifndef APP-NVUE
  189. x = e.changedTouches[0].pageX;
  190. // #endif
  191. // #ifdef APP-NVUE
  192. // nvue下,无法通过点击获得坐标信息,这里通过元素的位置尺寸值模拟坐标
  193. x = index * this.rateWidth + this.rateBoxLeft;
  194. // #endif
  195. this.getActiveIndex(x);
  196. },
  197. // 发出事件
  198. emitEvent() {
  199. // 发出change事件
  200. this.$emit("change", this.activeIndex);
  201. // 同时修改双向绑定的value的值
  202. this.$emit("input", this.activeIndex);
  203. },
  204. // 获取当前激活的评分图标
  205. getActiveIndex(x) {
  206. if (this.disabled) {
  207. return;
  208. }
  209. // 判断当前操作的点的x坐标值,是否在允许的边界范围内
  210. const allRateWidth = this.rateWidth * this.count + this.rateBoxLeft;
  211. // 如果小于第一个图标的左边界,设置为最小值,如果大于所有图标的宽度,则设置为最大值
  212. x = uni.$u.range(this.rateBoxLeft, allRateWidth, x);
  213. // 滑动点相对于评分盒子左边的距离
  214. const distance = x;
  215. // 滑动的距离,相当于多少颗星星
  216. let index;
  217. // 判断是否允许半星
  218. if (this.allowHalf) {
  219. index = Math.floor(distance / this.rateWidth);
  220. // 取余,判断小数的区间范围
  221. const decimal = distance % this.rateWidth;
  222. if (decimal <= this.rateWidth / 2 && decimal > 0) {
  223. index += 0.5;
  224. } else if (decimal > this.rateWidth / 2) {
  225. index++;
  226. }
  227. } else {
  228. index = Math.floor(distance / this.rateWidth);
  229. // 取余,判断小数的区间范围
  230. const decimal = distance % this.rateWidth;
  231. // 非半星时,只有超过了图标的一半距离,才认为是选择了这颗星
  232. if (decimal > this.rateWidth / 2) {
  233. index++;
  234. }
  235. }
  236. this.activeIndex = Math.min(index, this.count);
  237. // 对最少颗星星的限制
  238. if (this.activeIndex < this.minCount) {
  239. this.activeIndex = this.minCount;
  240. }
  241. this.moving = true;
  242. // 一定时间后,取消标识为移动中状态,是为了让click事件无效
  243. setTimeout(() => {
  244. this.moving = false;
  245. }, 10);
  246. this.emitEvent();
  247. },
  248. },
  249. mounted() {
  250. this.init();
  251. },
  252. };
  253. </script>
  254. <style lang="scss">
  255. @import "../../libs/css/components.scss";
  256. $u-rate-margin: 0 !default;
  257. $u-rate-padding: 0 !default;
  258. $u-rate-item-icon-wrap-half-top: 0 !default;
  259. $u-rate-item-icon-wrap-half-left: 0 !default;
  260. .u-rate {
  261. @include flex;
  262. align-items: center;
  263. margin: $u-rate-margin;
  264. padding: $u-rate-padding;
  265. /* #ifndef APP-NVUE */
  266. touch-action: none;
  267. /* #endif */
  268. &__content {
  269. @include flex;
  270. &__item {
  271. position: relative;
  272. &__icon-wrap {
  273. &--half {
  274. position: absolute;
  275. overflow: hidden;
  276. top: $u-rate-item-icon-wrap-half-top;
  277. left: $u-rate-item-icon-wrap-half-left;
  278. }
  279. }
  280. }
  281. }
  282. }
  283. .u-icon {
  284. /* #ifndef APP-NVUE */
  285. box-sizing: border-box;
  286. /* #endif */
  287. }
  288. </style>