更新记录

1.0.0（2026-07-10） 下载此版本

• 初始版本：词云布局、自定义颜色/密度、整体旋转、滚动抽取

平台兼容性

uni-app(4.0)

zv-wordcloud

词云组件，只需传入字符串数组。词条均匀分布在球面上，默认像地球一样缓慢自转；手动加速后恢复常速。

基础用法

<zv-wordcloud
  ref="wordCloud"
  :words="['酸菜鱼', '火锅', '螺蛳粉']"
  height="680rpx"
  @roll-end="onRollEnd"
/>

<view @click="$refs.wordCloud.startRoll()">随机决定（加速旋转）</view>
<view @click="$refs.wordCloud.stopRoll()">停止（恢复慢速）</view>

球体旋转

• 挂载后默认 缓慢自转（normalRotateSpeed，默认 0.12°/帧）
• startRoll() / startCloudRotate() → 切换为 快速旋转（fastRotateSpeed，默认 2.2°/帧）
• stopRoll() / stopCloudRotate() → 恢复 慢速自转（不会完全停转）

Props

方法

事件

roll-start · roll-change · roll-end · roll-stop · select · item-click · refresh · cloud-rotate-start · cloud-rotate-stop · cloud-rotate-change