util-helpers 4.5.0 → 4.6.0

package/esm/calculateCursorPosition.js

@@ -0,0 +1,62 @@
+import normalizeString from './normalizeString'; // ref: https://github.com/ant-design/ant-design-mobile/blob/v2/components/input-item/index.tsx#L240
+
+/**
+ * 计算输入框的值格式化后光标位置
+ *
+ * @static
+ * @alias module:Other.calculateCursorPosition
+ * @since 4.6.0
+ * @see 格式化手机号码 {@link https://doly-dev.github.io/util-helpers/module-Processor.html#.formatMobile|formatMobile}
+ * @see 格式化银行卡号 {@link https://doly-dev.github.io/util-helpers/module-Processor.html#.formatBankCard|formatBankCard}
+ * @see 示例 {@link https://2950v9.csb.app/|点击查看}
+ * @param {number} prevPos 赋值前的光标位置，onChange/onInput的光标位置 e.target.selectionEnd
+ * @param {string} prevCtrlValue 上一个格式化后的值
+ * @param {string} rawValue 当前输入原值
+ * @param {string} ctrlValue 当前格式化后的值
+ * @param {Object} [options] 配置项
+ * @param {string[]|string} [options.placeholderChar=' '] 占位符
+ * @param {RegExp} [options.maskReg=/\D/g] 需要遮盖的字符规则。默认去掉非数字，意味着 ctrlValue 需要去掉非数字。
+ * @param {'mobile'|'bankCard'} [options.type] 格式化类型，内置手机号码和银行卡号特殊处理
+ * @returns {number} 格式化后的光标位置
+ */
+
+function calculateCursorPosition(prevPos, prevCtrlValue, rawValue, ctrlValue) {
+  var _ref = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : {},
+      _ref$placeholderChar = _ref.placeholderChar,
+      placeholderChar = _ref$placeholderChar === void 0 ? ' ' : _ref$placeholderChar,
+      _ref$maskReg = _ref.maskReg,
+      maskReg = _ref$maskReg === void 0 ? /\D/g : _ref$maskReg,
+      type = _ref.type;
+
+  var realCtrlValue = normalizeString(prevCtrlValue);
+  var realRawValue = normalizeString(rawValue);
+  var placeholderChars = Array.isArray(placeholderChar) ? placeholderChar : [placeholderChar];
+  var editLength = realRawValue.length - realCtrlValue.length;
+  var isAddition = editLength > 0;
+  var pos = prevPos;
+
+  if (isAddition) {
+    var additionStr = realRawValue.substring(pos - editLength, pos);
+    var ctrlCharCount = additionStr.replace(maskReg, '').length;
+    pos -= editLength - ctrlCharCount;
+    var placeholderCharCount = 0;
+
+    while (ctrlCharCount > 0) {
+      if (placeholderChars.indexOf(ctrlValue.charAt(pos - ctrlCharCount + placeholderCharCount)) !== -1) {
+        placeholderCharCount++;
+      } else {
+        ctrlCharCount--;
+      }
+    }
+
+    pos += placeholderCharCount;
+  }
+
+  if (type === 'mobile' && (pos === 4 || pos === 9) || type === 'bankCard' && pos > 0 && pos % 5 === 0) {
+    pos -= 1;
+  }
+
+  return pos;
+}
+
+export default calculateCursorPosition;

package/esm/formatMobile.js

@@ -12,8 +12,15 @@ import normalizeString from './normalizeString';
  * @example
  * formatMobile('13345678900') // '133 4567 8900'
  * formatMobile('13345678900', { char: '-' }) // '133-4567-8900'
+ *
+ * // 脱敏手机号码
  * formatMobile('133****1234') // '133 **** 1234'
  * formatMobile('133****1234', { char: '-' }) // '133-****-1234'
