# 移动端之Uniapp+Js框架

**Repository Path**: trident-framework/trident-applet-uniapp-js

## Basic Information

- **Project Name**: 移动端之Uniapp+Js框架
- **Description**: 移动端之uniapp js框架【Uniapp+Vue3 + Js + Pinia + Pinia-plugin-persistedstate + Sass、Better-scroll、Z-paging】
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-10-23
- **Last Updated**: 2025-09-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# trident-applet-uniapp-js

这是一个基于 UniApp 开发的跨平台小程序项目，适用于多种应用场景，例如电商、社交、工具类小程序等。项目集成了丰富的组件和工具类库，便于快速开发和扩展。

## 项目特点

- **跨平台支持**：基于 UniApp 框架，一次开发，多端部署（微信小程序、H5、App 等）。
- **模块化设计**：项目结构清晰，模块划分明确，便于维护和扩展。
- **丰富的组件库**：集成 `uv-ui` 组件库，提供图标、文本、链接、骨架屏等常用组件。
- **工具类支持**：内置 `uv-ui-tools` 工具集，涵盖请求封装、数据处理、验证、时间格式化等功能。
- **状态管理**：使用 Pinia 进行状态管理，模块化管理购物车、用户、订单等状态。
- **API 接口统一管理**：所有接口统一存放在 `src/apis` 目录下，便于统一管理和调用。

## 目录结构

```
src/
├── apis/                  # 接口请求模块
├── components/              # 公共组件
├── pages/                   # 页面组件
├── pagesConfirmOrder/       # 订单确认页面
├── pagesDeliveryAddr/       # 收货地址页面
├── pagesGoods/              # 商品相关页面
├── pagesOrder/              # 订单相关页面
├── pagesScroll/             # 滚动组件页面
├── pagesUser/               # 用户相关页面
├── stores/                  # Pinia 状态管理模块
├── static/                  # 静态资源（图片、图标等）
├── uni_modules/             # 第三方插件模块（uv-ui、qf-image-cropper 等）
├── utils/                   # 工具类（如请求封装）
├── App.vue                  # 应用入口组件
├── main.js                  # 应用入口文件
├── manifest.json            # 应用配置文件
├── pages.json               # 页面配置文件
```

## 技术栈

- **框架**：[UniApp](https://uniapp.dcloud.io/)
- **状态管理**：[Pinia](https://pinia.vuejs.org/)
- **UI 组件库**：[uv-ui](https://www.uvui.cn/)
- **请求库**：[luch-request](https://www.axios-like.com/)
- **构建工具**：[Vite](https://vitejs.dev/)

## 安装与运行

### 安装依赖

```bash
npm install
```

### 启动开发服务器

```bash
npm run dev
```

### 构建生产环境版本

```bash
npm run build
```

## 使用说明

- **页面开发**：页面存放在 `src/pages` 目录下，新增页面需在 `pages.json` 中注册。
- **接口调用**：所有接口封装在 `src/apis` 目录下，使用 `uv-ui-tools` 提供的 `httpRequest` 进行统一请求。
- **状态管理**：使用 `Pinia` 管理全局状态，模块存放在 `src/stores` 目录下。
- **组件使用**：项目中使用了 `uv-ui` 提供的组件，具体使用方式可参考 [uv-ui 官方文档](https://www.uvui.cn/components/icon.html)。

## 第三方插件

- **uv-icon**：图标组件，支持多种图标类型。
- **uv-skeletons**：骨架屏组件，提升用户体验。
- **uv-text**：文本组件，支持多种文本样式。
- **qf-image-cropper**：图片裁剪插件，适用于头像上传等场景。

## 贡献指南

欢迎贡献代码和反馈问题。请遵循以下步骤：

1. Fork 项目
2. 创建新分支 (`git checkout -b feature/new-feature`)
3. 提交更改 (`git commit -am 'Add some feature'`)
4. 推送分支 (`git push origin feature/new-feature`)
5. 创建 Pull Request

## 许可证

本项目采用 MIT 许可证。详情请查看 [LICENSE](LICENSE) 文件。