OSCHINA-MIRROR/theajack-cnchar

🚀 Полнофункциональная библиотека hanyu pinyin strokes для JavaScript с поддержкой множества платформ

Пример использования

Прежде чем приступить к изучению документации, давайте рассмотрим несколько примеров использования, чтобы понять, что может cnchar.

Предисловие

Спасибо за вашу поддержку cnchar. Поскольку словарь cnchar взят из... ### Интернет

Хотя он был модифицирован и расширен мной, всё ещё неизбежно возникают ошибки и пробелы. Я надеюсь, вы сможете обратная связь сообщить об ошибках и пробелах, обнаруженных при использовании (или исправить их и отправить самостоятельно, и они будут объединены в cnchar после проверки без ошибок).

Я хочу сообщить об ошибках или упущениях.

Быстрое использование

Используйте npm для установки:

npm i cnchar

import cnchar from 'cnchar';
'汉字'.spell();
'汉字'.stroke();

Используйте тег script для использования:

<script src="https://fastly.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
<script>
    '汉字'.spell();
    '汉字'.stroke();
</script>

1. Функции

Получение китайского пиньинь, поддержка начальной буквы, капитализации, разделения массива, необязательных полифонических слов и других функций.
Поддержка полифонических слов, тона пиньинь.
Получение количества штрихов китайских иероглифов, порядка штрихов и подробных названий штрихов.
Поддержка визуализации рисования китайских штрихов, доступны различные режимы рисования.
Поддержка синтеза речи и распознавания речи.
Поддержка группировки китайских иероглифов и интерпретации китайских иероглифов.
Поддержка упрощённых символов, традиционных символов, взаимного преобразования марсианских символов.
Поддержка поиска всех китайских иероглифов с определённым пиньинем, традиционными символами, полифоническими символами.
Поддержка поиска всех китайских иероглифов с указанным количеством штрихов, традиционных китайских иероглифов.
Поддержка поиска по порядку штрихов китайских иероглифов.
Поддержка информации о поиске пиньинь, включая инициалы, финали, тона, тональные позиции и т. д.
Поддержка функций традиционных символов пиньинь, количества штрихов и всех вышеперечисленных функций для достижения тех же функций, что и упрощённые символы.
Поддержка функции запроса идиом, можно запрашивать идиомы в соответствии с китайскими иероглифами, пиньинем (тоном) и количеством штрихов.
Поддержка функции запроса сехоуюй, поддержка нечёткого запроса.
Поддержка функции запроса радикалов.
Поддержка случайно генерируемых пиньинь, китайских иероглифов, слов, идиом, сехоуюй, китайских имён.
Поддержка запроса кода китайского иероглифа, запроса информации о китайском иероглифе.
Поддержка метода ввода пиньинь, метода ввода уби, поддержка ассоциативного ввода.
Поддержка пользовательских плагинов, независимый и простой доступ к методу, полное использование всех функций cnchar.
Поддержка настраиваемых штрихов пиньинь и других данных, более гибкое использование.
Для некоторых больших словарей поддерживается автономное использование, настраиваемое развёртывание.
Предоставляет инструменты для работы с китайскими иероглифами для облегчения работы разработчиков с пиньинем и китайскими иероглифами более удобно и эффективно.
Небольшой размер, минимальная версия составляет всего 75 КБ, zip-версия — 50 КБ (содержит большое количество словарей китайского пиньинь).
Доступно для нескольких терминалов, может использоваться для браузера, nodejs, апплета/мини-игры, ReactNative/Weex/Uniapp/Electron, webpack..., поддерживает все среды, где может работать js.
typescript, основная библиотека и все библиотеки плагинов разработаны с использованием typescript.
Богатая конфигурация, разделена на плагины в зависимости от функций, доступна по запросу.
Поддержка IE9 и выше.

2. Обзор функций и плагинов

Учитывая различные потребности, функции cnchar разделены на следующие несколько библиотек плагинов, которые удобны для разработчиков по требованию:

