# seaboot-app

**Repository Path**: seaboot/seaboot-app

## Basic Information

- **Project Name**: seaboot-app
- **Description**: 基于uni-app的基础工程，重点开发项目
- **Primary Language**: HTML
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2023-01-09
- **Last Updated**: 2025-08-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


#### 基础依赖

```shell
# 准备 sass
vue-cli 项目请先安装 sass 及 sass-loader，如在 HBuliderX 中使用，可跳过此步。

# 安装 sass
npm i sass -D   或   yarn add sass -D  

# 安装 sass-loader
npm i sass-loader@10.1.1 -D   或   yarn add sass-loader@10.1.1 -D
```

#### 依赖库

下面两个目录下的组件，都能自动识别，无须手动注册

* component：标准 VUE 组件，自定义组件一般放这儿；
* uni_modules：有特殊规范的组件，官网找的插件会自动装到这里；

Tips：实在装不上，就到 component/installer.js 文件中注册；

#### 样式设计

平时编码过程中，尽可能使用通用样式。

没特殊要求，不要启用 scope 样式，留给前端开发，供其微调使用。 

通用样式：

* /uni.css：用于配置各种样式常量；
* /static/css/base.css：扩展了大量基础样式；
* /static/css/style：如果需要设计平台兼容样式，参照这种命名规范；

#### 代码库

严格限制组件库的安装

* 插件尽可能兼容全平台；
* 非必要不再安装新的库；
* 需要引用新的库，优先使用官网的；
* 安装新的库，做好说明，方便其他程序员更新替换；

```text
# base
uni-scss：基础依赖

# UI 
uni-tag：标签
uni-badge：徽形文字（按钮角标）
uni-icons：图标库，优先使用 icon，再考虑使用图片
uni-transition：过渡动画

# form
uni-forms：表单
uni-group：分组
uni-forms-item：表单

uni-easyinput：输入框
uni-data-select：下拉框
uni-data-picker：选择器
uni-data-checkbox：复选框
uni-number-box：数字输入框
uni-rate：评分（五角星评分按钮）

# 数据列表布局
z-tabs：选项卡
z-paging：上拉加载，下拉刷新
uni-fab：悬浮按钮，下拉加载中，返回顶部
uni-indexed-list：索引列表，类似于电话簿

# charts
qiun-data-charts：图表

# 气泡窗口
uni-popup

# 导航
uni-drawer：侧滑导航，用户信息面板一般会放到这个
uni-grid：九宫格，用于制作菜单栏，一般不用，通过基础布局也能实现
```

#### 随时会被删除的库

替代方案太多，随时会被清除

```text
uni-title：h1-h6；
uni-section：大标题、小标题；

uni-file-picker：文件选择器，可用但是对业务兼容较差，一般直接调用原始代码；
uni-datetime-picker：日期选择器，一般使用原生的 picker，只在需要选择范围的时候用

wm-watermark：水印，需求较少，并且已有更好的库。
```