react-native-relationship

中国亲戚称谓计算器 React Native 三方库（HarmonyOS/OpenHarmony，RNOH）。

基于开源项目 relationship.js（MIT License，作者 passer-by.com）移植，在鸿蒙侧以 ArkTS TurboModule 实现，支持称谓计算（default）、关系链（chain）、关系合称（pair）三种类型，内置 default / guangdong / north 三套地区数据模式。

安装

npm i react-native-relationship

使用

import relationship from 'react-native-relationship';

// 我称呼对方的称谓
relationship({text: '爸爸的哥哥', sex: 1});           // ['伯父']

// 对方称呼我的称谓
relationship({text: '儿子', sex: 1, reverse: true});   // ['爸爸']

// 两个称谓之间的关系
relationship({text: '爸爸', target: '妈妈', sex: 1});  // ['老公']

// 关系链
relationship({text: '三舅', sex: 1, type: 'chain'});   // ['妈妈的兄弟']

// 关系合称
relationship({text: '爸爸', target: '妈妈', sex: 1, type: 'pair'}); // ['夫妻']

参数（RelationshipOptions）

| 参数 | 类型 | 默认 | 说明 | | --- | --- | --- | --- | | text | string | '' | 目标对象称谓，称谓间用「的」字分隔 | | target | string | '' | 相对对象称谓，空表示自己 | | sex | number | -1 | 本人性别：0 女，1 男，-1 未知 | | type | 'default' | 'chain' | 'pair' | 'default' | 计算称谓 / 关系链 / 关系合称 | | reverse | boolean | false | true 对方称呼我，false 我称呼对方 | | mode | string | 'default' | 地区模式：default / guangdong / north | | optimal | boolean | false | 计算两者之间的最短关系 |

鸿蒙集成（RNOH）

该库为纯鸿蒙实现（ArkTS TurboModule），仅支持 @react-native-oh/react-native-harmony >= 0.84.3 的宿主。宿主 oh-package.json5 依赖 key 为：

"dependencies": {
  "@rnoh/react-native-relationship": "file:../node_modules/react-native-relationship/harmony/react_native_relationship.har"
}

License

MIT（原作者 relationship.js © passer-by.com，鸿蒙适配：坚果）