Other

其他

Description:

  • 其他

Source:

Methods

(static) calculateCursorPosition(prevPos, prevCtrlValue, rawValue, ctrlValue, optionsopt) → {number}

Description:

  • 计算输入框的值格式化后光标位置

Source:
Since:
  • 4.6.0
See:
Parameters:
Name Type Attributes Description
prevPos number

赋值前的光标位置，onChange/onInput的光标位置 e.target.selectionEnd
prevCtrlValue string

上一个格式化后的值
rawValue string

当前输入原值
ctrlValue string

当前格式化后的值
options Object <optional>

配置项

Properties
Name Type Attributes Default Description
placeholderChar string | Array.<string> <optional>
 ' '

占位符，默认' '
maskReg RegExp <optional>
 /\D/g

需要遮盖的字符规则。默认/\D/g 去掉非数字，意味着 ctrlValue 需要去掉非数字。
type 'mobile' | 'bankCard' <optional>

格式化类型，内置手机号码和银行卡号特殊处理
Returns:

格式化后的光标位置

Type
number

(async, static) checkResult(fnopt, …argsopt) → {Promise.<boolean>}

Description:

  • 检查函数执行结果。

    如果函数执行异常或返回下列结果，则返回 false ，否则返回 true。

    1. Promise.reject()
    2. Promise.resolve(false)
    3. false
Source:
Since:
  • 5.5.0
Example
await checkResult(()=>throw new Error());      // false
await checkResult(()=>Promise.reject());       // false
await checkResult(()=>Promise.resolve(false)); // false
await checkResult(async ()=>false);            // false
await checkResult(()=>false);                  // false

await checkResult(undefined);                  // true
await checkResult(()=>true);                   // true
await checkResult(()=>Promise.resolve());      // true
await checkResult(async ()=>true);             // true
await checkResult(()=>null);                   // true
await checkResult(()=>undefined);              // true
await checkResult(()=>'foo');                  // true

// 传入参数
await checkResult((...args)=>args.length > 1); // false
await checkResult((...args)=>args.length > 1, 'a', 'b'); // true
Parameters:
Name Type Attributes Default Description
fn function <optional>
 ()=>true

处理函数，默认 ()=>true。
args * <optional>
<repeatable>

展开参数，fn 执行参数。
Returns:
Type
Promise.<boolean>

(static) getExtname(path)

Description:

  • 获取路径的扩展名。

Source:
Since:
  • 5.4.0
See:
Example
getExtname('index.html'); // '.html'
getExtname('index.coffee.md'); // '.md'
getExtname('index.'); // '.'
getExtname('index'); // ''
getExtname('.index'); // ''
getExtname('index.md'); // '.md'
Parameters:
Name Type Description
path string

路径。
Returns:

返回从最后一次出现 . 字符到路径最后一部分的字符串结尾。如果路径没有 . 或者除了第一个字符之外没有其他 . 字符，则返回空字符串。

(static) randomString(lenopt, poolopt) → {string}

Description:

  • 生成随机字符串

Source:
Since:
  • 4.8.0
Example
randomString(5); // slk23
randomString(8); // 71mHqo2A

// 自定义允许的字符
randomString(5, 'abc'); // ccbcb
randomString(8, 'abcefg'); // bcgcfabg
Parameters:
Name Type Attributes Default Description
len number <optional>
 0

长度，默认0
pool 'number' | 'lower' | 'upper' | string <optional>
 '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'

字符池，默认为数字和大小写字母。支持设置类型number lower upper 或字符串。
Returns:

随机字符串

Type
string

(static) strlen(str) → {number}

Description:

  • 获取字符长度。中文汉字占2个字符，英文占1个字符，特殊如emoji占4个字符。

Source:
Since:
  • 4.10.0
Example
strlen('你好a'); // 5
strlen('你好，世界！'); // 12
strlen('严両丞丽'); // 8
strlen('abcde'); // 5
strlen('𠮷'); // 4
strlen('🍎'); // 4
Parameters:
Name Type Description
str string

字符串
Returns:

字符长度

Type
number