rj-grid 0.2.3 → 0.2.4

package/README.md

@@ -5,7 +5,7 @@
 <h1 align="center">rj-grid</h1>
 
 <p align="center">
-  <b>零第三方依赖的企业级 Vue 3 数据网格 —— 对标 AG Grid 的全功能，MIT 免费、gzip 约 93 KB。</b><br/>
+  <b>零第三方依赖的企业级 Vue 3 数据网格 —— 对标 AG Grid 的全功能，MIT 免费、gzip 约 110 KB。</b><br/>
   虚拟滚动 · 冻结列 · 分组透视 · 树形 · 编辑撤销 · 公式引擎 · SSRM 服务端行模型 · 主题 & i18n · 打印/CSV/Excel/PDF · 离线自然语言查询（NLQ）
 </p>
 
@@ -15,9 +15,9 @@
   <a href="https://gitee.com/rjding/rj-grid"><img src="https://img.shields.io/badge/Gitee-rj--grid-orange?logo=gitee&logoColor=white" alt="Gitee mirror"/></a>
   <a href="https://github.com/rjding/rjGrid/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License MIT"/></a>
   <a href="https://gitee.com/rjding/rj-grid"><img src="https://img.shields.io/badge/third--party%20deps-0-blue.svg" alt="Zero dependencies"/></a>
-  <img src="https://img.shields.io/badge/gzip-~93KB-lightgrey.svg" alt="Bundle size"/>
+  <img src="https://img.shields.io/badge/gzip-~110KB-lightgrey.svg" alt="Bundle size"/>
   <a href="https://vuejs.org/"><img src="https://img.shields.io/badge/vue-3.x-brightgreen.svg?logo=vuedotjs" alt="Vue 3"/></a>
-  <img src="https://img.shields.io/badge/tests-346%20passed-yellowgreen.svg" alt="Tests"/>
+  <img src="https://img.shields.io/badge/tests-407%20passed-yellowgreen.svg" alt="Tests"/>
   <img src="https://img.shields.io/badge/types-TypeScript-blue.svg?logo=typescript" alt="TypeScript"/>
 </p>
 
@@ -38,7 +38,7 @@
 想象一下：一个 `<rj-grid>` 标签，就能替换掉你项目里那些「几万行就卡死、想加个分组又得换库」的表格——而**不额外引入任何第三方依赖**，也不用给商业表格库交授权费。
 
 - **真·零依赖**：运行时只需 `vue`，连可选的图表都是按需 `import('echarts')`。不捆绑、不污染你的 lockfile。
-- **小得离谱**：gzip 约 93 KB，却装下了别人几个库加起来的功能量。
+- **小得离谱**：gzip 约 110 KB，却装下了别人几个库加起来的功能量。
 - **10 万行丝滑**：行列双向虚拟滚动，实测 100,000 行 × 12 列秒开（生成仅约 12 ms）。
 - **对标 AG Grid 全功能**：树形 / 分组 / 透视 / SSRM / 公式 / 主题 / i18n / 导出 / NLQ 一应俱全。
 - **TypeScript 原生**：完整的类型推导与 `.d.ts`，编辑器全程提示，不是「先跑起来再说」的糙活。
@@ -50,14 +50,14 @@
 
 | 分类 | 你会得到的能力 |
 |---|---|
-| 渲染 | 行列虚拟滚动（10 万行流畅）、冻结列、多级表头、密度三档、钉行、全宽行 |
+| 渲染 | 行列虚拟滚动（10 万行流畅）、冻结列、多级表头、密度三档、钉行、全宽行；**单击单元格即选中行**（`selectOnCellClick`，无需勾复选框） |
 | 数据 | 客户端 / 分页 / 无限滚动 / **SSRM 服务端行模型**（按需块缓存）四种模式 |
 | 分组 | 树形任意深度、拖拽分组、多级分组 + 组页脚聚合、列透视（含高基数护栏） |
 | 编辑 | 8 类编辑器、校验、撤销/重做、批量事务回填、内置新增/编辑行弹窗 |
 | 公式 | 零依赖 Excel 风格公式：`=B2*C2`、`SUM/COUNTIF/SUMIF`、区域引用、循环引用检测 |
 | 筛选 | 列头漏斗 / 浮动筛选行 / 快速搜索 / 高级过滤（跨列 AND/OR 表达式树）四路叠加 |
 | 外观 | 主题引擎（4 预设 × 明暗 × 强调色 × 自定义 CSS 变量）、i18n（中/英 + 文案覆盖）、图标替换 |