+ *
+ * // 手机号码位数不够
+ * formatMobile('133') // '133'
+ * formatMobile('133456') // '133 456'
+ * formatMobile('13345678') // '133 4567 8'
  */
 
 function formatMobile(mobileNo) {

package/esm/index.js

@@ -66,6 +66,7 @@ export { default as round } from './round';
  */
 
 export { default as waitTime } from './waitTime';
+export { default as calculateCursorPosition } from './calculateCursorPosition';
 /**
  * 调试相关
  *

package/esm/normalizeString.js

@@ -5,7 +5,7 @@ import convertToString from './utils/convertToString';
  *
  * @static
  * @alias module:Processor.normalizeString
- * @see 参考 {@link tttps://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#string_instances|String}
+ * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#string_instances|String}
  * @since 4.3.0
  * @param {*} value 待处理的值
  * @returns {string} 规整化的值

package/lib/calculateCursorPosition.js

@@ -0,0 +1,73 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+
+var _normalizeString = _interopRequireDefault(require("./normalizeString"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+
+// ref: https://github.com/ant-design/ant-design-mobile/blob/v2/components/input-item/index.tsx#L240
+
+/**
+ * 计算输入框的值格式化后光标位置
+ *
+ * @static
+ * @alias module:Other.calculateCursorPosition
+ * @since 4.6.0
+ * @see 格式化手机号码 {@link https://doly-dev.github.io/util-helpers/module-Processor.html#.formatMobile|formatMobile}
+ * @see 格式化银行卡号 {@link https://doly-dev.github.io/util-helpers/module-Processor.html#.formatBankCard|formatBankCard}
+ * @see 示例 {@link https://2950v9.csb.app/|点击查看}
+ * @param {number} prevPos 赋值前的光标位置，onChange/onInput的光标位置 e.target.selectionEnd
+ * @param {string} prevCtrlValue 上一个格式化后的值
+ * @param {string} rawValue 当前输入原值
+ * @param {string} ctrlValue 当前格式化后的值
+ * @param {Object} [options] 配置项
+ * @param {string[]|string} [options.placeholderChar=' '] 占位符
+ * @param {RegExp} [options.maskReg=/\D/g] 需要遮盖的字符规则。默认去掉非数字，意味着 ctrlValue 需要去掉非数字。
+ * @param {'mobile'|'bankCard'} [options.type] 格式化类型，内置手机号码和银行卡号特殊处理
+ * @returns {number} 格式化后的光标位置
+ */
+function calculateCursorPosition(prevPos, prevCtrlValue, rawValue, ctrlValue) {
+  var _ref = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : {},
+      _ref$placeholderChar = _ref.placeholderChar,
+      placeholderChar = _ref$placeholderChar === void 0 ? ' ' : _ref$placeholderChar,
+      _ref$maskReg = _ref.maskReg,
+      maskReg = _ref$maskReg === void 0 ? /\D/g : _ref$maskReg,
+      type = _ref.type;
+
+  var realCtrlValue = (0, _normalizeString["default"])(prevCtrlValue);
+  var realRawValue = (0, _normalizeString["default"])(rawValue);
+  var placeholderChars = Array.isArray(placeholderChar) ? placeholderChar : [placeholderChar];
+  var editLength = realRawValue.length - realCtrlValue.length;
+  var isAddition = editLength > 0;
+  var pos = prevPos;
+
+  if (isAddition) {
+    var additionStr = realRawValue.substring(pos - editLength, pos);
+    var ctrlCharCount = additionStr.replace(maskReg, '').length;
+    pos -= editLength - ctrlCharCount;
+    var placeholderCharCount = 0;
+
+    while (ctrlCharCount > 0) {
+      if (placeholderChars.indexOf(ctrlValue.charAt(pos - ctrlCharCount + placeholderCharCount)) !== -1) {
+        placeholderCharCount++;
+      } else {
+        ctrlCharCount--;
+      }
+    }
+
+    pos += placeholderCharCount;
+  }
+
+  if (type === 'mobile' && (pos === 4 || pos === 9) || type === 'bankCard' && pos > 0 && pos % 5 === 0) {
+    pos -= 1;
+  }
+
+  return pos;
+}
+
+var _default = calculateCursorPosition;
+exports["default"] = _default;

package/lib/formatMobile.js

@@ -22,8 +22,15 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
  * @example
  * formatMobile('13345678900') // '133 4567 8900'
  * formatMobile('13345678900', { char: '-' }) // '133-4567-8900'
+ *
+ * // 脱敏手机号码
  * formatMobile('133****1234') // '133 **** 1234'
  * formatMobile('133****1234', { char: '-' }) // '133-****-1234'
+ *
+ * // 手机号码位数不够
+ * formatMobile('133') // '133'
+ * formatMobile('133456') // '133 456'
+ * formatMobile('13345678') // '133 4567 8'
  */
 function formatMobile(mobileNo) {
   var _ref = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},

package/lib/index.js

@@ -237,6 +237,12 @@ Object.defineProperty(exports, "waitTime", {
     return _waitTime["default"];
   }
 });
