feat: enhance BottomNav component and update project configuration

This commit is contained in:
2026-03-12 22:53:57 +08:00
parent 02dd31e85c
commit 8d2180940b
25 changed files with 1083 additions and 135 deletions

View File

@@ -2,7 +2,7 @@
## 项目概述
这是一个基于 **Taro 框架的多端小程序开发模板**项目。它提供了一个统一的开发框架用于构建跨平台小程序可以编译到微信、小红书、支付宝、百度、字节跳动、H5、React Native、QQ、京东等多个平台
微信小程序开发模板基于Taro框架
## 技术栈
@@ -48,52 +48,6 @@ taro-template/
## 开发指南
### 创建新页面
使用 Taro CLI 创建新页面:
```bash
npm run new -- [pageName]
```
### 添加平台特定代码
使用 `Taro.getEnv()` 检测当前平台:
```typescript
import Taro from "@tarojs/taro";
const env = Taro.getEnv();
if (env === Taro.ENV_TYPE.WEAPP) {
// 微信小程序特定代码
} else if (env === "xhs") {
// 小红书特定代码
}
```
或使用提供的工具函数:
```typescript
import { isXHS } from './pages/xhs/utils/is-xhs';
if (isXHS()) {
// 小红书特定代码
}
```
### 样式
项目使用标准 CSS页面样式与组件放在一起
- 全局样式: `src/app.css`
- 页面样式: `src/pages/{page}/{page}.css`
### 环境变量
- `.env.development` - 开发环境
- `.env.test` - 测试环境
- `.env.production` - 生产环境
## 配置文件说明
### app.config.ts
@@ -104,14 +58,6 @@ if (isXHS()) {
应用入口组件,包含 `useLaunch` 生命周期钩子,用于应用初始化。在微信环境下会自动调用 `Taro.login`
### project.xhs.json
小红书 IDE 特定配置appid、编译设置等
### tsconfig.json
TypeScript 编译器选项,包括路径别名配置(`@/*``./src/*`)。
## AI 代理注意事项
1. 修改平台特定代码时,使用环境检测确保跨平台兼容性
@@ -119,3 +65,8 @@ TypeScript 编译器选项,包括路径别名配置(`@/*` → `./src/*`
3. 遵循现有的代码风格和目录结构
4. 添加新依赖时,确保与所有目标平台兼容
5. 项目使用 pnpm 作为包管理器
## 避免
1. 不能使用 `?.``??` 操作符, 因为不支持
2. 不能使用 TextDecoder 和 TextEncoder, 因为不支持
3. 不能使用 Buffer, 因为不支持