KsQueryTable

移动端 QueryTable

Release Log

v0.4.7

• 表格可滚动距离为0时，滑动触发的滚动距离直接返回0

v0.4.6

• 个性设置下线 配置工具 功能
• 表格配置 config.url 时，默认展示空白（而不是无结果）

v0.4.5

• 解决 cell-click 事件回传的 rowData 修改了无法同步变更页面的问题

v0.4.4

• 折叠列：
  • 父级列被折叠收起时，子级列同时收起；父级列被折叠展开时，子级列按收起前的状态恢复
  • 子级列的折叠展开/收起，不联动父级列被折叠展开/收起，此逻辑表现为背景色变化

v0.4.3

• 折叠列：
  • 多级表头场景：支持父级列折叠子级列
  • 调整个性设置折叠展示的优先级为：分组列 > 子级列 > 折叠列
• 分组列：下线分组开始列和结束列的 CSS类 标记（CSS类名：group-start/group-end）
• 多级表头：下线多级表头父级背景色逻辑（props：isOpenTwoHeaderBg）

v0.4.2

• afterHttp 回调函数添加第二个参数，返回请求的 url、params、options
• updateColumns 方法的 keepCollapseStatus 设置为 true 时，手动折叠操作的数据可以被传入的覆盖
• 解决点击列表空白区域报错的问题

v0.4.1

• 支持单元格合并
• 解决手指持续滑动超出表格范围后，表格不会继续滚动的问题
• 拖拽列宽长按失效监控
• 引入 v0.3.16 ~ v0.3.21 修改

v0.4.0

• 调整列排序算法
  • 合并用户个人配置（个性设置保存的配置）时，先清除已下线的字段（确保列的顺序是连贯的，避免合并时位置错乱）
  • 有用户个人配置时，新增的列按照新增的位置顺序全部放到最后面（无论是否有沉底逻辑）
  • 默认禁用不可见列自动沉底（之前的版本是默认自动沉底）
• 调整多端同步逻辑
  • 直接用通用查询配置进行合并，确保新增列也能同步到
  • 优化配置拉取逻辑，支持动态添加新的同步配置（旧逻辑需要预先拉取全部同步配置）

v0.3.21

• 个性设置支持多级折叠

v0.3.20

• 支持配置 config.scrollLoad.idsPageSize 设置全量ID请求的分页大小

v0.3.19

• 个性设置弹窗宽度自适应优化
  • 新增 settings.widthInWidescreen 属性，用于控制宽度自适应方式，支持值：
    • 50%-（默认）指定宽度
    • auto-按显示内容适配（折叠收起不计算）
    • max-content-按最大内容适配（包含计算折叠收起部分）
  • 废弃 settingDialogWidth 属性，使用 settings.widthInWidescreen 替代
• 单元格内容超出气泡、表头气泡支持外部通过 closeAllPopover 方法手动关闭，也会在数据重新拉取时自动关闭
• 优化 updateColumns 方法，支持传入第二个参数 options = { keepScrollOffset, keepCollapseStatus }
  • keepScrollOffset：是否保持滚动位置
  • keepCollapseStatus：是否保持折叠状态
  • 默认调用 updateColumns 方法会重置滚动位置和折叠状态

v0.3.18

• 解决表格滚动到右边界时，拖拽调小列宽导致右侧出现空白的问题
• 优化拖拽列宽长按的逻辑，保证长按充足的时间后必定触发拖拽

v0.3.17

• 全局配置 KsQueryTable.config 扩展到所有内部接口
• 拖拽列宽逻辑优化，确保内部数据的一致性，解决手动修改列宽不生效的问题
• 添加 updateResizeColumnMap 方法，支持外部手动修改列宽
• 添加 getOnlineColumn 方法，可通过列的 key 获取对应的列配置
• 优化 updateColumns 方法，改成递归处理所有的子列，支持更多级表头

v0.3.16

• 个性设置支持列配置 expand 控制默认折叠状态
• 单元格气泡逻辑优化，即使单元格拖拽过大小，也能保证气泡展示位置准确

v0.3.15

