n20-common-lib 2.22.73 → 2.22.74

package/package.json

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

package/src/components/DynamicField/DynamicField.vue

@@ -75,11 +75,12 @@
                   <template v-else-if="formItem.type === 'input-number'">
                     <cl-input-number
                       v-model="value[key]"
+                      v-bind="numberInputProps(formItem)"
                       class="input-w"
                       :is-clearable="formItem.isClearable"
                       :clearable="formItem.clearable === false ? false : true"
                       :disabled="formItem.disabled"
-                      :max="formItem.max || 9999999999.99"
+                      :max="formItem.max === undefined ? 9999999999.99 : formItem.max"
                       :min="formItem.min || formItem.min === 0 ? formItem.min : 0"
                       :d-num="formItem.dNum || formItem.dNum === 0 ? formItem.dNum : 2"
                       :type="formItem.numberType || 'money'"
@@ -89,16 +90,20 @@
                   <!-- 金额区间 -->
                   <template v-else-if="formItem.type === 'input-number-range'">
                     <cl-input-number-range
+                      v-bind="numberInputProps(formItem)"
                       class="input-w"
+                      :type="formItem.numberType || 'money'"
+                      :min="formItem.min"
+                      :max="formItem.max"
                       :is-clearable="formItem.isClearable === false ? false : true"
                       :disabled="formItem.disabled"
                       :start-value.sync="value[key][formItem['startKey'] || 'start']"
                       :end-value.sync="value[key][formItem['endKey'] || 'end']"
                       @change="
-                        () =>
+                        (range) =>
                           $emit(
                             'valueChange',
-                            { start: value[formItem['startKey']], end: value[formItem['endKey']] },
+                            { start: range[0], end: range[1] },
                             key
                           )
                       "
@@ -107,19 +112,20 @@
                   <!-- 利率区间 -->
                   <template v-else-if="formItem.type === 'input-rate-range'">
                     <cl-input-number-range
+                      v-bind="numberInputProps(formItem)"
                       class="input-w"
                       :disabled="formItem.disabled"
                       :is-clearable="formItem.isClearable === false ? false : true"
                       :start-value.sync="value[key][formItem['startKey'] || 'start']"
                       :end-value.sync="value[key][formItem['endKey'] || 'end']"
-                      type="rate"
-                      :min="0"
-                      :max="100"
+                      :type="formItem.numberType || 'rate'"
+                      :min="formItem.min === undefined ? 0 : formItem.min"
+                      :max="formItem.max === undefined ? 100 : formItem.max"
                       @change="
-                        () =>
+                        (range) =>
                           $emit(
                             'valueChange',
-                            { start: value[formItem['startKey']], end: value[formItem['endKey']] },
+                            { start: range[0], end: range[1] },
                             key
                           )
                       "
@@ -316,7 +322,8 @@
             <template v-else>
               <slot :name="key" :value="formItem.value">
                 <template v-if="formItem.type === 'input-number'">
-                  <span class="value">{{ formItem.value | toThousands }}</span>
+                  <span v-if="formItem.stringMode" class="value">{{ formatStringNumber(formItem) }}</span>
+                  <span v-else class="value">{{ formItem.value | toThousands }}</span>
                 </template>
                 <template v-else-if="formItem.label === $lc('子票区间')">
                   <span>{{ formItem.value | formatCdRange }}</span>
@@ -341,6 +348,8 @@ import clInputNumberRange from '../InputNumber/numberRange.vue'
 import clDatePicker from '../DatePicker/index.vue'
 import clDatePickerPor from '../DatePicker/por.vue'
 import clInputSearch from '../InputSearch/index.vue'
