# toPinyin

**Repository Path**: huajietech/toPinyin

## Basic Information

- **Project Name**: toPinyin
- **Description**: uniapp 文字汉字一键转拼音，转简写，转首字母 插件改进版 原作者: https://ext.dcloud.net.cn/plugin?id=3294
- **Primary Language**: JavaScript
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2023-02-16
- **Last Updated**: 2024-06-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<!--
 * @Autor: hlb
 * @Date: 2020-11-25 17:55:43
 * @LastEditors: hlb
 * @LastEditTime: 2020-11-25 18:37:46
 * @description: description
-->
# toPinyin
# uniapp 文字汉字一键转拼音，转简写，转首字母 
封装了下使用方法，原作者: lieft@qq.com https://ext.dcloud.net.cn/plugin?id=3294

# 1、引入js
```
import toPinyin from "./toPinyin"
```

# 2、转拼音
```
toPinyin.chineseToPinYin('你好')
```
输出

NiHao

# 3、转首字母
```
toPinyin.chineseToInitials(toPinyin.chineseToPinYin('你好'))
```
或者
```
toPinyin.chineseToInitials('NiHao')
```
输出

NH

提供个一位数组转成按照首字母排序的方法(在 `utils.js` 文件中)：
```
import toPinyin from "./toPinyin";

/**
 * 根据拼音首字母筛选排序分组
 * @param {Array} arr 原数组
 * @param {String} key 原数组需要筛选的字段
 * @returns {Array} 返回一个[{name: A,value: []}] 格式的二维数组
 */
export function getGroupByPinyin(arr, key = 'name') {
    if(!arr) return
    
    // 获取A-Z字母数组
    let keys = [...Array(26).keys()].map((i) => String.fromCharCode(i + 65));
    
    arr = arr.map((n) => ({
        ...n,
        py: toPinyin.chineseToInitials(
            toPinyin.chineseToPinYin(n[key].substr(0, 1))
        ),
    }));

    let group = [];
    for (const i of keys) {
        // 新数组一级结构，可自行修改
        let item = {
            name: i,
            value: [],
        };
        for (const j of arr) {
            if (j.py === i) {
                item.value.push(j);
            }
        }
        if (item.value.length > 0) {
            item.value.sort((a, b) => a[key].localeCompare(b[key]));
            group.push(item);
        }
    }
    return group;
}
```