+Object.defineProperty(exports, "calculateCursorPosition", {
+  enumerable: true,
+  get: function get() {
+    return _calculateCursorPosition["default"];
+  }
+});
 Object.defineProperty(exports, "setDisableWarning", {
   enumerable: true,
   get: function get() {
@@ -322,6 +328,8 @@ var _round = _interopRequireDefault(require("./round"));
 
 var _waitTime = _interopRequireDefault(require("./waitTime"));
 
+var _calculateCursorPosition = _interopRequireDefault(require("./calculateCursorPosition"));
+
 var _config = require("./utils/config");
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }

package/lib/normalizeString.js

@@ -16,7 +16,7 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
  *
  * @static
  * @alias module:Processor.normalizeString
- * @see 参考 {@link tttps://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#string_instances|String}
+ * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#string_instances|String}
  * @since 4.3.0
  * @param {*} value 待处理的值
  * @returns {string} 规整化的值

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "util-helpers",
-  "version": "4.5.0",
+  "version": "4.6.0",
   "description": "一个基于业务场景的工具方法库",
   "main": "lib/index.js",
   "module": "esm/index.js",

package/types/calculateCursorPosition.d.ts

@@ -0,0 +1,25 @@
+export default calculateCursorPosition;
+/**
+ * 计算输入框的值格式化后光标位置
+ *
+ * @static
+ * @alias module:Other.calculateCursorPosition
+ * @since 4.6.0
+ * @see 格式化手机号码 {@link https://doly-dev.github.io/util-helpers/module-Processor.html#.formatMobile|formatMobile}
+ * @see 格式化银行卡号 {@link https://doly-dev.github.io/util-helpers/module-Processor.html#.formatBankCard|formatBankCard}
+ * @see 示例 {@link https://2950v9.csb.app/|点击查看}
+ * @param {number} prevPos 赋值前的光标位置，onChange/onInput的光标位置 e.target.selectionEnd
+ * @param {string} prevCtrlValue 上一个格式化后的值
+ * @param {string} rawValue 当前输入原值
+ * @param {string} ctrlValue 当前格式化后的值
+ * @param {Object} [options] 配置项
+ * @param {string[]|string} [options.placeholderChar=' '] 占位符
+ * @param {RegExp} [options.maskReg=/\D/g] 需要遮盖的字符规则。默认去掉非数字，意味着 ctrlValue 需要去掉非数字。
+ * @param {'mobile'|'bankCard'} [options.type] 格式化类型，内置手机号码和银行卡号特殊处理
+ * @returns {number} 格式化后的光标位置
+ */
+declare function calculateCursorPosition(prevPos: number, prevCtrlValue: string, rawValue: string, ctrlValue: string, { placeholderChar, maskReg, type }?: {
+    placeholderChar?: string | string[] | undefined;
+    maskReg?: RegExp | undefined;
+    type?: "mobile" | "bankCard" | undefined;
+} | undefined): number;

package/types/formatMobile.d.ts

@@ -12,8 +12,15 @@ export default formatMobile;
  * @example
  * formatMobile('13345678900') // '133 4567 8900'
  * formatMobile('13345678900', { char: '-' }) // '133-4567-8900'
+ *
+ * // 脱敏手机号码
  * formatMobile('133****1234') // '133 **** 1234'
  * formatMobile('133****1234', { char: '-' }) // '133-****-1234'
+ *
+ * // 手机号码位数不够
+ * formatMobile('133') // '133'
+ * formatMobile('133456') // '133 456'
+ * formatMobile('13345678') // '133 4567 8'
  */
 declare function formatMobile(mobileNo: string, { char }?: {
     char?: string | undefined;

package/types/index.d.ts

@@ -37,4 +37,5 @@ export { default as times } from "./times";
 export { default as divide } from "./divide";
 export { default as round } from "./round";
 export { default as waitTime } from "./waitTime";
+export { default as calculateCursorPosition } from "./calculateCursorPosition";
 export { setDisableWarning } from "./utils/config";

package/types/normalizeString.d.ts

@@ -4,7 +4,7 @@ export default normalizeString;
  *
  * @static
  * @alias module:Processor.normalizeString
- * @see 参考 {@link tttps://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#string_instances|String}
+ * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#string_instances|String}
  * @since 4.3.0
  * @param {*} value 待处理的值
  * @returns {string} 规整化的值