• 兼容列配置 width 属性为字符串的场景，解决气泡位置计算错误的问题
• 支持通过 KsQueryTable.config 全局配置表格内接口的 headers
• 调整表格总数的计算方式，解决通过 spliceTableData 插入/删除行数据后，滚动分页导致总数计算错误的问题
• 支持 totalProgress 独立设置滚动页码器的当前位置

v0.3.14

• 个性设置列名搜索交互优化

v0.3.13

• 配置工具页面用 sortablejs 替换 vuedraggable，减少整体包大小（约30K）

v0.3.12

• 个性设置：支持列名搜索
• 对外释放 initGenericSearch 方法，外部可用此方法与表格共用返回的通用查询配置

v0.3.11

• 添加 forceScrollYInHorizontal 控制横屏时是否强制允许滚动

v0.3.10

• 解决固定列之间的间隙问题
• 添加支持 drawColumnOptions 配置自定义渲染函数，功能覆盖 rowCellRenderOptions、headerCellRenderOptions，并额外支持配置单元格气泡的自定义渲染 popoverContent

v0.3.9

• 个性设置：小红点展示时，名称文案超长不会弹出气泡的问题修复

v0.3.8

• 添加 autoResetScrollTop 控制加载数据时是否滚动回顶部，默认为 true

v0.3.7

• 列初始化逻辑添加日志输出，可通过 @logger 事件接收

v0.3.6

• 边框不触发事件
• 修改导出 pe-table 的方式，并添加常用方法的导出
• 修改 beforeHttp 返回的 params.orderByClauses 支持的类型，改成只支持传入有长度的数组

v0.3.5

• 高亮行改成 pointerdown + pointerup 组合模拟的点击事件触发，而不是直接通过 pointerup 事件触发，避免滑动时直接高亮

v0.3.4

• 高亮行
  • 高亮行改成不常用的 pointerup 事件，减少被自定义单元格的事件阻止冒泡拦截
  • 点击复选框不高亮当前行

v0.3.3

• 高亮行
  • 更换高亮行的默认颜色
  • 对外暴露主动高亮行方法：highlightRow
• 折叠列展开底色更换
• beforeHttp 返回的 params.orderByClauses 允许是空数组和 null
  • 空数组：请求参数中包含字段 orderByClauses, 且值为空数组 []
  • null：请求的参数中不包含字段 orderByClauses

v0.3.2

• 支持盘中权限
  • 盘中行权限：无结果时，检查请求头是否包含盘中权限信息，有的话按照盘中无权限提示
  • 盘中字段权限：内容展示为雪花，蓝色，可点击，点击后弹窗提示盘中无权限
• 复选框样式兼容处理：appearance 属性添加浏览器前缀
• 滚动节流逻辑优化：touchstart 的时候，lastMoveTime 应设置为0，确保首次 touchmove 能够完整执行

v0.3.1

• beforeHttp 支持返回 params.orderByClauses 自定义请求时的排序参数

v0.3.0

• 支持复选框列
  • showSelection：显示复选框列
  • selectable：是否可选
  • @select-change：选中事件
  • @select-all：全选事件
  • toggleAllSelection：切换全选
  • toggleRowSelection：切换单行的选中态
  • toggleMultiRowsSelection：切换多行的选中态
  • clearSelection：清空选中
  • getSelectionRows：获取选中的行
• 支持自定义内置列配置
  • builtinColumns：内置列配置 - 索引列、复选框列
• 全量ID滚动，添加 config.scrollLoad.preloadOffsetViewport 设置预加载触发冗余位置（偏移多少屏）

v0.2.14

• 列初始化逻辑完全区分多端同步逻辑
• 个性设置内的开关样式微调
• 解决滚动到底部后，上划再横划，“没有更多了”没有收起的问题

v0.2.13

• 个性设置禁用列编辑功能完善
  • 重置、确认 没有限制列信息提交的问题修复
  • 拖拽调序功能禁用
• beforeInitColumns 按异步函数处理

v0.2.12

