neo-cmp-cli 1.12.7 → 1.12.9

package/template/develop/EntityList H5 /347/273/204/344/273/266/347/232/204/350/257/246/347/273/206/345/210/206/346/236/220/346/226/207/346/241/243.md"

@@ -1,1386 +0,0 @@
-# EntityList H5 组件详细分析文档
-
-## 目录
-
-- [组件概述](#组件概述)
-- [核心功能](#核心功能)
-- [组件架构](#组件架构)
-- [主要属性说明](#主要属性说明)
-- [生命周期方法](#生命周期方法)
-- [核心方法详解](#核心方法详解)
-- [使用示例](#使用示例)
-- [扩展机制](#扩展机制)
-- [注意事项](#注意事项)
-- [常见问题](#常见问题)
-
-## 组件概述
-
-`EntityList` 是 Neo UI Component H5 端的一个核心业务组件，用于展示和管理实体数据列表。它支持多种列表类型（大列表、相关列表、Picker列表、搜索列表等），提供了完整的数据展示、筛选、排序、批量操作等功能。
-
-### 技术栈
-
-- **React**: 基于 React 类组件实现
-- **MobX**: 使用 MobX 进行状态管理（通过 `@observer` 装饰器）
-- **MobX State Tree**: Store 使用 MST 进行状态管理
-- **amis**: 基于 amis 框架进行 UI 渲染
-- **TypeScript**: 完整的类型定义支持
-
-### 组件位置
-
-```
-packages/neo-ui-component-h5/src/components/List/EntityList/
-├── component.tsx      # 主组件实现
-├── interface.tsx      # 接口定义
-├── constant.ts        # 常量定义
-├── styled.ts          # 样式定义
-├── store.tsx          # Store 定义（在 Store/list.tsx）
-├── utils.ts           # 工具函数
-├── nexManager.ts      # Nex 1.0 扩展管理器
-└── nex/               # Nex 2.0 扩展实现
-```
-
-## 核心功能
-
-
-### 1. 多种列表类型支持
-
-组件支持以下列表类型（通过 `tableType` 属性控制）：
-
-- **`list`**: 大列表或数据列表组件
-- **`lookup`**: Picker 列表（用于表单关联关系选择）
-- **`refer`**: 二级列表或相关列表组件
-- **`search`**: 搜索结果列表
-- **`dashboardList`**: BI 列表
-
-### 2. 数据展示功能
-
-- **列表视图**: 支持卡片式列表展示
-- **SmartView 切换**: 支持多个视图切换（通过 `currencySmartView` 控制）
-- **分页加载**: 支持下拉刷新和上拉加载更多
-- **空状态处理**: 提供友好的空数据提示
-- **错误处理**: 完善的错误提示和重试机制
-
-### 3. 筛选和排序
-
-- **筛选功能**: 
-  - 支持顶部常用筛选（最多显示4个）
-  - 支持筛选抽屉（完整筛选界面）
-  - 支持扩展筛选项（`extFilterItems`）
-  - 筛选条件缓存
-- **排序功能**: 
-  - 支持多字段排序
-  - 支持升序/降序切换
-  - 不支持文本域和多选字段排序
-
-### 4. 批量操作
-
-- **批量选择**: 支持多选模式（最多20条）
-- **批量操作按钮**: 支持批量编辑、删除等操作
-- **批量操作状态管理**: 自动管理选中状态
-
-### 5. 新建和编辑
-
-- **新建按钮**: 支持业务类型选择
-- **表单跳转**: 支持跳转到新建/编辑表单
-- **相关列表新建**: 支持从详情页相关列表新建
-
-### 6. 搜索功能
-
-- **搜索栏**: 支持顶部搜索栏
-- **搜索页面**: 支持跳转到搜索页面
-- **当前页搜索**: 支持在当前页进行搜索（`isSearchAtCurrentPage`）
-
-### 7. 汇总统计
-
-- **汇总数据**: 支持显示汇总统计信息
-- **汇总弹窗**: 点击汇总按钮显示详细汇总信息
-
-### 8. 扩展机制
-
-- **Nex 1.0**: 通过 `nexIns` 进行扩展
-- **Nex 2.0**: 通过 `nexInsV2` 进行扩展（`nexVersion=2`）
-- **扩展布局**: 支持在多个位置插入扩展 Schema
-
-## 组件架构
-
-### 组件继承关系
-
-```typescript
-@GridRenderer({})
-@observer
-export default class EntityList<T> extends React.Component<EntityListProps & T, ObjectFormState>
-```
-
-- `@GridRenderer({})`: amis 网格渲染器装饰器
-- `@observer`: MobX 观察者装饰器，用于响应式更新
-- 继承自 `React.Component`
-
-### 核心实例属性
-
-```typescript
-class EntityList {
-  private listViewStatus: any[]        // 列表视图状态
-  listLoaded = false                   // 列表是否已加载
-  goback = false                       // 是否返回
-  uniqueEntity = ''                    // 唯一标识
-  nexIns: NexManager                   // Nex 1.0 扩展实例
-  nexInsV2: EntityListMaster            // Nex 2.0 扩展实例
-}
-```
-
-### Store 结构
-
-组件依赖 `IEntityListStore`，主要包含以下状态：
-
-- **数据状态**: `listData`, `allCount`, `hasMore`
-- **视图状态**: `currencySmartView`, `dataListViews`, `listStatus`
-- **筛选状态**: `filterValues`, `currencyFilter`
-- **排序状态**: `sortItemList`, `currentSortApiKey`
-- **加载状态**: `initConfiging`, `loadDataing`, `error`
-- **权限状态**: `permission`
-- **按钮配置**: `entityBtnList`, `batchBtnList`
-
-## 主要属性说明
-
-### 基础属性
-
-| 属性名 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| `tableType` | `string` | `'list'` | 列表类型：`list`/`lookup`/`refer`/`search`/`dashboardList` |
-| `objectApiKey` | `string` | - | 实体的 ApiKey |
-| `entityApiKey` | `string` | - | 实体的 ApiKey（与 objectApiKey 相同） |
-| `store` | `IEntityListStore` | - | 列表的 Store 实例（必填） |
-| `name` | `string` | - | 组件名称（必填） |
-| `titleName` | `string` | - | 顶部标题名称 |
-| `className` | `string` | `''` | 自定义样式类名 |
-| `style` | `object` | - | 自定义样式对象 |
-
-### 列表配置属性
-
-| 属性名 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| `isOnlyList` | `boolean` | `false` | 是否只展示列表（隐藏 smartView、filter、title） |
-| `isComponents` | `boolean` | `false` | 是否是数据列表组件或相关列表组件 |
-| `isNoRefresh` | `boolean` | `false` | 禁用下拉刷新和上拉加载 |
-| `disableTopView` | `boolean` | `false` | 隐藏搜索、排序、筛选 |
-| `disableSortFilterView` | `boolean` | `false` | 隐藏排序、筛选 |
-| `disabledSort` | `boolean` | `false` | 不展示列表排序组件 |
-| `disabledFilter` | `boolean` | `false` | 不展示列表过滤组件 |
-| `disableSearch` | `boolean` | `false` | 禁用搜索功能 |
-| `disableTitleView` | `boolean` | `false` | 隐藏筛选 |
-
-### 数据相关属性
-
-| 属性名 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| `requestParams` | `object` | - | 请求参数或 URL 额外信息 |
-| `referConditions` | `object` | - | 相关列表信息（相关列表必传） |
-| `referData` | `object` | - | Picker 相关信息（Picker 列表必传） |
-| `extFilterItems` | `array` | - | 配置之外的 filterItem 信息 |
-| `selectDataFromProps` | `array` | - | 默认选中数据 `[{id: XXX}]` |
-| `enableCache` | `boolean` | `true` | 是否启用缓存 |
-
-### 事件回调属性
-
-| 属性名 | 类型 | 说明 |
-|--------|------|------|
-| `onItemClickIntercept` | `Function` | 列表项点击事件拦截回调 |
-| `onBottomBtnIntercept` | `Function` | 底部操作按钮扩展回调 |
-| `onSearchDataComplete` | `Function` | 搜索接口数据完成回调 |
-| `onLoadedDataComplete` | `Function` | 表单获取数据后事件 |
-| `onPageComplete` | `Function` | 列表加载完成回调 |
-| `onListComplete` | `Function` | 列表初始化完成回调 |
-| `beforeSelectedSmartView` | `Function` | 选择 smartview 前回调 |
-| `afterSelectedSmartView` | `Function` | 选择 smartview 后回调 |
-| `beforeSearch` | `Function` | 搜索前回调 |
-
-### 扩展属性
-
-| 属性名 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| `nexVersion` | `number` | - | 列表 Nex 的版本（1 或 2） |
-| `extSmartViewCount` | `Function` | - | SmartViews 数量扩展点 |
-| `extSmartViewConditions` | `array` | - | SmartViews 查询 conditions 扩展点 |
-| `getHeaderExpand` | `Function` | - | 获取头部扩展 Schema |
-| `expandSchemas` | `array` | - | 扩展布局 Schema 数组 |
-
-### 其他属性
-
-| 属性名 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| `selectionMode` | `'single' \| 'multiple'` | - | 单选或多选状态 |
-| `selectMaxCount` | `number` | - | 列表多选最多选择条数（默认20） |
-| `isSearchAtCurrentPage` | `boolean` | `false` | 是否启用当页搜索 |
-| `listType` | `1 \| 2` | `1` | 正常大列表为1，首页配置的列表为2 |
-| `cancelBtnDisable` | `boolean` | `false` | 取消按钮是否禁用 |
-| `filterModal` | `boolean` | `false` | 是否配置了关联筛选器 |
-
-## 生命周期方法
-
-### componentWillMount
-
-```typescript
-componentWillMount() {
-  const scoped = this.context as IScopedContext
-  scoped.registerComponent(this)
-}
-```
-
-- **作用**: 注册组件到 amis 的 ScopedContext
-- **时机**: 组件挂载前
-
-### componentDidMount
-
-```typescript
-componentDidMount() {
-  // 1. 注册刷新列表的方法
-  this.registerFuncs()
-  
-  // 2. 处理搜索逻辑
-  if (searchKey && autoSearchPage) {
-    this.onSearch(...)
-  }
-  
-  // 3. 设置水印
-  if (waterMarkTextContent) {
-    setWaterMark(...)
-  }
-  
-  // 4. 初始化列表视图
-  this.initListView()
-}
-```
-
-- **作用**: 
-  - 注册全局刷新方法（`refreshList_${entityApiKey}`、`refreshListPage_${entityApiKey}`）
-  - 处理自动搜索逻辑
-  - 设置水印
-  - 初始化列表视图
-
-### componentWillReceiveProps
-
-```typescript
-componentWillReceiveProps(nextProps: Readonly<EntityListProps & T>, nextContext: any): void {
-  // 当 requestParams 变化时刷新列表
-  if (JSON.stringify(nextProps.requestParams) !== JSON.stringify(this.props.requestParams)) {
-    this.props.store.initConfigInfo({ requestParams: nextProps.requestParams })
-    this.props.store.refreshListData(this.props.onSearchDataComplete)
-  }
-  
-  // 当 referData 变化时刷新列表
-  if (!isEqual(nextProps.referData, this.props.referData)) {
-    this.props.store.initConfigInfo({ referData: nextProps.referData })
-    this.props.store.refreshListData(this.props.onSearchDataComplete)
-  }
-}
-```
-
-- **作用**: 监听 props 变化，自动刷新列表数据
-- **触发条件**: `requestParams` 或 `referData` 发生变化
-
-### componentDidUpdate
-
-```typescript
-componentDidUpdate() {
-  // 1. 触发列表完成回调
-  if (!this.listLoaded && !initConfiging && !loadDataing) {
-    this.listLoaded = true
-    onListComplete && onListComplete({ listStore: store, listContext: this.context })
-  }
-  
-  // 2. 缓存请求参数（并行优化）
-  if (enableParOpt && pageNo === 1) {
-    cacheDataReqParams()
-  }
-  
-  // 3. 保存布局配置（分步渲染）
-  if (enableStepRender) {
-    setTimeout(() => {
-      saveItemLayoutConfig()
-      saveItemHeight()
-    }, 200)
-  }
-}
-```
-
-- **作用**: 
-  - 触发列表完成回调
-  - 缓存请求参数（性能优化）
-  - 保存布局配置（分步渲染优化）
-
-### componentWillUnmount
-
-```typescript
-componentWillUnmount() {
-  const scoped = this.context as IScopedContext
-  scoped.unRegisterComponent(this)
-}
-```
-
-- **作用**: 从 ScopedContext 中注销组件
-
-## 核心方法详解
-
-### 初始化方法
-
-#### initListView()
-
-初始化列表视图的核心方法，负责：
-
-1. 收集所有配置参数
-2. 初始化 Store 配置信息
-3. 根据 `localConfigLayout` 决定走本地配置还是网络请求
-4. 调用 Store 的 `getEntityListInfo` 或 `initLocalConfig`
-
-```typescript
-initListView() {
-  // 1. 收集参数
-  const { tableType, entityApiKey, store, ... } = this.props
-  
-  // 2. 判断是否启用并行优化
-  const enableParOpt = tableType === 'list' && !isComponents
-  
-  // 3. 初始化 Store 配置
-  store.initConfigInfo({
-    tableType,
-    entityApiKey,
-    enableParOpt,
-    // ... 其他配置
-  })
-  
-  // 4. 根据配置决定走本地还是网络
-  if (localConfigLayout) {
-    store.initLocalConfig(...)
-  } else {
-    store.getEntityListInfo(...)
-  }
-}
-```
-
-#### initNexV2()
-
-初始化 Nex 2.0 扩展实例：
-
-```typescript
-initNexV2() {
-  if (this.isNexV2() && !this.nexInsV2) {
-    const props = {
-      objectApiKey,
-      disableSearch,
-      dataList,
-      listViews,
-      listButton,
-      multiButton,
-      // ... 其他属性
-    }
-    const entityListIns = new EntityListMaster(props)
-    this.nexInsV2 = entityListIns
-    store.setNexInsV2(this.nexInsV2)
-  }
-}
-```
-
-### 数据刷新方法
-
-#### refreshData()
-
-只刷新列表数据（不重新请求配置）：
-
-```typescript
-refreshData = () => {
-  const { store, tableType = 'list' } = this.props
-  
-  // 如果是批量选中状态，切换回正常状态
-  if (tableType === 'list' && store.listStatus === ListViewStatus.MULSELECT) {
-    store.setListViewStatus(ListViewStatus.NORMAL)
-    this.closeOperationView(true)
-  }
-  
-  // 刷新列表数据
-  this.props.store.refreshListData(this.props.onSearchDataComplete)
-}
-```
-
-#### refreshPage()
-
-刷新整个组件（重新请求配置和数据）：
-
-```typescript
-refreshPage = () => {
-  // 1. 滚动到顶部
-  let listViewDom = this.getNeoListViewDom()
-  listViewDom && listViewDom?.neoListViewRef?.scrollTo()
-  
-  // 2. 切换批量选中状态
-  if (tableType === 'list' && store.listStatus === ListViewStatus.MULSELECT) {
-    store.setListViewStatus(ListViewStatus.NORMAL)
-    this.closeOperationView(true)
-  }
-  
-  // 3. 重新初始化列表
-  if (localConfigLayout) {
-    store.initLocalConfig(...)
-  } else {
-    store.getEntityListInfo(...)
-  }
-}
-```
-
-### 筛选相关方法
-
-#### onFilter()
-
-处理筛选逻辑：
-
-```typescript
-onFilter = async (data, showFilters?) => {
-  const { store, onSearchDataComplete, beforeSearch } = this.props
-  
-  // 1. 更新筛选值
-  store.updataFilterValues(data, showFilters, onSearchDataComplete, beforeSearch)
-  
-  // 2. 获取缓存数据
-  let cacheData = await store.universalStorage('get')
-  
-  // 3. 构建筛选对象
-  let filters = {
-    [store.currencySmartViewApiKey]: {
-      timestamp: Date.now(),
-      filters: showFilters ? cloneDeep(showFilters.toJSON()) : cacheData?.filters,
-      filterValues: data
-    }
-  }
-  
-  // 4. 保存到缓存
-  if (!cacheData || !isEqual(cacheData.filters, filters)) {
-    await store.universalStorage('set', filters)
-    store.updateCacheFilter && store.updateCacheFilter()
-  }
-}
-```
-
-#### getTopFilterJson()
-
-获取顶部常用筛选 JSON：
-
-```typescript
-getTopFilterJson = () => {
-  const { store, extFilterItems } = this.props
-  const { currencyFilter, filterValues } = store
-  
-  // 1. 合并扩展筛选项
-  const filters = extFilterItemsFilters.concat([...currencyFilter])
-  
-  // 2. 只取前4个
-  filters.forEach((item, index) => {
-    if (index <= 3) {
-      // 3. 构建筛选项 JSON
-      filterItems.push({
-        type: 'wrapper',
-        label: label,
-        className: className,
-        body: {
-          type: 'neoAction',
-          onClick: () => {
-            // 打开筛选弹窗
-            setModalViewInfo(true, 'filter', itemData, this.getTopFilterModalJson(itemData))
-          }
-        }
-      })
-    }
-  })
-  
-  return filterItems
-}
-```
-
-### 排序相关方法
-
-#### updateListBySort()
-
-更新排序并刷新列表：
-
-```typescript
-updateListBySort = (newCurrentApiKey, newSortType) => {
-  const { store } = this.props
-  const { currentSortApiKey, sortItemListObs } = store
-  
-  if (newSortType === undefined && newCurrentApiKey == currentSortApiKey) {
-    // 如果排序没有变化，只关闭弹窗
-    setModalViewInfo(false, modalType)
-  } else {
-    // 更新排序并刷新
-    const currentSortItem = sortItemListObs.find((element) => element.apiKey === newCurrentApiKey)
-    store.clickSortView(currentSortItem, this.props.onSearchDataComplete)
-  }
-}
-```
-
-### 视图切换方法
-
-#### updateListBySmart()
-
-切换 SmartView 并刷新列表：
-
-```typescript
-updateListBySmart = (newCurrentApiKey, isRefresh: boolean, userSmartCache?) => {
-  const { store, beforeSearch } = this.props
-  const { currencySmartViewApiKey, dataListViewsObs } = store
-  
-  if (newCurrentApiKey !== currencySmartViewApiKey) {
-    // 切换视图
-    const currentSmartItem = dataListViewsObs.find((element) => element.apiKey === newCurrentApiKey)
-    store.clickSmartView(
-      currentSmartItem,
-      this.props.getAllFilterItems,
-      this.props.onSearchDataComplete,
-      userSmartCache,
-      beforeSearch
-    )
-  } else {
-    // 如果视图相同，根据 isRefresh 决定是否刷新
-    if (isRefresh) {
-      store.clickSmartView(...)
-    } else {
-      setModalViewInfo(false, modalType)
-    }
-  }
-  
-  // 更新列表视图状态
-  const neoListViewDom = this.getNeoListViewDom()
-  neoListViewDom && neoListViewDom.setMultiseriate && 
-    neoListViewDom.setMultiseriate(this.listViewStatus[viewNames.indexOf(newCurrentApiKey)])
-}
-```
-
-### 批量操作方法
-
-#### getBulkOperationBtn()
-
-获取批量操作按钮 JSON：
-
-```typescript
-getBulkOperationBtn = () => {
-  const { store } = this.props
-  const { batchBtnList, listStatus } = store
-  
-  if (batchBtnList.length && showBatchButton) {
-    return {
-      type: 'neoAction',
-      icon: 'files_batch_select_32',
-      visible: listStatus != ListViewStatus.MULSELECT,
-      onClick: () => {
-        // 切换到批量选择状态
-        setListViewStatus(ListViewStatus.MULSELECT)
-      },
-      drawer: {
-        // 批量操作抽屉配置
-        body: {
-          type: 'neoBulkOperation',
-          batchButtonList: batchBtnList,
-          operationFinishCallBack: (close, isUpdate) => {
-            if (isUpdate) {
-              store.refreshListData(onSearchDataComplete)
-            }
-            this.closeOperationView(close)
-            setListViewStatus(ListViewStatus.NORMAL)
-          }
-        }
-      }
-    }
-  }
-  return {}
-}
-```
-
-#### updateBulkOperationState()
-
-更新批量操作按钮状态：
-
-```typescript
-updateBulkOperationState = (selectDataId) => {
-  let component = this.context.getComponentByName('neo-list.list_filter_drawer.neoBulkOperation')
-  const disabled = isArray(selectDataId) && selectDataId.length > 0 ? false : true
-  if (component) {
-    component.updateDisableState(disabled)
-  }
-}
-```
-
-### 搜索相关方法
-
-#### onSearch()
-
-打开搜索页面或搜索弹窗：
-
-```typescript
-onSearch = (className, tableType, listStatus, SmartViewApiKey, referData, entity, searchKey?) => {
-  if (tableType === 'lookup') {
-    // Picker 列表使用弹窗
-    NeoNavigator.openDialog({
-      ctx: this.context,
-      className: 'list-search-dialog',
-      bodySchema: [{
-        type: 'neoEntityListSearchDialog',
-        // ... 配置
-      }]
-    })
-  } else {
-    // 大列表使用路由跳转
-    const listSearchPath = '/neo/entityListSearch/:entityApiKey/:tabType'
-    NeoNavigator.openPageWithURL(
-      listSearchPath.replace(':entityApiKey', entity.apiKey).replace(':tabType', tableType),
-      { objectApiKey: entity.apiKey, tableType },
-      {
-        // ... 参数
-      }
-    )
-  }
-}
-```
-
-### 新建相关方法
-
-#### getListOperationBtn()
-
-获取列表操作按钮（新建按钮等）：
-
-```typescript
-getListOperationBtn = () => {
-  const { store, entityTypes } = this.props
-  const { entityBtnList, entityTypes } = store
-  
-  // 如果只有一个新建按钮
-  if (entityBtnList.length === 1 && entityBtnList[0].buttonFunType == 1) {
-    return {
-      type: 'neoAction',
-      icon: 'add_32',
-      actionType: 'actionSheet',
-      onClick: () => {
-        // 显示业务类型选择
-        return true
-      },
-      actionSheet: {
-        optionData: entityTypesVisible,
-        optionClick: (index) => {
-          // 打开新建表单
-          NeoNavigator.openEntityForm(entity.apiKey, 'create', {
-            businessType: entityTypesVisible[index].apiKey,
-            // ... 其他配置
-          })
-        }
-      }
-    }
-  }
-  
-  // 如果有多个按钮，使用抽屉
-  return {
-    type: 'neoAction',
-    icon: 'more_vert_32',
-    actionType: 'drawer',
-    drawer: {
-      body: {
-        type: 'neoBulkOperation',
-        batchButtonList: entityBtnList,
-        // ... 配置
-      }
-    }
-  }
-}
-```
-
-### JSON 生成方法
-
-#### getAmisJson()
-
-生成 amis JSON Schema：
-
-```typescript
-getAmisJson = () => {
-  // 1. 初始化 Nex V2
-  this.initNexV2()
-  
-  // 2. 获取导航栏 JSON
-  let navTitleJson = this.getNavJson()
-  
-  // 3. 构建页面 JSON
-  const listPageJson = {
-    type: 'page',
-    title: navTitleJson,
-    body: this.getListPageJson()
-  }
-  
-  // 4. 如果有 BI 看板，使用 Tabs
-  if (boardInfo && !isOnlyList) {
-    return {
-      type: 'neoTabs',
-      tabs: [
-        { title: '列表', sub: '1' },
-        { title: '智能分析', sub: '2' }
-      ],
-      tabsBody: [listPageJson, biBoardJson]
-    }
-  }
-  
-  return listPageJson
-}
-```
-
-#### getListPageJson()
-
-生成列表页面 JSON：
-
-```typescript
-getListPageJson = () => {
-  return [
-    // 1. SmartView 底部扩展
-    this.getExpandSchema(ExpandSchemasPosition.SMARTVIEW_BOTTOM),
-    
-    // 2. 搜索栏
-    !serchHide && {
-      type: 'neoEntityListSearch',
-      onSubmit: (val) => {
-        if (isSearchAtCurrentPage) {
-          updateProps({ searchKey: val })
-          refreshListData(onSearchDataComplete)
-        }
-      }
-    },
-    
-    // 3. 排序筛选栏
-    {
-      type: 'neoHBox',
-      name: 'neoSmartSort',
-      body: this.getTopToolbar(),
-      visible: showTopView && !disableSortFilterView
-    },
-    
-    // 4. 顶部筛选
-    {
-      type: 'neoHBox',
-      name: 'neoTopFilter',
-      body: this.getTopFilterJson(),
-      visible: showTopView && topFilterJson.length > 0
-    },
-    
-    // 5. 列表视图
-    this.getListViewJson(),
-    
-    // 6. 底部操作按钮
-    this.getListOperationBtn(),
-    
-    // 7. 汇总合计
-    this.getSummary()
-  ]
-}
-```
-
-## 使用示例
-
-### 示例 1: 基础大列表
-
-```typescript
-import EntityList from '@/components/List/EntityList/component'
-import { EntityListStore } from '@/components/Store/list'
-
-// 创建 Store 实例
-const store = EntityListStore.create({
-  // Store 初始化配置
-})
-
-// 渲染组件
-<EntityList
-  name="entityList"
-  entityApiKey="account"
-  objectApiKey="account"
-  tableType="list"
-  store={store}
-  onItemClickIntercept={(data, entity) => {
-    // 自定义点击处理
-    console.log('点击了列表项', data)
-    return false // 返回 false 继续执行默认逻辑
-  }}
-  onSearchDataComplete={(data) => {
-    // 搜索数据完成回调
-    console.log('搜索完成', data)
-  }}
-/>
-```
-
-### 示例 2: Picker 列表（表单关联选择）
-
-```typescript
-<EntityList
-  name="entityList"
-  entityApiKey="contact"
-  objectApiKey="contact"
-  tableType="lookup"
-  store={store}
-  referData={{
-    // Picker 相关数据
-    referItemId: 'xxx',
-    referItemApiKey: 'accountId'
-  }}
-  selectionMode="multiple"
-  selectMaxCount={10}
-  onItemClickIntercept={(data, entity, isGoback) => {
-    // 选择后回调
-    console.log('选择了数据', data)
-    return false
-  }}
-/>
-```
-
-### 示例 3: 相关列表（详情页）
-
-```typescript
-<EntityList
-  name="entityList"
-  entityApiKey="opportunity"
-  objectApiKey="opportunity"
-  tableType="refer"
-  store={store}
-  isComponents={true}
-  referConditions={[
-    {
-      apiKey: 'accountId',
-      type: 10, // IN 操作符
-      value: detailData.id
-    }
-  ]}
-  detailData={detailData}
-  extendInitParams={{
-    objectId: detailData.id
-  }}
-/>
-```
-
-### 示例 4: 自定义筛选和排序
-
-```typescript
-<EntityList
-  name="entityList"
-  entityApiKey="account"
-  objectApiKey="account"
-  tableType="list"
-  store={store}
-  // 扩展筛选项
-  extFilterItems={[
-    {
-      apiKey: 'customField',
-      label: '自定义字段',
-      itemType: 1 // 文本类型
-    }
-  ]}
-  // 筛选变化监听
-  filterListener={(filterValues) => {
-    console.log('筛选值变化', filterValues)
-  }}
-  // 搜索前回调
-  beforeSearch={(params) => {
-    // 可以修改搜索参数
-    return params
-  }}
-/>
-```
-
-### 示例 5: 批量操作
-
-```typescript
-<EntityList
-  name="entityList"
-  entityApiKey="account"
-  objectApiKey="account"
-  tableType="list"
-  store={store}
-  // 批量操作按钮点击拦截
-  bulkOperationBtnClick={(btnInfo, selectData, context) => {
-    console.log('批量操作', btnInfo, selectData)
-    // 返回 true 拦截默认逻辑，false 继续执行
-    return false
-  }}
-  // 底部按钮拦截
-  onBottomBtnIntercept={(btnInfo, context) => {
-    if (btnInfo.apiKey === 'customBtn') {
-      // 自定义处理
-      return true // 拦截
-    }
-    return false
-  }}
-/>
-```
-
-### 示例 6: 当前页搜索
-
-```typescript
-<EntityList
-  name="entityList"
-  entityApiKey="account"
-  objectApiKey="account"
-  tableType="list"
-  store={store}
-  isSearchAtCurrentPage={true}
-  searchKey={searchKey}
-  onSearchDataComplete={(data) => {
-    console.log('搜索完成', data)
-  }}
-/>
-```
-
-### 示例 7: 扩展布局
-
-```typescript
-<EntityList
-  name="entityList"
-  entityApiKey="account"
-  objectApiKey="account"
-  tableType="list"
-  store={store}
-  getHeaderExpand={({ store, api }) => {
-    return [
-      {
-        position: ExpandSchemasPosition.SMARTVIEW_BOTTOM,
-        schema: {
-          type: 'wrapper',
-          body: '自定义内容'
-        }
-      },
-      {
-        position: ExpandSchemasPosition.LIST_BOTTOM,
-        schema: {
-          type: 'button',
-          label: '自定义按钮',
-          onClick: () => {
-            console.log('点击了自定义按钮')
-          }
-        }
-      }
-    ]
-  }}
-/>
-```
-
-### 示例 8: Nex 2.0 扩展
-
-```typescript
-<EntityList
-  name="entityList"
-  entityApiKey="account"
-  objectApiKey="account"
-  tableType="list"
-  store={store}
-  nexVersion={2}
-  dataList={{
-    beforeFieldRender: (event) => {
-      // 字段渲染前处理
-      const { apiKey, rowData } = event.data
-      if (apiKey === 'name') {
-        // 自定义处理
-      }
-      return null
-    },
-    listItem: [
-      {
-        apiKey: 'customField',
-        label: '自定义字段'
-      }
-    ]
-  }}
-  listButton={[
-    {
-      apiKey: 'customBtn',
-      label: '自定义按钮',
-      onClick: (event) => {
-        console.log('按钮点击', event)
-      }
-    }
-  ]}
-/>
-```
-
-### 示例 9: 本地配置（不请求网络）
-
-```typescript
-<EntityList
-  name="entityList"
-  entityApiKey="account"
-  objectApiKey="account"
-  tableType="list"
-  store={store}
-  localConfigLayout={({ tableType, entityApiKey }) => {
-    // 返回本地配置
-    return {
-      entity: {
-        apiKey: 'account',
-        label: '客户'
-      },
-      dataListViews: [
-        {
-          apiKey: 'default_view',
-          label: '默认视图',
-          config: {
-            viewItems: [
-              { apiKey: 'name', label: '名称' },
-              { apiKey: 'phone', label: '电话' }
-            ]
-          }
-        }
-      ],
-      // ... 其他配置
-    }
-  }}
-/>
-```
-
-### 示例 10: 完整配置示例
-
-```typescript
-import EntityList from '@/components/List/EntityList/component'
-import { EntityListStore } from '@/components/Store/list'
-import { ExpandSchemasPosition } from '@/components/List/EntityList/interface'
-
-// 创建 Store
-const store = EntityListStore.create({
-  // Store 配置
-})
-
-// 渲染组件
-<EntityList
-  // 基础配置
-  name="accountList"
-  entityApiKey="account"
-  objectApiKey="account"
-  tableType="list"
-  store={store}
-  titleName="客户列表"
-  className="custom-list"
-  
-  // 功能配置
-  isSearchAtCurrentPage={false}
-  disableTopView={false}
-  disableSortFilterView={false}
-  isOnlyList={false}
-  enableCache={true}
-  
-  // 数据配置
-  requestParams={{
-    searchParams: {
-      conditions: [
-        { apiKey: 'status', type: 1, value: 'active' }
-      ]
-    }
-  }}
-  extFilterItems={[
-    { apiKey: 'customField', label: '自定义字段', itemType: 1 }
-  ]}
-  
-  // 事件回调
-  onItemClickIntercept={(data, entity) => {
-    console.log('点击项', data)
-    return false
-  }}
-  onSearchDataComplete={(data) => {
-    console.log('搜索完成', data)
-  }}
-  onPageComplete={(event) => {
-    console.log('页面完成', event)
-  }}
-  beforeSearch={(params) => {
-    // 修改搜索参数
-    return params
-  }}
-  
-  // 扩展配置
-  nexVersion={2}
-  getHeaderExpand={({ store, api }) => {
-    return [
-      {
-        position: ExpandSchemasPosition.SMARTVIEW_BOTTOM,
-        schema: {
-          type: 'wrapper',
-          body: '扩展内容'
-        }
-      }
-    ]
-  }}
-  
-  // 批量操作
-  bulkOperationBtnClick={(btnInfo, selectData, context) => {
-    console.log('批量操作', btnInfo, selectData)
-    return false
-  }}
-  
-  // 自定义按钮
-  customOperationBtn={(entity) => {
-    return {
-      type: 'button',
-      label: '自定义操作',
-      onClick: () => {
-        console.log('自定义操作')
-      }
-    }
-  }}
-/>
-```
-
-## 扩展机制
-
-### Nex 1.0 扩展
-
-通过 `nexIns` 进行扩展，主要扩展点：
-
-1. **dataList**: 数据列表扩展
-   - `fields`: 字段扩展
-   - `beforeFieldRender`: 字段渲染前处理
-   - `buttonGroup`: 按钮组扩展
-
-2. **listViews**: 视图扩展
-   - `disableSwitch`: 禁用视图切换
-
-3. **listButton**: 列表按钮扩展
-
-4. **multiButton**: 批量操作按钮扩展
-
-### Nex 2.0 扩展
-
-通过 `nexInsV2` 进行扩展（`nexVersion=2`），主要扩展点：
-
-1. **dataList**: 
-   - `listItem`: 列表项字段配置
-   - `beforeFieldRender`: 字段渲染前处理（事件形式）
-
-2. **listViews**: 
-   - `disableSwitch`: 禁用视图切换
-
-3. **listButton**: 列表按钮扩展（事件形式）
-
-4. **multiButton**: 批量操作按钮扩展（事件形式）
-
-### 扩展布局
-
-通过 `getHeaderExpand` 在指定位置插入扩展 Schema：
-
-```typescript
-enum ExpandSchemasPosition {
-  SMARTVIEW_BOTTOM = 'smartview-bottom',      // SmartView 下方
-  SEARCHLAYOUT_BOTTOM = 'searchlayout-bottom', // 搜索栏下方
-  FILTER_BOTTOM = 'filter-bottom',            // 筛选下方
-  LIST_BOTTOM = 'list-bottom'                 // 列表下方
-}
-```
-
-### 扩展实例获取
-
-通过 `getInstanceForNex()` 获取扩展实例：
-
-```typescript
-const instance = this.getInstanceForNex()
-const dataList = instance.getComponentsByName('dataList')[0]
-const buttonGroup = instance.getComponentsByName('buttonGroup')[0]
-
-// 调用扩展方法
-buttonGroup.setAttribute('actions', newActions)
-```
-
-## 注意事项
-
-### 1. Store 初始化
-
-- Store 必须在组件外部创建，不能每次渲染都创建新实例
-- Store 需要正确初始化配置信息
-
-### 2. 列表类型区分
-
-- `tableType='list'` + `isComponents=false`: 大列表
-- `tableType='list'` + `isComponents=true`: 数据列表组件
-- `tableType='refer'` + `isComponents=false`: 二级列表
-- `tableType='refer'` + `isComponents=true`: 相关列表组件
-
-### 3. 必传参数
-
-- **大列表**: `entityApiKey`、`store`、`name`
-- **相关列表**: `referConditions`（必传）
-- **Picker 列表**: `referData`（必传）
-
-### 4. 性能优化
-
-- 启用并行优化（`enableParOpt`）可以提升大列表加载速度
-- 启用分步渲染（`enableStepRender`）可以优化首屏渲染
-- 合理使用缓存（`enableCache`）
-
-### 5. 批量操作限制
-
-- 批量操作最多选择 20 条数据
-- Picker 列表可以通过 `selectMaxCount` 自定义最大选择数
-
-### 6. 筛选缓存
-
-- 筛选条件会自动缓存到本地存储
-- 切换视图时会恢复之前的筛选条件
-
-### 7. 错误处理
-
-- 组件会自动处理错误并显示错误提示
-- 初始化错误会自动返回上一页
-- 搜索错误会留在当前页
-
-### 8. 水印设置
-
-- 如果启用了全局水印（`globalWaterMark=false`），组件会自动添加水印
-- 水印会添加到 `.neo-list-container` 容器上
-
-## 常见问题
-
-### Q1: 如何自定义列表项样式？
-
-**A**: 通过 `style` 属性传入自定义样式：
-
-```typescript
-<EntityList
-  style={{
-    '.a-Neo-List-View-Item-Wrapper': {
-      margin: '0!important',
-      padding: '10px !important'
-    }
-  }}
-/>
-```
-
-### Q2: 如何拦截列表项点击事件？
-
-**A**: 使用 `onItemClickIntercept` 回调：
-
-```typescript
-<EntityList
-  onItemClickIntercept={(data, entity) => {
-    // 自定义处理逻辑
-    // 返回 false 继续执行默认逻辑，true 拦截
-    return false
-  }}
-/>
-```
-
-### Q3: 如何动态刷新列表数据？
-
-**A**: 使用全局刷新方法：
-
-```typescript
-// 只刷新数据
-window.refreshList_${entityApiKey}({ objectApiKey: entityApiKey })
-
-// 刷新整个页面（重新请求配置）
-window.refreshListPage_${entityApiKey}({ objectApiKey: entityApiKey })
-```
-
-### Q4: 如何自定义新建按钮？
-
-**A**: 通过 `createBtn` 属性：
-
-```typescript
-<EntityList
-  createBtn={{
-    label: '自定义新建',
-    icon: 'custom-icon',
-    onClick: () => {
-      // 自定义逻辑
-    }
-  }}
-/>
-```
-
-### Q5: 如何禁用某些功能？
-
-**A**: 使用对应的禁用属性：
-
-```typescript
-<EntityList
-  disableSearch={true}        // 禁用搜索
-  disableTopView={true}       // 隐藏搜索、排序、筛选
-  disableSortFilterView={true} // 隐藏排序、筛选
-  disabledSort={true}         // 禁用排序
-  disabledFilter={true}        // 禁用筛选
-/>
-```
-
-### Q6: 如何获取当前选中的数据？
-
-**A**: 通过 Store 获取：
-
-```typescript
-const selectedData = store.selectData
-```
-
-### Q7: 如何切换 SmartView？
-
-**A**: 通过 Store 方法：
-
-```typescript
-const smartView = store.dataListViews.find(view => view.apiKey === 'targetView')
-store.clickSmartView(smartView, getAllFilterItems, onSearchDataComplete)
-```
-
-### Q8: 如何添加自定义筛选项？
-
-**A**: 使用 `extFilterItems`：
-
-```typescript
-<EntityList
-  extFilterItems={[
-    {
-      apiKey: 'customField',
-      label: '自定义字段',
-      itemType: 1, // 字段类型
-      // ... 其他配置
-    }
-  ]}
-/>
-```
-
-### Q9: 如何处理相关列表新建？
-
-**A**: 需要传入 `detailData` 和 `extendInitParams`：
-
-```typescript
-<EntityList
-  tableType="refer"
-  detailData={detailData}
-  extendInitParams={{
-    objectId: detailData.id
-  }}
-  isNeedExtraParams={({ relateEntityApiKey, createEntityApikey }) => {
-    // 判断是否需要额外参数
-    return true
-  }}
-/>
-```
-
-### Q10: 如何使用 Nex 2.0 扩展？
-
-**A**: 设置 `nexVersion=2` 并传入扩展配置：
-
-```typescript
-<EntityList
-  nexVersion={2}
-  dataList={{
-    beforeFieldRender: (event) => {
-      // 处理逻辑
-    },
-    listItem: [...]
-  }}
-  listButton={[...]}
-  multiButton={[...]}
-/>
-```
-
-## 总结
-
-`EntityList` 是一个功能强大的列表组件，提供了完整的数据展示、筛选、排序、批量操作等功能。通过合理的配置和扩展，可以满足各种业务场景的需求。在使用时需要注意：
-
-1. 正确初始化 Store
-2. 根据业务场景选择合适的 `tableType`
-3. 合理使用扩展机制
-4. 注意性能优化配置
-5. 正确处理事件回调
-
-更多详细信息请参考组件源码和接口定义。
-