# gt-react: General Translation React SDK: 文字列
URL: https://generaltranslation.com/ja/docs/react/guides/strings.mdx
---
title: 文字列
description: useGT を使ってプレーンテキストの文字列を国際化する方法
---

{/* 自動生成: 直接編集しないでください。content/docs-templates/ 内のテンプレートを編集してください。 */}

文字列翻訳を使うと、JSX を使わずにテキストを直接翻訳できるため、属性、オブジェクトのプロパティ、プレーンテキスト値に最適です。React コンポーネントで文字列翻訳を行うには、[`useGT`](/docs/react/api/strings/use-gt) を使用します。


## クイックスタート

```jsx
import { useGT } from 'gt-react';

function MyComponent() {
  const gt = useGT();
  return (
    <input 
      placeholder={gt('Enter your email')}
      title={gt('Email address field')}
    />
  );
}
```


## 文字列翻訳を使う場面

JSX ではなくプレーンテキストが必要な場合は、文字列翻訳が適しています：

### HTML 属性

```jsx
const gt = useGT();

<input 
  placeholder={gt('Search products...')}
  aria-label={gt('Product search input')}
  title={gt('Type to search our catalog')}
/>
```


### オブジェクトのプロパティ

```jsx
const gt = useGT();

const user = {
  name: 'John',
  role: 'admin',
  bio: gt('Experienced software developer with 5 years in React'),
  status: gt('Currently available for projects')
};
```


### 設定と定数

```jsx
const gt = useGT();

const navigationItems = [
  { label: gt('Home'), href: '/' },
  { label: gt('Products'), href: '/products' },
  { label: gt('Contact'), href: '/contact' }
];
```


### 代わりに T を使用する場合

JSX コンテンツには、[`<T>` コンポーネント](/docs/react/api/components/t)を使用します。

```jsx
// ✅ JSXコンテンツには<T>を使用する
<T><p>Welcome to <strong>our store</strong>!</p></T>

// ✅ プレーンテキストには文字列翻訳を使用する
<input placeholder={gt('Search products')} />
```


## 変数を使う

### 基本の変数

プレースホルダーを動的な値で置き換えます:

```jsx
const gt = useGT();
const itemCount = 5;

// プレースホルダーを含む文字列
const message = gt('You have {count} items in your cart', { count: itemCount });
// 結果: "You have 5 items in your cart"
```


### 複数の変数

```jsx
const gt = useGT();
const order = { id: 'ORD-123', total: 99.99, date: '2024-01-15' };

const confirmation = gt(
  'Order {orderId} for ${total} was placed on {date}',
  { 
    orderId: order.id, 
    total: order.total, 
    date: order.date 
  }
);
```


### ICUメッセージフォーマット

より高度な書式設定には、ICU構文を使用します。

```jsx
const gt = useGT();
translate('There are {count, plural, =0 {no items} =1 {one item} other {{count} items}} in the cart', { count: 10 });
```