• 个性设置
  • settings.enableSelectAll：是否启用全选，可同时切换全部列的显示和隐藏
  • settings.saveOnlyModified：是否变更后保存，个性设置点“确认”时，仅在列的数据变更时才提交后台
  • settings.disableColumnsEdit：是否禁用列编辑：排序、显示/隐藏、多端同步、全选；同时，重置 和 确认 不会提交列信息
  • settings.disableColumnsEditMessage：禁用列编辑时，点击的提示信息
  • settings.disableReset：是否禁用重置按钮，禁用后点击不会触发回调事件，仅执行禁用提示
  • settings.disableResetMessage：禁用重置按钮时，点击的提示信息
• 切换 searchCode 变更列配置时，强制调接口拉取最新配置

v0.2.11

• 抽屉布局横屏后表格不滚动问题修复

v0.2.10

• 抽屉布局边界判断调整，增加 1px 冗余计算

v0.2.9

• 滚动连锁调整：滚动到边界后，不会直接滚动容器，而是要再次滑动才会滚动容器

v0.2.8

• 滚动连锁：表格滚动到边界后，才开始滚动容器
  • overscroll：是否开启滚动连锁，默认不开启，表格滚动会带动容器一起滚动
  • movePropagation：是否冒泡触发滚动的 touchmove 事件
• 边界惯性优化：滚动到表格的边界后，调整惯性滚动的系数
  • 顶部、左边、右边，因为不需要弹性回弹，直接中断惯性逻辑
  • 底部有弹性回弹，但不需要滚动很多，调整系数为 0.5

v0.2.6

• 调整内置的抽屉布局实现
  • 修改事件监听方式，改成仅监听内置的布局容器
  • 修改滚动事件的逻辑，表格和布局滚动时，阻止冒泡，仅在触顶和触底时正常冒泡，避免表格和布局滚动时拖动到外部（如：下拉刷新）
• 修改监听尺寸变化的实现，直接通过 $refs 的方式引用元素，确保引用元素的准确（用固定布局嵌套表格，querySelector 会查错元素）

v0.2.5

• 列配置的过滤器 filter 支持传入数组：按顺序执行，后一个过滤器以前一个过滤器的返回值作为入参
• 添加内置过滤器 formatEmpty，支持检查空值，并指定占位符

v0.2.4

• 表格内容同时触达左边界和右边界时，尺寸变化时应以左边界为准

v0.2.3

• 全量ID滚动，添加 config.scrollLoad.idsSendHttp 方法支持自定义拉取全量ID

v0.2.2

• 全量ID滚动，允许传入下一页预加载数量（config.scrollLoad.preloadNextPageSize）

v0.2.1

• 支持 beforeInitColumns 钩子，可以在初始化列的时候修改最终展示的列数据

v0.2.0

• 个性设置支持多端同步
  • syncColumns：同步列配置，只有 menuId 和 searchCode 同时存在才开启同步列功能
    • syncColumns.menuId：与本表格同步配置的目标 menuId
    • syncColumns.searchCode：与本表格同步配置的目标 searchCode
  • 开启多端同步后，个性设置弹框将会展示同步按钮
• 添加 customParams 入参，允许用户传入自定义的参数用于列渲染

v0.1.25

• beforeHttp、idsBeforeHttp、scrollBeforeHttp 支持返回 options 参数，用于 http 请求

v0.1.24

• 释放单元格宽度拖拽变动事件 cell-resize
• 调整表头、单元格提示的主题名，添加单词换行样式

v0.1.23

• 支持 spliceTableData 方法，用于插入/删除表格的行数据
• 支持三级表头及以上的渲染计算
• 调整有父节点横向滑动到无父节点场景的判断逻辑
• 将 pe_timestamp 传给 beforeHttp、idsBeforeHttp 回调方法
• 传入 maxHeight 时支持动态高度，可随着内容实时变化（旧逻辑只在初始化时调整高度）
• settingsConfirm 回调事件不再等待配置同步到后台

v0.1.22

• 调整 scrollToColumn 的跳转逻辑，解决表格惯性滚动时调用此方法跳转不准确的问题
• beforeSort 添加透出参数 reqProp，表示真实的排序请求字段

v0.1.21

