React Native Translator
Preview
Introduce
Free translate component & hook
Never need api key, This library is Unlimited free
Support translators
Getting started
First, Install package
yarn add react-native-translator react-native-webview
Second, Pod intsall
cd ios && pod install
Third, Add provider
// App.js
...
import {TranslatorProvider} from 'react-native-translator' // here
const App = () => {
return (
<TranslatorProvider> // here
<.../>
</TranslatorProvider> // here
);
};
API
Translator ( Real-time translate )
// Usage
import Translator from 'react-native-translator';
const App = () => {
const [value, setValue] = useState('');
const [result, setResult] = useState('');
return (
<View>
<Translator
from="en"
to="fr"
value={value}
onTranslated={(t) => setResult(t)}
/>
<TextInput value={value} onChangeText={(t) => setValue(t)} />
<Text>{result}</Text>
</View>
);
};
| Props | Type | Default value | Required |
|---|---|---|---|
| from | LanguageCode |
|
|
| to | LanguageCode |
|
|
| value | string |
|
|
| type | TranslatorType | 'google' | |
| onTranslated | (result: string) => void |
|
useTranslator
// Usage
import {useTranslator} from 'react-native-translator';
const App = () => {
const {translate} = useTranslator();
const [value, setValue] = useState('');
const [result, setResult] = useState('');
const onTranslate = async () => {
const _result = await translate('en', 'fr', value);
setResult(_result);
};
return (
<View>
<TextInput value={value} onChangeText={(t) => setValue(t)} />
<Text>{result}</Text>
<Button title="translate" onPress={onTranslate} />
</View>
);
};
translate
// const {translate} = useTranslator();
type translate: <T extends TranslatorType>(/* check follow param table */) => Promise<string>;
| param | Type | Default value | Required |
|---|---|---|---|
| from | LanguageCode |
|
|
| to | LanguageCode |
|
|
| value | string |
|
|
| option | {type?: TranslatorType, timeout?: number} | {type: 'google', timeout: 5000} |
languageCodeConverter
❗️ If conversion is not possible, return undefined.
import {languageCodeConverter} from 'react-native-translator';
// google language code convert to kakao language code
languageCodeConverter('google', 'kakao', 'ko'); // kr
TranslatorType
type TranslatorType = 'google' | 'kakao' | 'papago';
LanguageCode
type LanguageCode<T extends TranslatorType> ...
// Usage
type GoogleLanguageCode = LanguageCode<'google'>;
VALUES
import {LANGUAGE_CODES, TRANSLATOR_TYPES} from 'react-native-translator';
// translator types
TRANSLATOR_TYPES; // ["google", "papago", "kakao", ...]
// language code
LANGUAGE_CODES['google']; // ["af", "ga", "sq", ...]
Support languages
| Language | Papago | Kakao | |
|---|---|---|---|
| Afrikaans | af | ||
| Irish | ga | ||
| Albanian | sq | ||
| Italian | it | it | it |
| Arabic | ar | ar | |
| Japanese | ja | ja | jp |
| Azerbaijani | az | ||
| Kannada | kn | ||
| Basque | eu | ||
| Korean | ko | ko | kr |
| Bengali | bn | bn | |
| Latin | la | ||
| Belarusian | be | ||
| Latvian | lv | ||
| Bulgarian | bg | ||
| Lithuanian | lt | ||
| Catalan | ca | ||
| Macedonian | mk | ||
| Chinese Simplified | zh-CN | zh-CN | cn |
| Malay | ms | ||
| Chinese Traditional | zh-TW | zh-TW | cn |
| Maltese | mt | ||
| Croatian | hr | ||
| Norwegian | no | ||
| Czech | cs | ||
| Persian | fa | ||
| Danish | da | ||
| Polish | pl | ||
| Dutch | nl | nl | |
| Portuguese | pt | pt | |
| English | en | en | en |
| Romanian | ro | ||
| Esperanto | eo | ||
| Russian | ru | ru | ru |
| Estonian | et | ||
| Serbian | sr | ||
| Filipino | tl | ||
| Slovak | sk | ||
| Finnish | fi | ||
| Slovenian | sl | ||
| French | fr | fr | fr |
| Spanish | es | es | es |
| Galician | gl | ||
| Swahili | sw | ||
| Georgian | ka | ||
| Swedish | sv | ||
| German | de | de | de |
| Tamil | ta | ||
| Greek | el | ||
| Telugu | te | ||
| Gujarati | gu | ||
| Thai | th | th | th |
| Haitian Creole | ht | ||
| Turkish | tr | tr | |
| Hebrew | iw | ||
| Ukrainian | uk | ||
| Hindi | hi | hi | |
| Urdu | ur | ||
| Hungarian | hu | ||
| Vietnamese | vi | vi | vi |
| Icelandic | is | ||
| Welsh | cy | ||
| Indonesian | id | id | id |
| Yiddish | yi |
3 Feb 12, 2022
37 Nov 22, 2022
18 Nov 30, 2022
1 Dec 25, 2021
2.8k Jan 5, 2023
2 Mar 29, 2022
51 Dec 13, 2022
4 Nov 28, 2022
7 Nov 16, 2022
22 Dec 15, 2022
37 Oct 16, 2022
12 Nov 1, 2022
8.7k Dec 30, 2022
36 Aug 14, 2022
270 Dec 29, 2022
23 Nov 25, 2022
314 Jan 6, 2023
1 Dec 21, 2021