---
name: xiaoma-zqyl-data-census-front
description: 前台指标摘要卡片（描述 + 数值）的 Vue2 实现规范（ylDataCensus）。在用户提及 ylDataCensus、yl-data-census、数据统计、指标摘要、仪表盘统计区，或需要在前台实现该组件时使用。适用于前台门户仓库（如 zqyl-crclopen，platformType `yx`；页头/表格用 ylTitle + ylTableSimple）。 Use when implementing or reviewing the data-census (ylDataCensus) component on a ZQYL front page.
---

# 数据统计（前台）

你是一个前端组件实现与改造助手。你必须严格按本技能的规则输出。

## 适用范围
- 平台：前台
- platformType：`yx`
- 组件条目：`dataCensus`

## 目标
- 当用户提到该组件/场景时，给出可落地的 Vue2 + Element UI + zqyl-component-base 代码片段与参数建议。
- 不改变业务行为，仅替换/补齐结构与交互规范。

## 组件注册（必读）

- `zqyl-component-base` 公共组件在**项目入口**按组件名逐个 `import 'zqyl-component-base/lib/<ComponentName>'` + `Vue.component` 注册；样式在入口引入 `component.css`。
- **禁止** `import zqylComponentBase from 'zqyl-component-base'` + `Vue.use(zqylComponentBase)`；页面模板直接使用 `<yl-*>`，**勿**单页重复 import。
- 生成前先检查入口是否已注册本页用到的组件；缺失则仅在入口补注册。

## 输出要求
- 回答用户时：根据用户输入与页面场景，只输出**一段**最符合需求的 Vue 代码（可直接粘贴），并简要说明关键 props/注意事项。
- 不要在一次回答中罗列多种候选实现；不要输出“变体 A/B/C/D”或“方案一/方案二”等对比式内容。
- 本技能文档「示例」章节含多种参考写法，仅供你内部分析选型；**不得**把多个示例原样全部贴给用户。
- 示例代码必须可直接粘贴使用（Vue2 单文件组件片段）。

## 数据与接口（禁止 mock）

- **禁止**在生成业务页面中填充 mock、演示、假数据或静态业务行（如手写 `loadData: [{ companyName: 'xxx' }]`、`reqData` 示例值、`mounted` 里写死 `total` 等）。
- 列表/表格：`tableData.loadData` 保持 `[]`，数据由 `ylTableSimple` / `ylMpsTable` 通过 `searchParmas.request` / `queryListUrl` **调接口**获取；`request.url` / `queryListUrl` 写项目已有 `INTERFACE.xxx`，未知时留 `''` 并注释 `// TODO: 补充接口常量`。
- 查询区：`searchParmas.request` 配置 `url`、`type`、`method`、`options`；有 `url` 时 `:load="true"`（或省略，默认加载），由组件触发查询。
- 表单详情：`reqData` / 表单 model 初始 `{}` 或字段空值；在 `created` / `mounted` 调详情接口赋值；**禁止**预填示例姓名、金额等。
- 下拉/枚举：`select` 的 `data` 从字典或接口加载，无数据时 `data: []`；**禁止**写死 `{ name: '待审核', code: '1' }` 类占位项（除非需求明确给定静态枚举）。
- 统计区 `ylDataCensus`：`:list` 由接口或 `computed` 赋值，**禁止**手写示例金额/数量。
- 动态行表格：`detailRows` 等初始 `[]`，由接口回显或用户操作增删。
- 本 skill「示例」章节的静态数据**仅供理解组件 API**；生成业务页面时**不得**照搬进 `data()`。

## 何时使用（智能体选择规则）

当需求/页面出现以下任一信号时，必须优先调用本 skills 并按规则产出代码：
- 列表页/详情页顶部需要展示若干**指标摘要**（描述 + 数值），无复杂交互。
- 数据面板、仪表盘统计区、待办/状态数量概览。
- 用户提到「yl-data-census」、「ylDataCensus」、「数据统计」卡片时。

不适用：趋势图、对比图、可钻取分析 → 使用 ECharts 或业务定制模块。

## API（ylDataCensus）

> 标签：`<yl-data-census>` / `ylDataCensus`；须在入口 `import ylDataCensus from 'zqyl-component-base/lib/ylDataCensus'` + `Vue.component('ylDataCensus', ylDataCensus)` 注册；页面模板直接使用，**勿**单页 import；**禁止**全量 `Vue.use(zqylComponentBase)`。

### Props

| 属性名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| `list` | Array | `null` | 指标列表（**必填**，勿传空数组） |
| `title` | Boolean | `false` | 是否显示标题区（为 `true` 时顶部展示「数据统计」） |

### `list[]` 项字段

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `describe` | String | 指标描述文案 |
| `data` | String \| Number | 指标值；金额等建议在业务层格式化后传入 |

### Events / Slots / Methods

无对外事件、插槽与方法（以组件库为准）。

### 样式与布局（以组件库为准）

- 容器：`el-card` + Element 栅格；列宽约 `24 / list.length`。
- 数据项之间使用左边框分隔；`title` 为 true 时标题约 14px bold，下边框 `1px solid #F2F2F2`。
- 描述约 14px / `#909399`；数值约 24px bold / `#303133`。

## 示例（参考写法，回答用户时只选用其中一种）

### 基础用法（无标题）
```vue
<yl-data-census :list="dataList" />
```

// dataList: 由接口赋值，项为 { describe, data }

### 带标题
```vue
<yl-data-census :list="dataList" :title="true" />
```

### 金额类指标（字符串格式化）
```vue
<yl-data-census :list="censusList" />
```

// censusList: 由接口赋值，金额类 data 可为格式化字符串

## 注意事项
- `list` 由接口或 `computed` 赋值；**禁止**手写示例指标；接口未就绪时 `list: []`，待 `created`/`mounted` 请求后更新。
- 同一页面多处统计卡时，保持 `list` 长度一致，避免栅格列宽跳动。
- `title` 为 `true` 时展示内置标题「数据统计」；列表页概览常用无标题或带标题两种。
- 金额、百分比等在业务层格式化为字符串再传入；组件仅负责展示，无点击事件。
