docs: 更新模板说明文档,添加spa模板介绍
- 添加 `spa` 模板到普通模板列表 - 新增 `tabbar` 和 `spa` 模板的区别说明 - 移除已废弃的 `js` 模板相关说明 - 更新命令行创建示例,包含 `spa` 模板
This commit is contained in:
parent
0caad393d6
commit
06419929f9
@ -39,14 +39,20 @@ npm create unibest@latest my-project
|
|||||||
|
|
||||||
`create unibest` 支持 `-t` 参数选择模板,目前已有两大类 `8` 个模板
|
`create unibest` 支持 `-t` 参数选择模板,目前已有两大类 `8` 个模板
|
||||||
|
|
||||||
- `普通` 模板( `4个` ):分别是 `base`、`tabbar`、`i18n`、`demo`、~~`js`~~
|
- `普通` 模板( `4个` ):分别是 `base`、`tabbar`、`spa`、 `i18n`、`demo`。
|
||||||
- `hbx` 模板(`2个` ):分别是 `hbx-base`、`hbx-demo`。
|
- `hbx` 模板(`2个` ):分别是 `hbx-base`、`hbx-demo`。
|
||||||
|
|
||||||
不带 `-t` 参数时会默认生成 `base` 模板。
|
不带 `-t` 参数时会默认生成 `base` 模板。
|
||||||
|
|
||||||
`base` 模板是最基本的模板,更新最及时,推荐使用 `base` 模板创建新项目。其他几个模板也是基于 `base` 模板得到的。 `demo` 模板则作为参考用。
|
`base` 模板是最基本的模板,更新最及时,推荐使用 `base` 模板创建新项目。其他几个模板也是基于 `base` 模板得到的。 `demo` 模板则作为参考用。
|
||||||
|
|
||||||
`js` 模板不推荐使用,可以使用 `base` 模板替代,里面已经做了兼容配置,可以直接编写 `js`,原本的 `ts` 文件还能提供部分类型,何乐而不为?
|
::: details `tabbar 模板` 和 `spa 模板` 的区别
|
||||||
|
|
||||||
|
- `tabbar` 模板里面的tabbar 路由是属于 `tabbar` 级别的,需要使用 `switchTabbar` 切换,`tabbar` 页面会有缓存,渲染性能较好。
|
||||||
|
- `spa` 模板类似于前端的 `SPA 应用`,`tabbar` 完全是一个组件实现的。页面之间切换是通过前端状态控制,简单灵活,不受 `tabbar` 的配置限制,但性能不如 `tabbar` 模板。
|
||||||
|
- 两者各有优点,按需选用。
|
||||||
|
|
||||||
|
:::
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
# VS Code 模板
|
# 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 base # 基础模板
|
||||||
pnpm create unibest my-project -t tabbar # 自定义 tabbar 模板
|
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 i18n # 多语言模板
|
||||||
pnpm create unibest my-project -t demo # 所有demo的模板(包括i18n)
|
pnpm create unibest my-project -t demo # 所有demo的模板(包括i18n)
|
||||||
# pnpm create unibest my-project -t js # js 模板
|
|
||||||
|
|
||||||
# HBuilderX 模板,方便使用 uniCloud 云开发 (未来可以对接 uni-app x)
|
# HBuilderX 模板,方便使用 uniCloud 云开发 (未来可以对接 uni-app x)
|
||||||
pnpm create unibest my-project -t hbx-base # hbx的base模板
|
pnpm create unibest my-project -t hbx-base # hbx的base模板
|
||||||
|
Loading…
x
Reference in New Issue
Block a user