docs: 更新模板说明文档,添加spa模板介绍

- 添加 `spa` 模板到普通模板列表
- 新增 `tabbar` 和 `spa` 模板的区别说明
- 移除已废弃的 `js` 模板相关说明
- 更新命令行创建示例,包含 `spa` 模板
This commit is contained in:
feige996 2025-06-03 20:22:46 +08:00
parent 0caad393d6
commit 06419929f9

View File

@ -39,14 +39,20 @@ npm create unibest@latest my-project
`create unibest` 支持 `-t` 参数选择模板,目前已有两大类 `8` 个模板
- `普通` 模板( `4个` ):分别是 `base``tabbar``i18n`、`demo`、~~`js`~~
- `普通` 模板( `4个` ):分别是 `base``tabbar``spa`、 `i18n``demo`
- `hbx` 模板(`2个` ):分别是 `hbx-base``hbx-demo`
不带 `-t` 参数时会默认生成 `base` 模板。
`base` 模板是最基本的模板,更新最及时,推荐使用 `base` 模板创建新项目。其他几个模板也是基于 `base` 模板得到的。 `demo` 模板则作为参考用。
`js` 模板不推荐使用,可以使用 `base` 模板替代,里面已经做了兼容配置,可以直接编写 `js`,原本的 `ts` 文件还能提供部分类型,何乐而不为?
::: details `tabbar 模板``spa 模板` 的区别
- `tabbar` 模板里面的tabbar 路由是属于 `tabbar` 级别的,需要使用 `switchTabbar` 切换,`tabbar` 页面会有缓存,渲染性能较好。
- `spa` 模板类似于前端的 `SPA 应用``tabbar` 完全是一个组件实现的。页面之间切换是通过前端状态控制,简单灵活,不受 `tabbar` 的配置限制,但性能不如 `tabbar` 模板。
- 两者各有优点,按需选用。
:::
```sh
# VS Code 模板
@ -54,9 +60,9 @@ pnpm create unibest my-project # 默认用 base 模板
pnpm create unibest my-project -t base # 基础模板
pnpm create unibest my-project -t tabbar # 自定义 tabbar 模板
pnpm create unibest my-project -t spa # 单页应用 模板使用一个组件模拟tabbar
pnpm create unibest my-project -t i18n # 多语言模板
pnpm create unibest my-project -t demo # 所有demo的模板(包括i18n)
# pnpm create unibest my-project -t js # js 模板
# HBuilderX 模板,方便使用 uniCloud 云开发 (未来可以对接 uni-app x)
pnpm create unibest my-project -t hbx-base # hbx的base模板