+import N from '../../utils/numberPor'
+import { formatExchangeRate, parseDecimal } from '../../utils/decimal'
 /*
 1.初始化值 是否能出发change事件
 2.当前表单change 触发其他表单的修改（未在自身作用域）
@@ -430,6 +439,28 @@ export default {
   },
   created() {},
   methods: {
+    // 只透传数值输入参数，避免把动态字段自身的 type/value 等配置覆盖到控件。
+    numberInputProps(item) {
+      const props = {}
+      const keys = ['stringMode', 'maxlength', 'dNum', 'format', 'rangeAuto', 'step', 'stepStrictly', 'suffix']
+      keys.forEach((key) => {
+        if (item[key] !== undefined) props[key] = item[key]
+      })
+      return props
+    },
+    // 详情中的高精度字段与编辑控件采用同一小数位规则，不依赖宿主的金额 filter。
+    formatStringNumber(item) {
+      const digits = item.format
+        ? (item.format.includes('.') ? item.format.length - item.format.indexOf('.') - 1 : 0)
+        : (item.dNum === undefined ? 2 : item.dNum)
+      const decimal = parseDecimal(item.value)
+      const fraction = String(item.value).trim().match(/\.(\d+)$/)
+      const places = item.rangeAuto && decimal
+        ? Math.max(digits, decimal.decimalPlaces(), fraction ? fraction[1].length : 0)
+        : digits
+      const text = formatExchangeRate(item.value, places)
+      return text === '--' || item.numberType === 'number' ? text : N.addThousands(text)
+    },
     init() {
       this.$listeners.init({ branchNoList: this.branchNoList })
     },

package/src/components/InputNumber/README.md

@@ -22,11 +22,12 @@
 | 属性名          | 类型            | 默认值               | 说明                                |
 | ------------ | ------------- | ----------------- | --------------------------------- |
 | value        | Number/String | undefined         | 绑定值                               |
+| stringMode   | Boolean       | false             | 高精度模式，非空绑定值和 input/change 事件值使用字符串 |
 | type         | String        | 'money'           | 输入框类型，可选值：'money'、'rate'、'number' |
 | maxlength    | Number        | 16                | 最大输入长度                            |
-| min          | Number        | -9999999999999.99 | 最小值限制                             |
-| max          | Number        | 9999999999999.99  | 最大值限制                             |
-| step         | Number        | 1                 | 步进值，按上下箭头时的增减幅度                   |
+| min          | Number/String | -9999999999999.99 | 最小值限制；高精度模式可传字符串 |
+| max          | Number/String | 9999999999999.99  | 最大值限制；高精度模式可传字符串 |
+| step         | Number/String | 1                 | 步进值；高精度模式可传字符串 |
 | stepStrictly | Boolean       | false             | 是否严格按步进值递增/递减                     |
 | disabled     | Boolean       | undefined         | 是否禁用                              |
 | isClearable  | Boolean       | false             | 是否可清空                             |
@@ -110,3 +111,99 @@
 <InputNumber v-model="value" type="number" :step="0.5" :stepStrictly="true" />
 ```
 
+### 20 位小数汇率
+
+`stringMode` 默认关闭，原有金额/利率的精度、数值事件保持原样。开启后，输入、回显、步进、范围比较和变更事件使用高精度十进制处理。`input` / `change` 的非空值是字符串，清空为 `undefined`；`blur` / `clear` 事件签名保持原样。
+
+下面 `cl-*` 是默认注册前缀；业务项目按自己的 `Vue.use(n20, { prefix })` 替换标签。
+
+```vue
+<template>
+  <!-- 汇率没有百分号，显式设置 20 位精度和足够的总输入长度。 -->
+  <cl-input-number
+    v-model="exchangeRate"
+    string-mode
+    type="number"
+    :d-num="20"
+    :maxlength="35"
+    min="0"
+    step="0.00000000000000000001"
+  />
+</template>
+
+<script>
+export default {
+  data() {
+    // 接口响应和请求中的汇率也使用字符串，避免到达组件前已被 Number 舍入。
+    return { exchangeRate: '1.12345678901234567890' }
+  }
+}
+</script>
+```
+
+- `stringMode` 不改变 `dNum`、`format` 和 `maxlength` 默认值。`format` 仍优先于 `dNum`；有旧 `format` 配置时需同步调整。
+- `maxlength` 统计全部字符，默认 16。20 位小数加上 `0.` 至少需要 22；按整数位、负号和小数点配置总长度。示例的 35 可容纳默认范围的 13 位整数、负号、小数点和 20 位小数。
+- 默认按十进制四舍五入到配置位数并补零；`rangeAuto` 开启后至少补到配置位数，并保留更多已有小数位。需要最多 20 位时使用默认 `rangeAuto=false`。
+- `min`、`max`、`step` 的字符串形式用于高精度模式；普通模式继续传 Number。`step` 使用正值。`stepStrictly` 的中点方向与原有 `Math.round` 一致。
+- 可粘贴科学计数法，提交展开为普通十进制字符串。空值、NaN、Infinity、非十进制输入不作为有效数字。
+- 按上下箭头改变输入框内容，提交时机与旧模式相同，在 change/blur 时同步绑定值。
+- 高精度字段不要使用 `v-model.number`、`Number` 或 `parseFloat`；校验规则使用字符串或自定义十进制校验，而不是 `type: 'number'`。
+
+### 高精度区间与动态字段
+
+`InputNumberRange` 通过 attrs 透传 `string-mode`、`d-num`、`maxlength`、`step` 等参数；两个端点和 `change` 数组元素都是字符串，清空端点为 `undefined`。
+
+```vue
+<!-- 两个字符串端点互相作为上下界，第 20 位的差异也参与比较。 -->
+<cl-input-number-range
+  :start-value.sync="startRate"
+  :end-value.sync="endRate"
+  string-mode
+  type="number"
+  :d-num="20"
+  :maxlength="35"
+/>
+```
+
+`Filters` / `AdvancedFilter` 在 `item.props` 里设置相同参数；`DynamicField` 在字段配置里设置：
+
+```js
+// input-number / input-number-range / input-rate-range 均支持这些数值参数。
+const field = {
+  type: 'input-number',
+  numberType: 'number',
+  stringMode: true,
+  dNum: 20,
+  maxlength: 35,
+  min: '0',
+  step: '0.00000000000000000001'
+}
+```
+
+动态利率区间不传配置时仍使用 rate、0～100 的旧默认值；汇率按实际单位和范围配置 `numberType`、`min`、`max`。
+
+### 高精度计算、列表和 Excel
+
+```js
+import { Decimal, formatExchangeRate } from 'n20-common-lib'
+
+// 金额计算保留中间精度，只在最终结果四舍五入到两位；返回值依然是字符串。
+const amount = new Decimal('1').times('1.00499999999999999999').toFixed(2) // '1.00'
+const inverseRate = new Decimal('1').div('3').toFixed(20) // '0.33333333333333333333'
+const text = formatExchangeRate('1.12345678901234567890') // 原样保留 20 位
+
+// TablePro：独立于原有 formatRate，可通过数组参数指定其他展示位数。
+const proColumn = { prop: 'rate', label: '汇率', formatter: 'formatExchangeRate' }
+const customColumn = { prop: 'rate', label: '汇率', formatter: ['formatExchangeRate', 12] }
+
+// 旧 Table：新增 exchangeRate 模板格式，固定展示 20 位。
+const oldColumn = { prop: 'rate', label: '汇率', formatter: '{rate|exchangeRate}' }
+
+// toExcel 使用字符串 rows；识别上述字符串形式的汇率 formatter 时自动设置文本格式。
+const rows = [{ rate: '1.12345678901234567890' }]
+// 自定义或数组 formatter 的导出列可显式设置 numFmt: '@'，并同样传入字符串。
+```
+
+`formatExchangeRate(value, decimalPlaces = 20)` 不添加千分位或百分号，零正常显示，空值/非法值显示 `--`。旧 `formatRate` / `{rate|rate}` 仍为 6 位，原有 `N` 和 `numerify` 保持兼容；高精度计算与展示需显式切换到新工具。
+
+导出的 `Decimal` 使用独立配置：80 位有效数字、四舍五入，不修改 `decimal.js` 原有全局配置。有效数字包括整数和小数部分；业务需要不同运算精度或舍入规则时使用 `Decimal.clone(...)`，不要修改公共构造器的配置。高精度数据进入 Excel 工具前必须已经是字符串，改变单元格显示格式不能恢复之前丢失的尾数。

package/src/components/InputNumber/index.vue

@@ -34,6 +34,7 @@
 import emitter from '../../utils/element-ui-emitter'
 import { $lc } from '../../utils/i18n/index'
 import N from '../../utils/numberPor'
+import { Decimal, parseDecimal } from '../../utils/decimal'
 
 
 export default {
@@ -44,6 +45,11 @@ export default {
       type: [Number, String],
       default: undefined
     },
+    // 高精度模式显式启用，绑定值及变更事件使用十进制字符串。
+    stringMode: {
+      type: Boolean,
+      default: false
+    },
     /**
      * 输入框类型
      * - money: 金额类型，默认保留2位小数，启用千分位格式化
@@ -62,15 +68,15 @@ export default {
       default: 16
     },
     min: {
-      type: Number,
+      type: [Number, String],
       default: -9999999999999.99
     },
     max: {
-      type: Number,
+      type: [Number, String],
       default: 9999999999999.99
     },
     step: {
-      type: Number,
+      type: [Number, String],
       default: 1
     },
     stepStrictly: {
@@ -156,6 +162,10 @@ export default {
   watch: {
     value: {
       handler(val) {
+        if (this.stringMode) {
+          this.setStringDisplay(val)
+          return
+        }
         // number类型不启用千分位格式化，但应用小数位限制
         if (this.type === 'number') {
           if (val === undefined || val === null) {
@@ -187,9 +197,54 @@ export default {
         }
       },
       immediate: true
+    },
+    fNum() {
+      if (this.stringMode) this.setStringDisplay(this.value)
     }
   },
   methods: {
+    // rangeAuto 允许已有小数位超过配置值，其余情况按配置位数四舍五入。
+    formatStringValue(value, originalValue = value) {
+      const decimal = parseDecimal(value)
+      if (!decimal) return ''
+      // Decimal 会省略尾零，rangeAuto 额外保留普通十进制输入中的原始小数长度。
+      const fraction = String(originalValue).trim().match(/\.(\d+)$/)
+      const places = this.rangeAuto
+        ? Math.max(this.fNum, decimal.decimalPlaces(), fraction ? fraction[1].length : 0)
+        : this.fNum
+      // 先舍入再输出，让接近零的负数规范化为零，避免显示值与事件值的符号不同。
+      return decimal.toDecimalPlaces(places).toFixed(places)
+    },
+    setStringDisplay(value) {
+      const text = this.formatStringValue(value)
+      this.valueStr = this.type === 'number' ? text : N.addThousands(text)
+    },
+    // 比较和严格步进使用 Decimal，避免第 20 位不同的值被当成相等。
+    constrainStringValue(value, strictly = false) {
+      let decimal = value
+      const step = parseDecimal(this.step)
+      if (strictly && step && step.gt(0)) {
+        // 与旧 Math.round 的负数中点规则保持一致：中点向正无穷方向取整。
+        decimal = decimal.div(step).toDecimalPlaces(0, Decimal.ROUND_HALF_CEIL).times(step)
+      }
+      const min = parseDecimal(this.min)
+      const max = parseDecimal(this.max)
+      if (min && decimal.lt(min)) decimal = min
+      if (max && decimal.gt(max)) decimal = max
+      return decimal
+    },
+    changeStringValue(valStr) {
+      const decimal = parseDecimal(valStr)
+      const value = decimal ? this.formatStringValue(this.constrainStringValue(decimal, this.stepStrictly), valStr) : undefined
+      this.setStringDisplay(value)
+      this.$nextTick(() => {
+        if (this.value !== value) {
+          this.$emit('input', value)
+          this.$emit('change', value)
+          this.dispatch('ElFormItem', 'el.form.change', [value])
+        }
+      })
+    },
     focusFn() {
       this.isFocus = true
       if (!this.disabled && this.valueStr) {
@@ -211,6 +266,16 @@ export default {
     },
     stepFn(ev) {
       if ((ev.code === 'ArrowUp' || ev.code === 'ArrowDown') && !this.disabled) {
+        if (this.stringMode) {
+          const value = parseDecimal(this.valueStr)
+          const step = parseDecimal(this.step)
+          if (value && step && step.gt(0)) {
+            ev.preventDefault()
+            const next = ev.code === 'ArrowUp' ? value.plus(step) : value.minus(step)
+            this.valueStr = this.formatStringValue(this.constrainStringValue(next), this.valueStr)
+          }
+          return
+        }
         let val = N(this.valueStr)
         if (!isNaN(val)) {
           ev.preventDefault()
@@ -231,6 +296,15 @@ export default {
       }
     },
     inputFn(valStr) {
+      if (this.stringMode) {
+        // 编辑中的符号和小数点暂时保留，完整值在失焦时统一规范化。
+        if (['', '-', '+', '.', '-.', '+.'].includes(valStr) || parseDecimal(valStr)) {
+          this.preValue = valStr
+        } else {
+          this.valueStr = this.preValue
+        }
+        return
+      }
       if (valStr !== '-' && isNaN(valStr.replace(/,/g, ''))) {
         this.valueStr = this.preValue
       } else {
@@ -244,6 +318,11 @@ export default {
         this.changeIng = false
       })
 
+      if (this.stringMode) {
+        this.changeStringValue(valStr)
+        return
+      }
+
       let val = N(valStr)
       if (isNaN(val)) {
         this.valueStr = ''

package/src/components/InputNumber/numberRange.vue

@@ -62,11 +62,12 @@ export default {
   methods: {
     startChange(val) {
       this.$emit('update:start-value', val)
-      this.$emit('change', [this.startValue, this.endValue])
+      // .sync 的父组件更新尚未完成，使用本次输入值确保 change 包含最新端点。
+      this.$emit('change', [val, this.endValue])
     },
     endChange(val) {
       this.$emit('update:end-value', val)
-      this.$emit('change', [this.startValue, this.endValue])
+      this.$emit('change', [this.startValue, val])
     },
     blurFn() {
       this.$emit('blur', [this.startValue, this.endValue])

package/src/components/Table/filters.js

@@ -1,5 +1,6 @@
 import numerify from 'numerify'
 import dayjs from 'dayjs'
+import { formatExchangeRate } from '../../utils/decimal'
 
 function tplFn(row, sc, mck, map = {}) {
   let str = ''
@@ -10,7 +11,7 @@ function tplFn(row, sc, mck, map = {}) {
       let key = kA[0]
       if (kA.length === 1) {
         str += row[key]
-      } else if (row[key] || row[key] === 0) {
+      } else if (row[key] || row[key] === 0 || kA[1] === 'exchangeRate') {
         let type = kA[1]
         switch (type) {
           case 'money':
@@ -19,6 +20,10 @@ function tplFn(row, sc, mck, map = {}) {
           case 'rate':
             str += numerify(row[key], '0.000000', Math.floor)
             break
+          // 汇率单独使用高精度格式，保留历史 rate 的 6 位展示规则。
+          case 'exchangeRate':
+            str += formatExchangeRate(row[key])
+            break
           case 'map':
             str += map[row[key]]
             break

package/src/components/TablePro/index.js

@@ -3,6 +3,7 @@ import 'vxe-table/lib/style.css'
 import filterContent from './filterContent.vue'
 import numerify from 'numerify'
 import dayjs from 'dayjs'
+import { formatExchangeRate } from '../../utils/decimal'
 import { $lc } from '../../utils/i18n/index.js'
 import zhCN from 'vxe-table/lib/locale/lang/zh-CN'
 import { getColumnField, getRowValue, getVxeCore, setVxeVersion } from './compat.js'
@@ -136,6 +137,10 @@ if (vxeFormats && typeof vxeFormats.mixin === 'function') {
         return '--'
       }
     },
+    // 独立的汇率格式支持字符串值，参数可指定展示的小数位数。
+    formatExchangeRate({ cellValue }, decimalPlaces = 20) {
+      return formatExchangeRate(cellValue, decimalPlaces)
+    },
     // 格式化时间，默认 yyyy-MM-dd HH:mm:ss
     formatDatetime({ cellValue }) {
       if (cellValue) {

package/src/components/TablePro/index.vue

@@ -143,7 +143,6 @@ import tableSetSize from '../TableSetSize/index.vue'
 import { $lc } from '../../utils/i18n/index.js'
 import { getColumnField, getEventField, isVxe320OrNewer, normalizeArray } from './compat.js'
 
-
 /** 将 Element 表格风格的 show-overflow-tooltip 转为 vxe-column 的 show-overflow */
 function hasOverflowTooltipKey(item) {
   return (
@@ -153,8 +152,7 @@ function hasOverflowTooltipKey(item) {
 }
 
 function applyTooltipToShowOverflow(item) {
-  const explicitOverflow =
-    item.showOverflow !== undefined ? item.showOverflow : item['show-overflow']
+  const explicitOverflow = item.showOverflow !== undefined ? item.showOverflow : item['show-overflow']
   const hasTooltipKey = hasOverflowTooltipKey(item)
   if (!hasTooltipKey && explicitOverflow === undefined) {
     return item
@@ -704,7 +702,7 @@ export default {
         // 计算所有列的基础宽度总和
         let totalBaseWidth = 0
         columns.forEach((column) => {
-          if (column.static && column.label === $lc("操作") && !column.width && !column.minWidth) {
+          if (column.static && column.label === $lc('操作') && !column.width && !column.minWidth) {
             column.width = 180
           }
           if (column.type === 'checkbox') {
@@ -728,17 +726,27 @@ export default {
             baseWidth = parseInt(widthValue) || 0
           }
           column['_baseWidth_'] = baseWidth
+          column['width'] = `${baseWidth}px`
+          column['min-width'] = undefined
+          column['minWidth'] = undefined
           totalBaseWidth += baseWidth
         })
         // 如果所有列的基础宽度总和 >= 容器宽度，不做处理
-        if (totalBaseWidth >= windowWidth) {
+        if (totalBaseWidth >= windowWidth + 200) {
           return columns
         } else {
           const seqColumns = columns.filter((item) => item.type !== 'seq' && item.type !== 'checkbox')
           if (seqColumns.length > 0) {
             seqColumns[0].width = ''
           }
-          return columns
+          return columns.map((column) => {
+            if (!column.type) {
+              const rate = column['_baseWidth_'] / totalBaseWidth
+              column['width'] = Math.ceil(windowWidth * rate) + 35
+              return column
+            }
+            return column
+          })
         }
       }
       return calc(columns)

package/src/index.js

@@ -134,6 +134,7 @@ import { type } from './utils/judgeType.js'
 import list2tree from './utils/list2tree'
 import { msgPor, msgboxPor } from './utils/msgboxPor.js'
 import N from './utils/numberPor.js' // 扩展Number
+import { Decimal, formatExchangeRate } from './utils/decimal.js' // 高精度汇率计算与展示
 import { closeTab, linkGo, linkPush } from './utils/urlToGo'
 import { accountFormat } from './utils/accountFormat'
 
@@ -409,6 +410,8 @@ export {
   list2tree,
   monitor,
   numerify,
+  Decimal,
+  formatExchangeRate,
   operatingStatus,
   realUrl,
   refreshTab,

package/src/utils/decimal.js

@@ -0,0 +1,19 @@
+import DecimalJs from 'decimal.js'
+
+// 独立配置，避免改变业务项目中 decimal.js 的全局精度；80 位为中间乘除保留余量。
+export const Decimal = DecimalJs.clone({ precision: 80, rounding: DecimalJs.ROUND_HALF_UP })
+
+// 输入和格式化共用十进制解析，不经过 Number，空值和非有限值不作为有效数字。
+export function parseDecimal(value) {
+  if (value === undefined || value === null || value === '') return null
+  const text = String(value).replace(/,/g, '').trim()
+  if (!/^[+-]?(?:\d+\.?\d*|\.\d+)(?:e[+-]?\d+)?$/i.test(text)) return null
+  const decimal = new Decimal(text)
+  return decimal.isFinite() ? decimal : null
+}
+
+// 汇率默认展示 20 位小数，零值正常展示，缺失或非法值使用表格统一占位符。
+export function formatExchangeRate(value, decimalPlaces = 20) {
+  const decimal = parseDecimal(value)
+  return decimal ? decimal.toDecimalPlaces(decimalPlaces).toFixed(decimalPlaces) : '--'
+}

package/src/utils/toExcel.js

@@ -45,6 +45,10 @@ export default async function toExcel() {
           if (/\|\s?rate/.test(col.formatter)) {
             _col.style.numFmt = '0.000000'
           }
+          // 高精度汇率按文本展示；rows 中的原值也必须为字符串。
+          if (/\|\s?exchangeRate/.test(col.formatter) || col.formatter === 'formatExchangeRate') {
+            _col.style.numFmt = '@'
+          }
         }
 
         cols.push(_col)