Vue 3 组件系统

SoybeanUI

面向 Vue 3 的强大而优雅的组件系统,提供无头交互能力与开箱即用的样式封装。

库概览

93
组件数
8
分类数
2
包数
5
指南数

两种使用方式

选择适合你工作流程的分发模式 — npm 包快速集成,或 CLI 复制粘贴完全掌控源码。

npm 包

传统依赖

将 @soybeanjs/ui 作为依赖安装。自动导入、Tree-shaking,通过包管理器无缝升级。

  • 一行命令安装
  • 支持 unplugin-vue-components 自动导入
  • Tree-shaking — 只打包使用的代码
  • 通过包管理器无缝升级
  • Nuxt 模块支持
安装 npm 包

CLI · 复制粘贴

shadcn 风格

通过 sbean CLI 将源码复制到你的项目中。完全控制、完全自定义 — 你拥有代码。

  • 组件存在于你的源码树中
  • 可编辑任何文件 — 完全自定义
  • sbean diff 查看上游变更
  • 只有你添加的组件才会存在
  • 自定义设计系统的最佳选择
尝试 CLI

快速接入

完成安装、样式接入与首个页面渲染,先把基础链路跑通。

理解双层分工

先看无头能力与带样式封装如何分工,再决定接入深度与样式策略。

浏览组件版图

按类别查看基础组件、模式组件与工具组件,快速收敛选型范围。

配置主题系统

理解 tokens、variants 与 ui slot 覆盖的关系,避免后续返工。

核心特性

Headless First

@soybeanjs/headless 只提供状态、行为与可访问性语义,便于直接复用到自定义设计系统。

样式包装层

@soybeanjs/ui 提供带默认样式的 S 前缀组件,让常见界面可以直接交付而不必从零包样式。

内建可访问性

遵循 WAI-ARIA 模式,覆盖键盘导航、焦点管理与语义状态同步。

类型安全 API

基于 TypeScript 构建,组件、插槽与配置项都有清晰的类型反馈。

Slot 级样式覆盖

通过 ui prop 和 slot 映射精确覆盖局部样式,而不是整体重写组件。

Theme-ready Variants

基于 UnoCSS 与 @soybeanjs/cva 组织变体,便于统一令牌和主题扩展。

完整组件版图

覆盖通用、表单、导航、浮层与数据展示等核心界面场景。

Vue 生态友好

提供 Nuxt、自动导入与文档示例支持,让接入、演示和维护更顺手。