Название	Описание	Особенности	Поддерживаемые версии	Поддержка Node	Мини-программы
cnchar	Основная библиотека js, остальные три библиотеки зависят от этой библиотеки	Содержит такие функции, как упрощённый китайский пиньинь, полифонические символы, тон, количество штрихов и т.д.	--	Да	Да
cnchar-poly	Полифонический тезаурус	Содержит функцию идентификации. **polysyllabic words	--	Да	Да

cnchar-order | Библиотека порядка штрихов | Содержит функции для определения порядка штрихов, названия штриха, формы штриха и т. д. | -- | Да | Да |

cnchar-trad | Традиционная библиотека шрифтов | Поддержка традиционных, упрощённых преобразований, поддержка традиционных пиньинь штрихов и полифонических символов полная функция | -- | Да | Да |

cnchar-draw | Библиотека рисования штрихов | Поддерживает визуальное рисование китайских иероглифов, эту библиотеку можно использовать без cnchar, эта библиотека доступна только в среде браузера |

2.1+ | Нет | Частично |

cnchar-idiom | Библиотека идиом | Поддержка запроса идиом и других функций |

2.2+ | Да | Да |

cnchar-xhy | Библиотека Се Хоу Юй | Поддержка запроса Се Хоу Юй и других функций |

2.2+ | Да | Да |

cnchar-radical | Библиотека радикалов | Поддержка запросов китайских радикалов |

2.2.5+ | Да | Да |

cnchar-words | Тезаурус группы китайских иероглифов | Поддержка запросов фраз на основе одного или нескольких китайских иероглифов |

3.1.0+ | Да | Да |

cnchar-explain | Библиотека интерпретации китайских иероглифов | Поддержка запроса значения китайских иероглифов |

3.1.0+ | Да | Да |

cnchar-voice | Распознавание речи и синтез речи | Поддерживает китайское произношение и синтез |

3.1.0+ | Нет | Частично |

cnchar-data | Оффлайн словарь | Для поддержки автономного использования и пользовательского развёртывания некоторых подключаемых библиотек |

3.1.0+ | Да | Да ||

cnchar-random | Случайная библиотека | Произвольно генерирует пиньинь, китайские иероглифы, слова, идиомы, Се Хоу Юй |

3.2.0+ | Да | Да |

cnchar-input | Поддержка метода ввода | Поддержка результатов метода ввода пиньинь и Уби |

3.2.0+ | Да | Да |

cnchar-code | Библиотека кодирования китайских иероглифов | Запрос кодирования китайских иероглифов |

3.2.0+ | Да | Да |

cnchar-info | Запрос информации о китайских иероглифах | Используется для запроса информации о китайских иероглифах |

3.2.0+ | Да | Да |

cnchar-name | Информация о китайском имени | Используется для генерации имён случайным образом |

3.2.0+ | Да | Да |

3. Установка

3.1 Установка с помощью npm

Установите базовую библиотеку:

npm i cnchar

Установите дополнительную функциональную библиотеку:

npm i cnchar-poly cnchar-order cnchar-trad cnchar-draw cnchar-idiom cnchar-xhy cnchar-radical cnchar-words cnchar-explain cnchar-voice cnchar-random cnchar-code cnchar-input cnchar-info cnchar-name

Конечно, вы также можете установить некоторые из них по запросу, и подключаемую библиотеку также можно установить и использовать независимо от cnchar, но некоторые функции хранилища сильно зависят от cnchar, например, cnchar-poly, cnchar-order, cnchar-trad. Или вы можете использовать все функции, установив cnchar-all, эта библиотека ссылается на все вышеперечисленные подключаемые библиотеки

npm i cnchar-all

3.2 Введение с использованием cdn

Если jsdelivr не работает, вы можете использовать unpkg (https://unpkg.com/cnchar/cnchar.min.js)

<script src="https://fastly.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-poly/cnchar.poly.min.js"></script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-order/cnchar.order.min.js"></script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-trad/cnchar.trad.min.js"></script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-draw/cnchar.draw.min.js"></script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-idiom/cnchar.idiom.min.js"></script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-xhy/cnchar.xhy.min.js"></script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-radical/cnchar.radical.min.js"></script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-words/cnchar.words.min.js"></script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-explain/cnchar.explain.min.js"></script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-voice/cnchar.voice.min.js"></script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-random/cnchar.random.min.js"></script>