-| 输出 | 打印 / CSV / Excel / PDF，支持选中行 / 当前视图 / 后端导出三种范围 |
+| 输出 | 打印 / CSV / Excel / PDF，支持选中行 / 当前视图 / 后端导出三种范围；四个按钮可逐个显隐（`showPrint`/`showCsv`/`showPdf`/`showExcel`） |
 | AI | 纯离线确定性 **NLQ**，中英双语随 i18n 切换：中文用「数量大于50 按单价降序」、英文用 `qty > 50 sort by price desc`，回显随语言 |
 | 状态 | `stateKey` 自动持久化 + `getState/setState` 编程式存取，刷新不丢视图 |
 
@@ -206,7 +206,7 @@ const rows: RjRowData[] = [
 |---|---|---|
 | 授权 / 费用 | ✅ MIT 完全免费 | ⚠️ 企业级特性需商业授权 |
 | 第三方运行时依赖 | ✅ 仅 `vue` | ⚠️ 自带框架与模块体系 |
-| gzip 体积 | ✅ 约 93 KB | 显著更大 |
+| gzip 体积 | ✅ 约 110 KB | 显著更大 |
 | Vue 3 原生 | ✅ 值导入即用，非二次封装 | 提供 Vue 封装层 |
 | 离线自然语言查询 | ✅ 内置纯确定性 NLQ | ❌ 无 |
 | 虚拟滚动 / 分组 / 透视 / SSRM / 公式 / 主题 / 导出 | ✅ 全部内置 | ✅ 部分在付费版 |
@@ -278,7 +278,7 @@ pnpm dev          # 默认 http://localhost:5173
 |---|---|
 | `index.ts` | 包入口（值导出 `RjGrid` + NLQ / 查询条件内核 + 全部公共类型） |
 | `src/` | 组件与引擎源码（`src/types.ts` 是类型权威） |
-| `__tests__/` | 346 个单测用例，入口 `__tests__/run.ts` |
+| `__tests__/` | 407 个单测用例，入口 `__tests__/run.ts` |
 | `build/rjDistCheck.mjs` | 产物体检五守卫（构建末尾自动跑） |
 | `vite.lib.config.ts` | 库构建：ESM 单文件 + 单 `style.css`，external `vue`/`echarts`，不出 sourcemap |
 | `playground/` | 8 标签演示页 |
@@ -288,7 +288,7 @@ pnpm dev          # 默认 http://localhost:5173
 ### 开发命令
 
 ```bash
-pnpm test      # 单测 346 passed
+pnpm test      # 单测 407 passed
 pnpm ts        # vue-tsc --noEmit
 pnpm lint      # eslint + stylelint
 pnpm build     # vite lib → vue-tsc 产 d.ts → 产物体检五守卫

package/dist/rj-grid.js

@@ -10149,9 +10149,14 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     showGroupPanel: { type: Boolean, default: true },
     chartable: { type: Boolean, default: true },
     exportable: { type: Boolean, default: true },
+    showPrint: { type: Boolean, default: true },
+    showCsv: { type: Boolean, default: true },
+    showPdf: { type: Boolean, default: true },
+    showExcel: { type: Boolean, default: true },
     colReorder: { type: Boolean, default: true },
     resizable: { type: Boolean, default: true },
     rowSelection: { type: [Boolean, String], default: false },
+    selectOnCellClick: { type: Boolean, default: true },
     keepSelectionCrossPage: { type: Boolean },
     editable: { type: Boolean, default: false },
     rangeSelection: { type: Boolean, default: true },
@@ -10899,6 +10904,17 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       }
       notifySelection();
     }
+    function selectRowByClick(d) {
+      if (selection.size === 1 && selection.has(d.key))
+        return;
+      selection.clear();
+      if (props.keepSelectionCrossPage)
+        preserveMap.clear();
+      selection.add(d.key);
+      if (props.keepSelectionCrossPage)
+        preserveMap.set(d.key, d.data);
+      notifySelection();
+    }
     function selectedRows() {
       const rows = rowModel.processed.value.displayRows.filter((d) => selection.has(d.key)).map((d) => d.data);
       Array.from(preserveMap.values()).forEach((r) => {
@@ -12019,6 +12035,8 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
             colIndex: pos.c,
             column: leaf.col
           });
+        if (props.selectOnCellClick && e.button === 0 && !e.ctrlKey && !e.metaKey && !e.shiftKey && !e.altKey && drow && drow.type === "row" && !(e.target instanceof Element && e.target.closest(".rj-checkbox")))
+          selectRowByClick(drow);
       }
       if (!props.rangeSelection || e.button !== 0 || !pos)
         return;
@@ -13994,27 +14012,31 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
               class: normalizeClass(["rj-btn", { "is-active": panelOpen.value }]),
               onClick: _cache[16] || (_cache[16] = ($event) => panelOpen.value = !panelOpen.value)
             }, toDisplayString(t("panel")), 3)) : createCommentVNode("", true),
-            _ctx.exportable ? (openBlock(), createElementBlock("div", _hoisted_14, [
-              createElementVNode("button", {
+            _ctx.exportable && (_ctx.showPrint || _ctx.showCsv || _ctx.showPdf || _ctx.showExcel) ? (openBlock(), createElementBlock("div", _hoisted_14, [
+              _ctx.showPrint ? (openBlock(), createElementBlock("button", {
+                key: 0,
                 class: "rj-btn rj-btn-export rj-export-btn",
                 "data-tip": t("printTip"),
                 onClick: _cache[17] || (_cache[17] = ($event) => openRangeMenu($event, "print"))
-              }, toDisplayString(t("printBtn")), 9, _hoisted_15),
-              createElementVNode("button", {
+              }, toDisplayString(t("printBtn")), 9, _hoisted_15)) : createCommentVNode("", true),
+              _ctx.showCsv ? (openBlock(), createElementBlock("button", {
+                key: 1,
                 class: "rj-btn rj-btn-export rj-export-btn",
                 "data-tip": t("csvTip"),
                 onClick: _cache[18] || (_cache[18] = ($event) => openRangeMenu($event, "csv"))
-              }, " CSV ", 8, _hoisted_16),
-              createElementVNode("button", {
+              }, " CSV ", 8, _hoisted_16)) : createCommentVNode("", true),
+              _ctx.showPdf ? (openBlock(), createElementBlock("button", {
+                key: 2,
                 class: "rj-btn rj-btn-export rj-export-btn",
                 "data-tip": t("pdfTip"),
                 onClick: _cache[19] || (_cache[19] = ($event) => openRangeMenu($event, "pdf"))
-              }, " PDF ", 8, _hoisted_17),
-              createElementVNode("button", {
+              }, " PDF ", 8, _hoisted_17)) : createCommentVNode("", true),
+              _ctx.showExcel ? (openBlock(), createElementBlock("button", {
+                key: 3,
                 class: "rj-btn rj-btn-export rj-export-btn",
                 "data-tip": t("excelTip"),
                 onClick: _cache[20] || (_cache[20] = ($event) => openRangeMenu($event, "excel"))
-              }, " Excel ", 8, _hoisted_18)
+              }, " Excel ", 8, _hoisted_18)) : createCommentVNode("", true)
             ])) : createCommentVNode("", true),
             _ctx.stateKey ? (openBlock(), createElementBlock("button", {
               key: 6,

package/dist/types/src/RjGrid.vue.d.ts

@@ -46,9 +46,16 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     showGroupPanel?: boolean | undefined;
     chartable?: boolean | undefined;
     exportable?: boolean | undefined;
+    /** 工具栏各导出/打印按钮单独显隐（仅在 exportable 为真时生效）；默认全 true，可按需关掉其中任意几个 */
+    showPrint?: boolean | undefined;
+    showCsv?: boolean | undefined;
+    showPdf?: boolean | undefined;
+    showExcel?: boolean | undefined;
     colReorder?: boolean | undefined;
     resizable?: boolean | undefined;
     rowSelection?: false | "multiple" | "single" | undefined;
+    /** 单击数据行单元格即选中该行（替换式，无需再点复选框）；按住 Ctrl/Shift/Alt 仍走区域选择，复选框保留多选，双击仍编辑。默认 true */
+    selectOnCellClick?: boolean | undefined;
     keepSelectionCrossPage?: boolean | undefined;
     editable?: boolean | undefined;
     rangeSelection?: boolean | undefined;
@@ -157,9 +164,14 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     showGroupPanel: boolean;
     chartable: boolean;
     exportable: boolean;
+    showPrint: boolean;
+    showCsv: boolean;
+    showPdf: boolean;
+    showExcel: boolean;
     colReorder: boolean;
     resizable: boolean;
     rowSelection: boolean;
+    selectOnCellClick: boolean;
     editable: boolean;
     rangeSelection: boolean;
     clipboard: boolean;
@@ -260,9 +272,16 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     showGroupPanel?: boolean | undefined;
     chartable?: boolean | undefined;
     exportable?: boolean | undefined;
+    /** 工具栏各导出/打印按钮单独显隐（仅在 exportable 为真时生效）；默认全 true，可按需关掉其中任意几个 */
+    showPrint?: boolean | undefined;
+    showCsv?: boolean | undefined;
+    showPdf?: boolean | undefined;
+    showExcel?: boolean | undefined;
     colReorder?: boolean | undefined;
     resizable?: boolean | undefined;
     rowSelection?: false | "multiple" | "single" | undefined;
+    /** 单击数据行单元格即选中该行（替换式，无需再点复选框）；按住 Ctrl/Shift/Alt 仍走区域选择，复选框保留多选，双击仍编辑。默认 true */
+    selectOnCellClick?: boolean | undefined;
     keepSelectionCrossPage?: boolean | undefined;
     editable?: boolean | undefined;
     rangeSelection?: boolean | undefined;
@@ -371,9 +390,14 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     showGroupPanel: boolean;
     chartable: boolean;
     exportable: boolean;
+    showPrint: boolean;
+    showCsv: boolean;
+    showPdf: boolean;
+    showExcel: boolean;
     colReorder: boolean;
     resizable: boolean;
     rowSelection: boolean;
+    selectOnCellClick: boolean;
     editable: boolean;
     rangeSelection: boolean;
     clipboard: boolean;
@@ -465,9 +489,14 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     showGroupPanel: boolean;
     chartable: boolean;
     exportable: boolean;
+    showPrint: boolean;
+    showCsv: boolean;
+    showPdf: boolean;
+    showExcel: boolean;
     colReorder: boolean;
     resizable: boolean;
     rowSelection: false | "multiple" | "single";
+    selectOnCellClick: boolean;
     rangeSelection: boolean;
     clipboard: boolean;
     contextMenu: boolean | ((ctx: any) => RjMenuItem[]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rj-grid",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "零第三方依赖的自研 Vue3 虚拟表格：虚拟滚动 / 冻结列 / 行拖拽 / 分组透视 / 公式 / SSRM / 主题 i18n / 自然语言查询",
   "type": "module",
   "license": "MIT",