n20-common-lib 2.22.74 → 2.22.76

package/package.json

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

package/src/components/CascaderArea/index.vue

@@ -57,13 +57,17 @@ export default {
     }
   },
   computed: {
+    isChinaUrban() {
+      return this.isUrban && this.countryId === 'CHN'
+    },
     propsAs() {
       let _prop = {
         value: 'regionNo',
         label: 'regionName',
         children: 'children',
         expandTrigger: 'hover',
-        checkStrictly: !this.isUrban
+        // 保留二级城市的子节点后，允许独立选择二级城市和三级地区。
+        checkStrictly: this.isChinaUrban || !this.isUrban
       }
       return Object.assign(_prop, this.props)
     },
@@ -75,17 +79,17 @@ export default {
     },
     streetKey() {
       return this.countryId === 'CHN' ? '_china_street_tree_' : `_${this.countryId}_street_tree_`
+    },
+    cacheKey() {
+      // 按当前模式检查缓存，避免普通地区缓存存在时误用尚未加载的城市缓存。
+      return this.isUrban ? this.urbanKey : this.isStreet ? this.streetKey : this.areaKey
     }
   },
   mounted() {
-    if (!window[this.areaKey]) {
+    if (!window[this.cacheKey]) {
       this.getAreaTree()
     } else {
-      this.areaTree = this.isUrban
-        ? window[this.urbanKey]
-        : this.isStreet
-        ? window[this.streetKey]
-        : window[this.areaKey]
+      this.areaTree = window[this.cacheKey]
     }
   },
   methods: {
@@ -100,7 +104,7 @@ export default {
           if (data) {
             let result = JSON.parse(JSON.stringify(data))
             if (this.isUrban) {
-              window[this.urbanKey] = isUrbanFn(result)
+              window[this.urbanKey] = isUrbanFn(result, this.isChinaUrban)
               this.areaTree = window[this.urbanKey]
             } else if (this.isStreet) {
               window[this.streetKey] = treeFn(result)
@@ -133,12 +137,21 @@ const treeFn = (data) => {
   })
 }
 
-const isUrbanFn = (data) => {
+const isUrbanFn = (data, isChinaUrban = false) => {
   return data?.map((res) => {
-    if (res.regionLevel === '2' || !res.children?.length) {
+    const regionLevel = String(res.regionLevel)
+    // 直辖市只保留一级节点，直接返回接口原有的两位 regionNo，不伪造下级编码。
+    const isMunicipality =
+      isChinaUrban && regionLevel === '1' && ['11', '12', '31', '50'].includes(String(res.regionNo))
+    if (isChinaUrban && regionLevel === '1' && !isMunicipality) {
+      // 普通省份仅用于展开；checkStrictly 模式下禁用父节点不影响子节点选择。
+      res.disabled = true
+    }
+    if (isMunicipality || (!isChinaUrban && regionLevel === '2') || !res.children?.length) {
       res.children = null
     } else {
-      res.children = isUrbanFn(res.children)
+      // 保留省代管县级市等三级节点，解除原先在二级统一截断的限制。
+      res.children = isUrbanFn(res.children, isChinaUrban)
     }
     return res
   })

package/src/components/Descriptions/index.vue

@@ -1,8 +1,8 @@
 <template>
-  <el-descriptions class="n20-descriptions" :column="column" size="default" border>
+  <el-descriptions class="n20-descriptions" :column="currentColumn" size="default" border>
     <slot></slot>
-    <template v-if="this.$slots.default.length === 1">
-      <el-descriptions-item v-for="(item, index) in column - 1" :key="index" />
+    <template v-if="this.$slots.default && this.$slots.default.length === 1">
+      <el-descriptions-item v-for="(item, index) in currentColumn - 1" :key="index" />
     </template>
   </el-descriptions>
 </template>
@@ -20,27 +20,48 @@ export default {
       default: true
     }
   },
+  data() {
+    return {
+      currentColumn: this.column
+    }
+  },
+  watch: {
+    column(val) {
+      this.currentColumn = val
+    },
+    autoResize(val) {
+      if (val) {
+        this.createResize()
+      } else {
+        this.currentColumn = this.column
+        this.destroyResize()
+      }
+    }
+  },
   created() {
     if (!this.autoResize) return
-    this.resize()
-    window.addEventListener('resize', this.resize)
+    this.createResize()
   },
   beforeDestroy() {
-    window.removeEventListener('resize', this.resize)
+    this.destroyResize()
   },
   methods: {
     resize() {
       let wW = document.documentElement.clientWidth
       if (wW <= 1024) {
-        this.column = 1
+        this.currentColumn = 1
       } else if (wW > 1024 && wW <= 1600) {
-        this.column = 2
+        this.currentColumn = 2
       } else if (wW > 1600 && wW <= 1920) {
-        this.column = 3
+        this.currentColumn = 3
       } else if (wW > 1920) {
-        this.column = 4
+        this.currentColumn = 4
       }
     },
+    createResize() {
+      this.resize()
+      window.addEventListener('resize', this.resize)
+    },
     destroyResize() {
       window.removeEventListener('resize', this.resize)
     }

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
       }