Skip to content

找到与预览 ​

这一页说明如何在组件市场里找到合适的组件,并在下载前确认它真的能用。

进入组件市场 ​

启动本地服务后,在左侧菜单点击「组件市场」。列表里的每一张卡片对应一个已发布的组件。

顶部提供四种筛选:

筛选含义什么时候用
推荐综合使用量与评分的推荐排序没有明确目标,先逛逛
最新按发布时间倒序想看团队最近产出的组件
热门按下载量排序想找经过较多项目验证的组件
全部不做依赖匹配过滤明确知道组件存在,但在前三个列表里找不到

为什么有些组件只出现在「全部」

前三类列表会过滤掉与本地环境依赖不匹配的组件。组件没出现时,先切到「全部」确认它是否存在,再按依赖匹配处理版本问题。

卡片上的信息 ​

  • 名称与作者:组件名在同一空间内唯一,作者是发布者。
  • 描述:发布时填写的备注,用来快速判断用途。
  • 依赖标签:组件源码里实际引用到的第三方包。
  • 统计:下载量、收藏等使用情况。

打开预览页 ​

点击卡片上的「预览」,会在新标签页打开详情页。详情页包含五个区域:

  1. 预览区:组件真实运行效果,支持小窗与全屏切换。
  2. 文档区:组件 README.md 的渲染结果,包含属性、事件与使用示例。
  3. 版本选择:切换查看历史版本,下载前可以对比行为差异。
  4. 依赖信息:组件声明的依赖、本地匹配状态,以及缺失项。
  5. 外观控制:切换背景色,检查组件在深浅底色下的表现。

预览时该确认什么 ​

  • 组件在你当前的框架版本下能正常渲染(Vue 2 / Vue 3 / React)。
  • 交互行为符合预期,而不只是静态截图好看。
  • 依赖状态没有红色告警;黄色表示版本有差异,可继续观察。
  • README 里的属性表与实际行为一致。

组件不显示怎么办 ​

按顺序排查:

  1. 把筛选切到「全部」,确认组件确实存在。
  2. 打开组件详情,查看依赖状态与缺失项。
  3. 在本地项目安装缺失依赖,刷新页面。
  4. 版本差异不影响功能时,在「设置 → 预览规则」放宽匹配规则。

完整规则与示例见依赖匹配。

下一步 ​

用户上传的组件遵循开源协议