diff --git a/docs/base/2-start.md b/docs/base/2-start.md index c89fdeb..353c38f 100644 --- a/docs/base/2-start.md +++ b/docs/base/2-start.md @@ -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模板