<Callout>
  ICU Message Format の詳細については、[Unicode のドキュメント](https://unicode-org.github.io/icu/userguide/format_parse/messages/)を参照してください。
</Callout>

## 例

### フォーム入力

```jsx
import { useGT } from 'gt-react';

function ContactForm() {
  const gt = useGT();
  
  return (
    <form>
      <input 
        type="email"
        placeholder={gt('Enter your email address')}
        aria-label={gt('Email input field')}
      />
      <textarea 
        placeholder={gt('Tell us about your project...')}
        aria-label={gt('Project description')}
      />
      <button type="submit">
        {gt('Send Message')}
      </button>
    </form>
  );
}
```


### ナビゲーション メニュー

```jsx
import { useGT } from 'gt-react';

function Navigation() {
  const gt = useGT();
  
  const menuItems = [
    { label: gt('Home'), href: '/', icon: 'home' },
    { label: gt('About Us'), href: '/about', icon: 'info' },
    { label: gt('Services'), href: '/services', icon: 'briefcase' },
    { label: gt('Contact'), href: '/contact', icon: 'mail' }
  ];

  return (
    <nav>
      {menuItems.map((item) => (
        <a key={item.href} href={item.href} title={item.label}>
          <Icon name={item.icon} />
          {item.label}
        </a>
      ))}
    </nav>
  );
}
```


### 動的コンテンツのファクトリー

```jsx
// utils/productData.js
export function getProductMessages(gt) {
  return {
    categories: [
      { id: 'electronics', name: gt('Electronics') },
      { id: 'clothing', name: gt('Clothing') },
      { id: 'books', name: gt('Books') }
    ],
    statusMessages: {
      available: gt('In stock and ready to ship'),
      backordered: gt('Currently backordered - ships in 2-3 weeks'),  
      discontinued: gt('This item has been discontinued')
    },
    errors: {
      notFound: gt('Product not found'),
      outOfStock: gt('Sorry, this item is currently out of stock')
    }
  };
}

// components/ProductCard.jsx
import { useGT } from 'gt-react';
import { getProductMessages } from '../utils/productData';

function ProductCard({ product }) {
  const gt = useGT();
  const messages = getProductMessages(gt);
  
  return (
    <div>
      <h3>{product.name}</h3>
      <p>{messages.statusMessages[product.status]}</p>
      <span>{messages.categories.find(c => c.id === product.categoryId)?.name}</span>
    </div>
  );
}
```


### ドキュメントタイトル付きのコンポーネント

```jsx
import { useGT } from 'gt-react';
import { useEffect } from 'react';

function ProductPage() {
  const gt = useGT();
  
  useEffect(() => {
    document.title = gt('Product Catalog - Find What You Need');
    
    // メタディスクリプションを更新する
    const metaDescription = document.querySelector('meta[name="description"]');
    if (metaDescription) {
      metaDescription.setAttribute('content', gt('Browse our extensive collection of high-quality products'));
    }
  }, [gt]);
  
  return (
    <div>
      <h1>{gt('Featured Products')}</h1>
      <p>{gt('Check out our latest and most popular items')}</p>
    </div>
  );
}
```


## よくある問題

### runtime の動的コンテンツ

文字列はビルド時に確定している必要があります。動的なコンテンツは翻訳できません。

```jsx
// ❌ 動的コンテンツは機能しません
function MyComponent() {
  const [userMessage, setUserMessage] = useState('');
  const gt = useGT();
  
  return <p>{gt(userMessage)}</p>; // これは動作しません
}

// ✅ 事前定義された文字列を使用する
function MyComponent() {
  const [messageType, setMessageType] = useState('welcome');
  const gt = useGT();
  
  const messages = {
    welcome: gt('Welcome to our app!'),
    goodbye: gt('Thanks for visiting!')
  };
  
  return <p>{messages[messageType]}</p>;
}
```


### フックのルール違反

[`useGT`](/docs/react/api/strings/use-gt) を使用する際は、React のフックのルールに従ってください。

```jsx
// ❌ フックを条件付きで呼び出さないでください
function MyComponent({ showMessage }) {
  if (showMessage) {
    const gt = useGT(); // フックのルール違反
    return <p>{gt('Hello!')}</p>;
  }
  return null;
}

// ✅ 常にトップレベルでフックを呼び出してください
function MyComponent({ showMessage }) {
  const gt = useGT();
  
  if (showMessage) {
    return <p>{gt('Hello!')}</p>;
  }
  return null;
}
```

<Callout>
  runtime での翻訳が必要な、真に動的なコンテンツについては、[動的コンテンツガイド](/docs/key-concepts/dynamic-content)を参照してください。
</Callout>


## 次のステップ

* [動的コンテンツガイド](/docs/key-concepts/dynamic-content) - runtime 翻訳を扱う
* [共有文字列ガイド](/docs/react/guides/shared-strings) - 再利用可能な翻訳を整理する
* API リファレンス: