n20-common-lib 2.22.75 → 2.22.76

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n20-common-lib",
-  "version": "2.22.75",
+  "version": "2.22.76",
   "private": false,
   "scripts": {
     "serve": "vue-cli-service serve",

package/src/components/InputNumber/README.md

@@ -23,6 +23,7 @@
 | ------------ | ------------- | ----------------- | --------------------------------- |
 | value        | Number/String | undefined         | 绑定值                               |
 | stringMode   | Boolean       | false             | 高精度模式，非空绑定值和 input/change 事件值使用字符串 |
+| isString     | Boolean       | false             | stringMode 兼容别名；小数位超过15位时自动按 true 处理 |
 | type         | String        | 'money'           | 输入框类型，可选值：'money'、'rate'、'number' |
 | maxlength    | Number        | 16                | 最大输入长度                            |
 | min          | Number/String | -9999999999999.99 | 最小值限制；高精度模式可传字符串 |
@@ -113,7 +114,7 @@
 
 ### 20 位小数汇率
 
-`stringMode` 默认关闭，原有金额/利率的精度、数值事件保持原样。开启后，输入、回显、步进、范围比较和变更事件使用高精度十进制处理。`input` / `change` 的非空值是字符串，清空为 `undefined`；`blur` / `clear` 事件签名保持原样。
+`stringMode` 和 `isString` 默认关闭，原有金额/利率的精度、数值事件保持原样。任一配置开启，或 `dNum` / `format` 超过 15 位安全小数位时，组件会自动进入高精度字符串模式。输入、回显、步进、范围比较和变更事件使用高精度十进制处理，失焦时按最大位数四舍五入并移除尾部 `0`，例如 `0.200000` 回传 `"0.2"`。
 
 下面 `cl-*` 是默认注册前缀；业务项目按自己的 `Vue.use(n20, { prefix })` 替换标签。
 
@@ -141,9 +142,9 @@ export default {
 </script>
 ```
 
-- `stringMode` 不改变 `dNum`、`format` 和 `maxlength` 默认值。`format` 仍优先于 `dNum`；有旧 `format` 配置时需同步调整。
+- `stringMode` / `isString` 不改变 `dNum`、`format` 和 `maxlength` 默认值。`format` 仍优先于 `dNum`；有旧 `format` 配置时需同步调整。小数位超过 15 位时即使两个开关都为 `false`，也会自动使用字符串模式。
 - `maxlength` 统计全部字符，默认 16。20 位小数加上 `0.` 至少需要 22；按整数位、负号和小数点配置总长度。示例的 35 可容纳默认范围的 13 位整数、负号、小数点和 20 位小数。
-- 默认按十进制四舍五入到配置位数并补零；`rangeAuto` 开启后至少补到配置位数，并保留更多已有小数位。需要最多 20 位时使用默认 `rangeAuto=false`。
+- 默认按十进制四舍五入到配置位数并移除尾部 `0`；`rangeAuto` 开启后至少按配置位数处理，并保留更多已有小数位。
 - `min`、`max`、`step` 的字符串形式用于高精度模式；普通模式继续传 Number。`step` 使用正值。`stepStrictly` 的中点方向与原有 `Math.round` 一致。
 - 可粘贴科学计数法，提交展开为普通十进制字符串。空值、NaN、Infinity、非十进制输入不作为有效数字。
 - 按上下箭头改变输入框内容，提交时机与旧模式相同，在 change/blur 时同步绑定值。

package/src/components/InputNumber/index.vue

@@ -36,6 +36,7 @@ import { $lc } from '../../utils/i18n/index'
 import N from '../../utils/numberPor'
 import { Decimal, parseDecimal } from '../../utils/decimal'
 
+const MAX_SAFE_DECIMAL_PLACES = 15
 
 export default {
   name: 'InputNumber',
@@ -50,6 +51,11 @@ export default {
       type: Boolean,
       default: false
     },
+    // isString 是 stringMode 的兼容别名；超过安全小数位时会自动生效。
+    isString: {
+      type: Boolean,
+      default: false
+    },
     /**
      * 输入框类型
      * - money: 金额类型，默认保留2位小数，启用千分位格式化
@@ -162,7 +168,7 @@ export default {
   watch: {
     value: {
       handler(val) {
-        if (this.stringMode) {
+        if (this.isStringMode()) {
           this.setStringDisplay(val)
           return
         }
@@ -199,10 +205,13 @@ export default {
       immediate: true
     },
     fNum() {
-      if (this.stringMode) this.setStringDisplay(this.value)
+      if (this.isStringMode()) this.setStringDisplay(this.value)
     }
   },
   methods: {
+    isStringMode() {
+      return this.stringMode || this.isString || this.fNum > MAX_SAFE_DECIMAL_PLACES
+    },
     // rangeAuto 允许已有小数位超过配置值，其余情况按配置位数四舍五入。
     formatStringValue(value, originalValue = value) {
       const decimal = parseDecimal(value)
@@ -212,8 +221,12 @@ export default {
       const places = this.rangeAuto
         ? Math.max(this.fNum, decimal.decimalPlaces(), fraction ? fraction[1].length : 0)
         : this.fNum
-      // 先舍入再输出，让接近零的负数规范化为零，避免显示值与事件值的符号不同。
-      return decimal.toDecimalPlaces(places).toFixed(places)
+      // 先舍入再输出，并移除尾部 0，避免保存值与接口回显值不一致。
+      const fixedValue = decimal.toDecimalPlaces(places).toFixed(places)
+      const trimmedValue = fixedValue
+        .replace(/(\.\d*?[1-9])0+$/, '$1')
+        .replace(/\.0+$/, '')
+      return trimmedValue === '-0' ? '0' : trimmedValue
     },
     setStringDisplay(value) {
       const text = this.formatStringValue(value)
@@ -266,7 +279,7 @@ export default {
     },
     stepFn(ev) {
       if ((ev.code === 'ArrowUp' || ev.code === 'ArrowDown') && !this.disabled) {
-        if (this.stringMode) {
+        if (this.isStringMode()) {
           const value = parseDecimal(this.valueStr)
           const step = parseDecimal(this.step)
           if (value && step && step.gt(0)) {
@@ -296,7 +309,7 @@ export default {
       }
     },
     inputFn(valStr) {
-      if (this.stringMode) {
+      if (this.isStringMode()) {
         // 编辑中的符号和小数点暂时保留，完整值在失焦时统一规范化。
         if (['', '-', '+', '.', '-.', '+.'].includes(valStr) || parseDecimal(valStr)) {
           this.preValue = valStr
@@ -318,7 +331,7 @@ export default {
         this.changeIng = false
       })
 
-      if (this.stringMode) {
+      if (this.isStringMode()) {
         this.changeStringValue(valStr)
         return
       }