@nokecy/qc-ui 1.1.41 → 1.1.42

package/dist/cjs/array-table/utils.d.ts

@@ -20,6 +20,17 @@ declare const useArrayTableActions: () => ObservableColumnSource[];
  * 校验安全:未碰过的存量格本就是 readPretty、本就不参与校验,不挂树校验语义零变化。@author nokecy
  */
 declare const LazyAgField: (params: any) => React.JSX.Element;
+/**
+ * 反应式只读文本渲染器(列级 readPretty 在「可编辑表」里的展示列)。
+ *
+ * 只读纯文本快路径(valueFormatter)经 AG-Grid 缓存 params.value 取值,setValuesIn 程序化原地改值
+ * 不会刷新该格 → 自动带出的外码/描述等只读展示列空白。本渲染器 Observer 读可观察 record[dataKey],
+ * 保持 readPretty 纯文本观感(不挂 Formily 树、不可点编辑),但能跟随 setValuesIn 即时刷新。
+ *
+ * 仅用于「可编辑表的列级 readPretty 展示列」;「整表 readPretty」(明细/详情页,数据经 setValues 整体
+ * 加载,行引用整体替换→AG-Grid 自然刷新)仍走更廉价的静态 valueFormatter 快路径。@author nokecy
+ */
+declare const LazyReadOnlyText: (params: any) => React.JSX.Element;
 declare const buildArrayTableColumns: (dataSource: any[], field: ArrayField, sources: ObservableColumnSource[]) => AgGridReactProps['columnDefs'];
 declare const useAddition: () => React.JSX.Element | null;
-export { isColumnComponent, useArrayTableSources, useArrayTableActions, buildArrayTableColumns, useAddition, LazyAgField };
+export { isColumnComponent, useArrayTableSources, useArrayTableActions, buildArrayTableColumns, useAddition, LazyAgField, LazyReadOnlyText };

package/dist/cjs/array-table/utils.js

@@ -4,7 +4,7 @@ function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" ==
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.useArrayTableSources = exports.useArrayTableActions = exports.useAddition = exports.isColumnComponent = exports.buildArrayTableColumns = exports.LazyAgField = void 0;
+exports.useArrayTableSources = exports.useArrayTableActions = exports.useAddition = exports.isColumnComponent = exports.buildArrayTableColumns = exports.LazyReadOnlyText = exports.LazyAgField = void 0;
 var _react = _interopRequireDefault(require("react"));
 var _react2 = require("@formily/react");
 var _shared = require("@formily/shared");
@@ -204,6 +204,41 @@ var LazyAgField = exports.LazyAgField = function LazyAgField(params) {
   });
 };
 
+/**
+ * 反应式只读文本渲染器(列级 readPretty 在「可编辑表」里的展示列)。
+ *
+ * 只读纯文本快路径(valueFormatter)经 AG-Grid 缓存 params.value 取值,setValuesIn 程序化原地改值
+ * 不会刷新该格 → 自动带出的外码/描述等只读展示列空白。本渲染器 Observer 读可观察 record[dataKey],
+ * 保持 readPretty 纯文本观感(不挂 Formily 树、不可点编辑),但能跟随 setValuesIn 即时刷新。
+ *
+ * 仅用于「可编辑表的列级 readPretty 展示列」;「整表 readPretty」(明细/详情页,数据经 setValues 整体
+ * 加载,行引用整体替换→AG-Grid 自然刷新)仍走更廉价的静态 valueFormatter 快路径。@author nokecy
+ */
+var LazyReadOnlyText = exports.LazyReadOnlyText = function LazyReadOnlyText(params) {
+  var _fieldSchema$name2;
+  var value = params.value,
+    record = params.data,
+    colDef = params.colDef,
+    formatter = params.formatter,
+    columnProps = params.columnProps,
+    fieldSchema = params.fieldSchema;
+  var dataKey = (_fieldSchema$name2 = fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema.name) !== null && _fieldSchema$name2 !== void 0 ? _fieldSchema$name2 : colDef === null || colDef === void 0 ? void 0 : colDef.field;
+  return /*#__PURE__*/_react.default.createElement(_react2.Observer, null, function () {
+    var liveValue = dataKey != null && record ? record[dataKey] : value;
+    var text = formatter ? formatter(liveValue, {
+      columnProps: columnProps,
+      fieldSchema: fieldSchema
+    }) : liveValue == null ? '' : String(liveValue);
+    return /*#__PURE__*/_react.default.createElement("span", {
+      className: "ag-array-table-readonly-text",
+      style: {
+        display: 'inline-block',
+        width: '100%'
+      }
+    }, text);
+  });
+};
+
 // 在 Column 的子 schema 里递归找到内层数据字段(可读 x-component / x-pattern / x-reactions / enum) @author nokecy
 var findDataFieldSchema = function findDataFieldSchema(columnSchema, name) {
   if (!columnSchema || !columnSchema.properties) return null;
@@ -306,6 +341,21 @@ var buildArrayTableColumns = exports.buildArrayTableColumns = function buildArra
 
     // ① 只读纯文本
     if (readOnly && formatter) {
+      // 列级 readPretty 在「可编辑表」里是展示列(值可能被 setValuesIn 自动带出),静态 valueFormatter
+      // 读 AG-Grid 缓存值不刷新 → 反应式只读渲染。整表 readPretty(明细/详情页,数据 setValues 整体加载、
+      // 行引用整体替换、AG-Grid 自然刷新)仍走更廉价的静态 valueFormatter 快路径。@author nokecy
+      if (arrayPattern !== 'readPretty') {
+        return buf.concat(_objectSpread(_objectSpread(_objectSpread({}, base), valueGetter ? {
+          valueGetter: valueGetter
+        } : {}), {}, {
+          cellRenderer: LazyReadOnlyText,
+          cellRendererParams: {
+            formatter: formatter,
+            columnProps: columnProps,
+            fieldSchema: dataField
+          }
+        }));
+      }
       return buf.concat(_objectSpread(_objectSpread(_objectSpread({}, base), valueGetter ? {
         valueGetter: valueGetter
       } : {}), {}, {

package/dist/esm/array-table/utils.d.ts

@@ -20,6 +20,17 @@ declare const useArrayTableActions: () => ObservableColumnSource[];
  * 校验安全:未碰过的存量格本就是 readPretty、本就不参与校验,不挂树校验语义零变化。@author nokecy
  */
 declare const LazyAgField: (params: any) => React.JSX.Element;
+/**
+ * 反应式只读文本渲染器(列级 readPretty 在「可编辑表」里的展示列)。
+ *
+ * 只读纯文本快路径(valueFormatter)经 AG-Grid 缓存 params.value 取值,setValuesIn 程序化原地改值
+ * 不会刷新该格 → 自动带出的外码/描述等只读展示列空白。本渲染器 Observer 读可观察 record[dataKey],
+ * 保持 readPretty 纯文本观感(不挂 Formily 树、不可点编辑),但能跟随 setValuesIn 即时刷新。
+ *
+ * 仅用于「可编辑表的列级 readPretty 展示列」;「整表 readPretty」(明细/详情页,数据经 setValues 整体
+ * 加载,行引用整体替换→AG-Grid 自然刷新)仍走更廉价的静态 valueFormatter 快路径。@author nokecy
+ */
+declare const LazyReadOnlyText: (params: any) => React.JSX.Element;
 declare const buildArrayTableColumns: (dataSource: any[], field: ArrayField, sources: ObservableColumnSource[]) => AgGridReactProps['columnDefs'];
 declare const useAddition: () => React.JSX.Element | null;
-export { isColumnComponent, useArrayTableSources, useArrayTableActions, buildArrayTableColumns, useAddition, LazyAgField };
+export { isColumnComponent, useArrayTableSources, useArrayTableActions, buildArrayTableColumns, useAddition, LazyAgField, LazyReadOnlyText };

package/dist/esm/array-table/utils.js

@@ -197,6 +197,41 @@ var LazyAgField = function LazyAgField(params) {
   });
 };
 
+/**
+ * 反应式只读文本渲染器(列级 readPretty 在「可编辑表」里的展示列)。
+ *
+ * 只读纯文本快路径(valueFormatter)经 AG-Grid 缓存 params.value 取值,setValuesIn 程序化原地改值
+ * 不会刷新该格 → 自动带出的外码/描述等只读展示列空白。本渲染器 Observer 读可观察 record[dataKey],
+ * 保持 readPretty 纯文本观感(不挂 Formily 树、不可点编辑),但能跟随 setValuesIn 即时刷新。
+ *
+ * 仅用于「可编辑表的列级 readPretty 展示列」;「整表 readPretty」(明细/详情页,数据经 setValues 整体
+ * 加载,行引用整体替换→AG-Grid 自然刷新)仍走更廉价的静态 valueFormatter 快路径。@author nokecy
+ */
+var LazyReadOnlyText = function LazyReadOnlyText(params) {
+  var _fieldSchema$name2;
+  var value = params.value,
+    record = params.data,
+    colDef = params.colDef,
+    formatter = params.formatter,
+    columnProps = params.columnProps,
+    fieldSchema = params.fieldSchema;
+  var dataKey = (_fieldSchema$name2 = fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema.name) !== null && _fieldSchema$name2 !== void 0 ? _fieldSchema$name2 : colDef === null || colDef === void 0 ? void 0 : colDef.field;
+  return /*#__PURE__*/React.createElement(Observer, null, function () {
+    var liveValue = dataKey != null && record ? record[dataKey] : value;
+    var text = formatter ? formatter(liveValue, {
+      columnProps: columnProps,
+      fieldSchema: fieldSchema
+    }) : liveValue == null ? '' : String(liveValue);
+    return /*#__PURE__*/React.createElement("span", {
+      className: "ag-array-table-readonly-text",
+      style: {
+        display: 'inline-block',
+        width: '100%'
+      }
+    }, text);
+  });
+};
+
 // 在 Column 的子 schema 里递归找到内层数据字段(可读 x-component / x-pattern / x-reactions / enum) @author nokecy
 var findDataFieldSchema = function findDataFieldSchema(columnSchema, name) {
   if (!columnSchema || !columnSchema.properties) return null;
@@ -299,6 +334,21 @@ var buildArrayTableColumns = function buildArrayTableColumns(dataSource, field,
 
     // ① 只读纯文本
     if (readOnly && formatter) {
+      // 列级 readPretty 在「可编辑表」里是展示列(值可能被 setValuesIn 自动带出),静态 valueFormatter
+      // 读 AG-Grid 缓存值不刷新 → 反应式只读渲染。整表 readPretty(明细/详情页,数据 setValues 整体加载、
+      // 行引用整体替换、AG-Grid 自然刷新)仍走更廉价的静态 valueFormatter 快路径。@author nokecy
+      if (arrayPattern !== 'readPretty') {
+        return buf.concat(_objectSpread(_objectSpread(_objectSpread({}, base), valueGetter ? {
+          valueGetter: valueGetter
+        } : {}), {}, {
+          cellRenderer: LazyReadOnlyText,
+          cellRendererParams: {
+            formatter: formatter,
+            columnProps: columnProps,
+            fieldSchema: dataField
+          }
+        }));
+      }
       return buf.concat(_objectSpread(_objectSpread(_objectSpread({}, base), valueGetter ? {
         valueGetter: valueGetter
       } : {}), {}, {
@@ -354,4 +404,4 @@ var useAddition = function useAddition() {
     return addition;
   }, null);
 };
-export { isColumnComponent, useArrayTableSources, useArrayTableActions, buildArrayTableColumns, useAddition, LazyAgField };
+export { isColumnComponent, useArrayTableSources, useArrayTableActions, buildArrayTableColumns, useAddition, LazyAgField, LazyReadOnlyText };