Skip to content

介绍

框架提供一系列的组件方便快速开发。

基础组件

基础组件由 Vant 提供。

替换组件库

如果你不喜欢 Vant ,或者你想要将老项目迁移到 Fantastic-mobile 上,但老项目里使用的组件库并不是 Vant ,框架也提供了组件库替换移方案:

如果你想使用的组件库不在上述方案中,可以通过参考任何一份方案,理解替换的整理思路,并自行替换,别担心会很复杂,我们已经将大部分工作做好了。

内建组件

为满足 UI 组件库可替换的特性,框架提供了一批内建组件。这些组件的设计仅满足于框架自身需求,如果在业务中使用并且无法满足业务需求,建议使用更为专业的 UI 组件库。

内建组件存放在 /src/ui/components/ 目录下,并配置了使用时自动引入。

说明

如果内建组件有提供 class 属性,或者类似于 class 的属性,例如 contentClass ,意味着你可以通过 UnoCSS 提供的原子类来修改组件的默认样式,并且不会产生样式冲突。

其背后的原理是因为框架通过 cn() 函数来管理组件的 class

ts
import type { ClassValue } from 'clsx'
import { clsx } from 'clsx'
import { twMerge } from 'tailwind-merge'

function cn(...inputs: ClassValue[]) {
  return twMerge(clsx(inputs))
}

扩展组件

扩展组件也就是开发者自定义的组件,存放在 /src/components/ 目录下,我们也建议开发者将自定义组件存放在该目录下,方便后续框架迁移升级。

框架提供了几个基于 Vant 组件上二次封装的组件。