yc-pro-components 0.0.18 → 0.0.19

package/es/index.mjs

@@ -9,7 +9,7 @@ export { usePlusFormReset } from './hooks/usePlusFormReset.mjs';
 export { useSelectWithPagination } from './hooks/useSelectWithPagination.mjs';
 export { useDictInjection } from './hooks/useDictInjection.mjs';
 export { DefaultPageInfo, DefaultPageSizeList } from './constants/page.mjs';
-export { DatePickerValueIsArrayList, TableFormFieldRefInjectionKey, TableFormRefInjectionKey, TableFormRowInfoInjectionKey, ValueIsArrayList, ValueIsBooleanList, ValueIsNumberList } from './constants/form.mjs';
+export { DatePickerValueIsArrayList, TableColumnsEmptyTextInjectionKey, TableFormFieldRefInjectionKey, TableFormRefInjectionKey, TableFormRowInfoInjectionKey, ValueIsArrayList, ValueIsBooleanList, ValueIsNumberList } from './constants/form.mjs';
 export { selectValueTypeList } from './constants/display-item.mjs';
 export { DictStoreInjectionKey } from './constants/dict.mjs';
 export { version } from './version.mjs';

package/es/types/plus.d.ts

@@ -272,6 +272,35 @@ export interface CommonType {
      * 多级表头
      */
     children?: PlusColumn[];
+    /**
+     * 字段值为空时显示的文本
+     * @version v0.2.0
+     * @default "-"
+     * @desc 当字段值为 null、undefined 或空字符串时，显示此文本
+     * @desc 仅对未定义 render/renderHTML 的字段生效
+     * @desc 如果不希望处理空值，可以设置为空字符串 emptyText: ""
+     * @example
+     * ```ts
+     * const columns: PlusColumn[] = [
+     *   {
+     *     label: '姓名',
+     *     prop: 'name'
+     *     // 默认空值显示 "-"
+     *   },
+     *   {
+     *     label: '备注',
+     *     prop: 'remark',
+     *     emptyText: '暂无'  // 自定义空值显示为 "暂无"
+     *   },
+     *   {
+     *     label: '数量',
+     *     prop: 'count',
+     *     emptyText: ''  // 空值显示空字符串（不处理）
+     *   }
+     * ]
+     * ```
+     */
+    emptyText?: string;
     /**
      * 自动字典注入
      * @version v0.2.0

package/index.js

@@ -1,4 +1,4 @@
-/*! yc-pro-components v0.0.18 */
+/*! yc-pro-components v0.0.19 */
 (function (global, factory) {
   typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('vue'), require('element-plus')) :
   typeof define === 'function' && define.amd ? define(['exports', 'vue', 'element-plus'], factory) :
@@ -4779,6 +4779,7 @@
   const TableFormRefInjectionKey = Symbol("tableFormRefInjectionKey");
   const TableFormFieldRefInjectionKey = Symbol("tableFormFieldRefInjectionKey");
   const TableFormRowInfoInjectionKey = Symbol("tableFormRowInfoInjectionKey");
+  const TableColumnsEmptyTextInjectionKey = Symbol("tableColumnsEmptyTextInjectionKey");
   const DatePickerValueIsArrayList = ["datetimerange", "daterange", "monthrange"];
   const ValueIsNumberList = ["rate", "input-number", "slider"];
   const ValueIsBooleanList = ["switch"];
@@ -17163,16 +17164,18 @@
         const value = props.column.valueType === "link" ? props.column.linkText || displayValue.value : displayValue.value;
         if (!selectValueTypeList.includes(props.column.valueType) && !isEdit.value) {
           if (props.column.formatter && isFunction(props.column.formatter)) {
-            return props.column.formatter(value, renderParams.value);
+            const formattedValue = props.column.formatter(value, renderParams.value);
+            return handleEmptyValue(formattedValue);
           }
           if (displayComponent.value.format && isFunction(displayComponent.value.format)) {
-            return displayComponent.value.format(
+            const formattedValue = displayComponent.value.format(
               value,
               customFieldProps.value.format || customFieldProps.value.valueFormat
             );
+            return handleEmptyValue(formattedValue);
           }
         }
-        return value;
+        return handleEmptyValue(value);
       });
       const modelValues = vue.computed({
         get() {
@@ -17204,6 +17207,17 @@
         column: { ...props.rest.column, ...props.column }
       }));
       vue.provide(TableFormRowInfoInjectionKey, tableRowInfo);
+      const injectedColumnsEmptyText = vue.inject(TableColumnsEmptyTextInjectionKey, vue.computed(() => "-"));
+      const handleEmptyValue = (value) => {
+        var _a;
+        if (value === null || value === void 0 || value === "") {
+          if (props.column.emptyText !== void 0) {
+            return props.column.emptyText;
+          }
+          return (_a = injectedColumnsEmptyText.value) != null ? _a : "-";
+        }
+        return value;
+      };
       const imageUrl = vue.computed(() => {
         const option = formatterValue.value;
         if (option && isString(option)) {
@@ -18708,7 +18722,8 @@
       indexContentStyle: { type: [Object, Function], default: () => ({}) },
       editable: { type: [Boolean, String], default: false },
       adaptive: { type: [Boolean, Object], default: false },
-      filterTableHeaderOverflowLabelLength: {}
+      filterTableHeaderOverflowLabelLength: {},
+      columnsEmptyText: { default: "-" }
     },
     emits: ["paginationChange", "clickAction", "clickActionConfirmCancel", "dragSortEnd", "formChange", "refresh", "edited", "cell-click", "cell-dblclick", "filterTableHeader", "radioChange"],
     setup(__props, { expose: __expose, emit: __emit }) {
@@ -18740,6 +18755,7 @@
       vue.provide(TableFormRefInjectionKey, formRefs);
       const formFieldRefs = vue.shallowRef({});
       vue.provide(TableFormFieldRefInjectionKey, formFieldRefs);
+      vue.provide(TableColumnsEmptyTextInjectionKey, vue.computed(() => props.columnsEmptyText));
       vue.watch(
         () => props.columns,
         (val) => {
@@ -19954,7 +19970,8 @@
         page: "page",
         pageSize: "pageSize"
       }) },
-      searchSlot: { type: Boolean, default: false }
+      searchSlot: { type: Boolean, default: false },
+      columnsEmptyText: { default: "-" }
     },
     emits: ["search", "reset", "paginationChange", "requestError", "requestComplete"],
     setup(__props, { expose: __expose, emit: __emit }) {
@@ -20143,6 +20160,7 @@
                 "table-data": vue.unref(tableData),
                 "loading-status": vue.unref(loadingStatus),
                 columns: _ctx.columns,
+                "columns-empty-text": _ctx.columnsEmptyText,
                 pagination: _ctx.pagination === false ? void 0 : {
                   ..._ctx.pagination,
                   total: vue.unref(total),
@@ -20198,7 +20216,7 @@
                     ])
                   };
                 })
-              ]), 1040, ["table-data", "loading-status", "columns", "pagination"])
+              ]), 1040, ["table-data", "loading-status", "columns", "columns-empty-text", "pagination"])
             ]),
             _: 3
             /* FORWARDED */
@@ -59893,6 +59911,7 @@
   exports.ReboundCountTo = YcReboundCountTo;
   exports.SIZE_MAP = SIZE_MAP;
   exports.STATUS_CONFIG_MAP = STATUS_CONFIG_MAP;
+  exports.TableColumnsEmptyTextInjectionKey = TableColumnsEmptyTextInjectionKey;
   exports.TableFormFieldRefInjectionKey = TableFormFieldRefInjectionKey;
   exports.TableFormRefInjectionKey = TableFormRefInjectionKey;
   exports.TableFormRowInfoInjectionKey = TableFormRowInfoInjectionKey;