# dataroom-sys-components

**Repository Path**: zychhf/dataroom-sys-components

## Basic Information

- **Project Name**: dataroom-sys-components
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-09
- **Last Updated**: 2025-06-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 依赖包系统组件开发说明

在系统组件开发中，对文件夹的层级目录有固定约束

## 使用说明

1. 安装依赖包

```bash
# 安装依赖包
yarn add @tiamaes/data-room-sys-components
```

2. 引入使用

在 `data-room-ui\example\remoteComponents\exports.js` 文件中引入组件

```js
// 通用系统组件
import sysComponents from '@tiamaes/data-room-sys-components';
export default sysComponents;
```

## 目录结构说明

1. Base： 基础组件，比如：下拉框、tab 切换等
2. Echarts： echarts 组件
3. Map： 地图相关组件

## 组件开发规范

组件必须的文件要求： index.vue、config.js、component.png

```text
index.vue // 组件入口文件
config.js // 组件配置文件，此文件的配置会体现在组件的左侧栏设置
component.png // 组件预览图
```

## 开发步骤

具体可参考组件 `Eacharts\Bar01`;

## 调试开发步骤

通过 link 方式进行组件开发调试

1. 在此项目根目录中执行 `yarn link`
2. 在 dataroom 项目根目录中执行 `yarn link @tiamaes/data-room-sys-components`

```bash
yarn link # 当前项目中执行

yarn link @tiamaes/data-room-sys-components # dataroom项目中执行
```

通过以上两个命令，就可以正常开发调试了

## 设置栏类型

```bash
basic: '基础',
position: '位置',
graph: '图表',
rotate: '旋转',
grid: '网格线',
legend: '图例',
xAxis: 'X轴',
yAxis: 'Y轴',
padding: '边距',
other: '其他'
```

## 拉取代码可能存在的问题

组件文件夹名字大小写无法与 gitlab 仓库文件夹大小写不一致。导致已经拖拽的项目无法正常显示

解决方案：

```bash
# git设置大小写敏感
git config --global core.ignorecase false
# 清楚git缓存
git rm -r --cached .
# 拉取代码
git pull
```