• 调整 updateTableData 的数据唯一键 idsKey 的默认值为 'id'（原本是 'code'）
• 调整字段解密的数据唯一键为 bizIdKey || idsKey

v0.1.20

• 完善解密事件 decrypt 的透出参数，添加 isFixRow、decryptData

v0.1.19

• 修复解密后，调用 updateTableData 会重新变成加密字段的问题

v0.1.18

• 分组标记起始列和结束列的逻辑调整

v0.1.17

• 支持分组功能：
  • 列配置添加 groupKeys，用于配置被分组的列
  • 列配置添加 virtual，与 groupKeys 配合，指定当前分组列为虚拟分组列（虚拟分组列在表格中不展示，在个性设置中展示）
  • 被分组的列，在表格展示时会集中到一起，依照定义的顺序放到分组列后面
  • 在个性设置中，同一分组的列只允许内部调序，或者整体一起调序
• 调用 updateColumns 更新列时，依然要保持用户拖拽的宽度

v0.1.16

• 支持传入 disableSinkColumns，用于禁用隐藏列自动沉底功能
• 修复文本伸缩列失效的问题
• 表格内容滚动到最右边后，尺寸变化时应保持内容在最右边的位置
• 表格内监听竖屏状态宽高变化的逻辑整理，单独一个 mixin 管理

v0.1.14

• 支持传入 tableClassName，内部将其添加到 pe-table 的顶层容器上，可用于修改表格样式等

v0.1.13

• 修复非滚动吸顶布局场景切横屏再切回竖屏，表格无法滚动的问题
• 调整表格容器（.table 元素）高度的适配方式，确保按照父元素的高度伸缩计算
• 对外释放 resize 方法，用于重置表格的宽高

v0.1.12

• 关闭横屏方法 closeHorizontal 内添加判断当前是否是横屏状态
• 加解密
  • 点击解密后发出 decrypt 事件
  • 内置支持 监控 字段展示为蓝色
  • 支持自动解密功能
• 列配置
  • 支持 searchCode 变更时刷新列（会保持原本的排序）
  • 支持配置 key = a.b 的形式时，读取数据按照嵌套的方式读取，如 rowData.a.b
• 支持激活行（activeRows）逻辑，外部传入行 ID 列表激活特定的行，内部给这些行添加 active 样式类
• loadData 加载数据后，不覆盖原始数据的 id 字段
• updateTableData 支持不配置 config.scrollLoad 的场景

v0.1.11

• 排序：beforeSort 返回指定的排序参数时， 组件内的排序状态同步调整

v0.1.10

• 折叠列：表格没有数据时也允许折叠
• 表头提示：headerTip，配置后展示小问号，点击展示提示文案
• 文本伸缩列：columns 内配置 textFlexWidget、delimiter、defaultTextFlexLevel
• 点击高亮行：点击表头报错问题修复
• 列表滚动：更换新算法
• 行数据部分字段更新：updateTableData 内更新队列相同 code 的合并逻辑调整

v0.1.9

• 权限列调整：authColumns
• 单元格内容超长的 Tips 调整：左右间距最少 10px；最大宽度 320px
• 个性设置在折叠屏支持动态宽度：settingDialogWidth

功能列表（v0.1.9 之前汇总）

• 滚动
  • 触底加载更多的无限滚动
  • 已有全部数据 ID 的无限滚动
• 分页
  • 内置分页器
• 排序
  • 展示字段与排序字段不同
  • 请求前修改排序参数
  • 前端排序
• 列
  • 固定列
  • 序号列
  • 折叠列
  • 权限列
  • 更新列数据：updateColumns
• 行
  • 固定行
    • 固定上、固定下
    • 空列表展示固定行
  • 更新行数据（只更新，不会新增和删除）：updateTableData
• 单元格
  • 内容超长时，点击展示气泡，显示完整内容
  • 过滤器
  • 解密
• 横竖屏
  • 横竖屏切换：单个页面内的表格横竖屏切换
  • 横屏切横屏：横屏模式下跳转到下一个页面，依然保持横屏模式
• 个性设置
  • 列的显示/隐藏
  • 列的顺序