expo-localization

@amazon-devices/expo-localizationは、ネイティブのユーザーローカリゼーション情報のためのインターフェイスを提供します。このライブラリには、getCalendars()メソッドとgetLocales()メソッド、それらに対応するフックが用意されています。これらは、languageCode、uses24HourClock、currencyCode、textDirectionなど、ユーザーのロケール設定に関する固有の情報を返します。ライブラリ自体には、テキストや値の書式を設定するためのメソッドはありません。アプリのロケールが変更されると、フックが再レンダリングをトリガーします。このライブラリはシステムにデプロイされるため、別途インストールプロセスを必要とすることなくVega向けReact Nativeアプリで利用できます。この自動リンクライブラリは、実行時にアプリに接続します。ライブラリとVega向けReact Nativeとの互換性は、ライブラリがターゲットとしているVega向けReact Nativeバージョンとの間でのみ保証されます。

インストール

package.jsonファイルにJavaScriptライブラリの依存関係を追加します。

"dependencies": {
...
"@amazon-devices/expo-localization": "~2.0.1",
"@amazon-devices/keplerscript-turbomodule-api": "~1.0.0",
...
}

npm installコマンドを使用して、依存関係を再インストールします。

例

以下の例は、ユーザーの言語コードを取得する方法を示しています。

import React from 'react';
import {StyleSheet, Text, View} from 'react-native';
import {useLocales, useCalendars} from '@amazon-devices/expo-localization';

export const App = () => {
  const locales = useLocales();
  const calendars = useCalendars();

  return (
    <View style={styles.container}>
      <Text style={styles.text}>useLocales():</Text>
      <Text style={styles.text}>{JSON.stringify(locales, null, 2)}</Text>
      <Text style={styles.text}>useCalendars():</Text>
      <Text style={styles.text}>{JSON.stringify(calendars, null, 2)}</Text>
    </View>
  );
};

const styles = StyleSheet.create({
  container: {
    flex: 1,
    flexDirection: 'row',
    backgroundColor: 'white',
  },
  text: {
    color: 'black',
    fontSize: 32,
  },
});

APIリファレンス

このライブラリとAPIリファレンスの詳細については、ドキュメントページを参照してください。Expo公式ドキュメントのexpo-localizationのページ（英語のみ）を参照してください。

定数

定数	説明
`locale`	IETF BCP 47言語タグを表します。2文字の言語コードと、オプションの文字体系コード、地域コード、バリアントコードから構成されます。代わりに`Localization.getLocales()`を使用して、ユーザーの優先ロケールのリストを取得することを検討してください。

フック

フック	説明
`useCalendars`	ユーザーの優先カレンダーを一覧表示し、`Calendar`型のオブジェクトの配列を返します。少なくとも1つの要素を含むことが保証されています。常に1つの要素を返しますが、将来的には、いくつかのプラットフォームでユーザーの優先リストを返すようになる可能性があります。OSの設定が変更されると、フックは新しいカレンダーのリストで再レンダリングをトリガーします。
`useLocales`	ユーザーのロケールを一覧表示し、`Locale`型のオブジェクトの配列を返します。少なくとも1つの要素を含むことが保証されています。返される順序は、ユーザーがデバイス設定で定義した順序になります。ウェブ上では、通貨体系と測定体系は提供されず、nullとして返されます。必要に応じて、ルックアップテーブルを使用して現在の地域の通貨と測定値を推測できます。OSの設定が変更されると、フックは新しいロケールのリストで再レンダリングをトリガーします。

メソッド

メソッド	説明	サポートあり
`getCalendars`	ユーザーの優先カレンダーを一覧表示し、`Calendar`型のオブジェクトの配列を返します。少なくとも1つの要素を含むことが保証されています。常に1つの要素を返しますが、将来的には、いくつかのプラットフォームでユーザーの優先リストを返すようになる可能性があります。	✅ はい
`getLocales`	ユーザーのロケールを一覧表示し、`Locale`型のオブジェクトの配列を返します。少なくとも1つの要素を含むことが保証されています。返される順序は、ユーザーがデバイス設定で定義した順序になります。ウェブ上では、通貨体系と測定体系は提供されず、nullとして返されます。必要に応じて、ルックアップテーブルを使用して現在の地域の通貨と測定値を推測できます。	✅ はい
`getLocalizationAsync`	非推奨。	❌ いいえ

既知の問題と制限事項

Vegaでは、Localization型のregionフィールドは常にnullになります。
useLocales()、useCalendars()、getCalendars()、getLocales()の各関数は、常に要素を1つ含む配列を返しますが、ほかのプラットフォームでは、空の配列や複数の有効なロケール／カレンダーが返されることがあります。

サポートされているバージョン

パッケージのバージョン	ベース	@amazon-devices/react-native-keplerバージョン
2.0.x	14.6.0	2.0.x

Vegaライブラリとサービス

インストール

例

APIリファレンス

定数

フック

メソッド

既知の問題と制限事項

サポートされているバージョン

関連トピック

​インストール

​例

​APIリファレンス

​定数

​フック

​メソッド

​既知の問題と制限事項

​サポートされているバージョン

​関連トピック

インストール

例

APIリファレンス

定数

フック

メソッド

既知の問題と制限事項

サポートされているバージョン

関連トピック