msg

概览

msg 函数用于标记并编码字符串，以便进行翻译。

const encodedString = msg('你好，世界！');

应将该编码后的字符串传递给 useMessages 钩子或 getTranslations 函数以获取翻译。

编码： msg 会对输入字符串进行编码，因此你不能直接在 JSX 或其他地方使用它。如果想还原原始字符串，需要使用 decodeMsg 对其进行解码。

解码

要还原原始字符串，你需要使用 decodeMsg 进行解码

import { msg, decodeMsg } from 'gt-react';
const encodedString = msg('你好，世界！');
const decodedString = decodeMsg(encodedString);
console.log(decodedString); // “你好，世界！”

参考资料

参数

名称	类型	描述
`content`	`string`	要进行编码的字符串内容。
`options?`	`InlineTranslationOptions`	自定义 `msg` 行为的翻译选项。

一个编码后的字符串，其中插值的变量（如果有）会被替换为其对应的值。

行为

生产环境

在 CD 流程中，任何位于 msg 函数内的内容都会在应用部署前完成翻译。这可确保所有 locale 的快速加载，但只能翻译构建时已知的内容。

生成后，翻译会根据你的配置（1）存储在 CDN（内容分发网络）中，或（2）存储在应用的构建产物中。随后，已翻译的内容将提供给你的用户。如果未找到对应翻译，将回退到原始内容。

请务必遵循此部署指南。

开发

在开发过程中，msg 函数会按需翻译内容。这有助于进行原型设计，预览应用在不同语言下的呈现效果。请记得在环境中添加 Dev API key 以启用此行为。

在开发环境中进行按需翻译时，你可能会看到一些延迟。在生产构建中不会出现这种情况，除非内容被明确按需翻译，即使用 tx 或 <Tx>。

示例

基本用法

可以使用 msg 标注待翻译的字符串。

import { msg, useMessages } from 'gt-react';

const encodedString = msg('你好,世界!');

export default function TranslateGreeting() {
  const m = useMessages();
  return (
    <p>
      {m(encodedString)}
    </p>
  );
}

注意：“Hello, world!” 将会根据用户的首选语言进行翻译。

使用变量

你可以向字典中的翻译传入变量。

import { msg, useMessages } from 'gt-react';

const encodedString = msg('你好，{name}！', { name: 'Alice' });

export default function TranslateGreeting() {
  const m = useMessages();

  return (
    <p>
      {m(encodedString)}
    </p>
  );
}

Note: "Alice" 不会被翻译成用户的首选语言，因为它是一个变量。

使用 ICU 消息格式

gt-react 支持 ICU 消息格式，可用于格式化变量。

import { msg, useMessages } from 'gt-react';

const encodedString = msg('购物车中有 {count, plural, =0 {没有商品} =1 {1 件商品} other {{count} 件商品}}', { count: 10 });

export default function TranslateGreeting() {
  const m = useMessages();
  return (
    <p>
      {m(encodedString)}
    </p>
  );
}

ICU 消息格式是用于格式化变量的强大方式。了解更多，请参阅 ICU 消息格式文档。

注意

msg 函数用于标记待翻译的字符串。
使用 msg 的字符串会在运行时之前、于构建阶段完成翻译（开发环境除外）。

下一步

查看 useMessages 了解如何翻译字符串。

概览

msg 函数用于标记并编码字符串，以便进行翻译。

const encodedString = msg('你好，世界！');

应将该编码后的字符串传递给 useMessages 钩子或 getTranslations 函数以获取翻译。

编码： msg 会对输入字符串进行编码，因此你不能直接在 JSX 或其他地方使用它。如果想还原原始字符串，需要使用 decodeMsg 对其进行解码。

解码

要还原原始字符串，你需要使用 decodeMsg 进行解码

import { msg, decodeMsg } from 'gt-react';
const encodedString = msg('你好，世界！');
const decodedString = decodeMsg(encodedString);
console.log(decodedString); // “你好，世界！”

参考资料

参数

名称	类型	描述
`content`	`string`	要进行编码的字符串内容。
`options?`	`InlineTranslationOptions`	自定义 `msg` 行为的翻译选项。

一个编码后的字符串，其中插值的变量（如果有）会被替换为其对应的值。

行为

生产环境

在 CD 流程中，任何位于 msg 函数内的内容都会在应用部署前完成翻译。这可确保所有 locale 的快速加载，但只能翻译构建时已知的内容。

请务必遵循此部署指南。

开发

在开发过程中，msg 函数会按需翻译内容。这有助于进行原型设计，预览应用在不同语言下的呈现效果。请记得在环境中添加 Dev API key 以启用此行为。

在开发环境中进行按需翻译时，你可能会看到一些延迟。在生产构建中不会出现这种情况，除非内容被明确按需翻译，即使用 tx 或 <Tx>。

示例

基本用法

可以使用 msg 标注待翻译的字符串。

import { msg, useMessages } from 'gt-react';

const encodedString = msg('你好,世界!');

export default function TranslateGreeting() {
  const m = useMessages();
  return (
    <p>
      {m(encodedString)}
    </p>
  );
}

注意：“Hello, world!” 将会根据用户的首选语言进行翻译。

使用变量

你可以向字典中的翻译传入变量。

import { msg, useMessages } from 'gt-react';

const encodedString = msg('你好，{name}！', { name: 'Alice' });

export default function TranslateGreeting() {
  const m = useMessages();

  return (
    <p>
      {m(encodedString)}
    </p>
  );
}

Note: "Alice" 不会被翻译成用户的首选语言，因为它是一个变量。

使用 ICU 消息格式

gt-react 支持 ICU 消息格式，可用于格式化变量。

import { msg, useMessages } from 'gt-react';

const encodedString = msg('购物车中有 {count, plural, =0 {没有商品} =1 {1 件商品} other {{count} 件商品}}', { count: 10 });

export default function TranslateGreeting() {
  const m = useMessages();
  return (
    <p>
      {m(encodedString)}
    </p>
  );
}

ICU 消息格式是用于格式化变量的强大方式。了解更多，请参阅 ICU 消息格式文档。

注意

msg 函数用于标记待翻译的字符串。
使用 msg 的字符串会在运行时之前、于构建阶段完成翻译（开发环境除外）。

下一步

查看 useMessages 了解如何翻译字符串。

概览

msg 函数用于标记并编码字符串，以便进行翻译。

const encodedString = msg('你好，世界！');

应将该编码后的字符串传递给 useMessages 钩子或 getTranslations 函数以获取翻译。

编码： msg 会对输入字符串进行编码，因此你不能直接在 JSX 或其他地方使用它。如果想还原原始字符串，需要使用 decodeMsg 对其进行解码。

解码

要还原原始字符串，你需要使用 decodeMsg 进行解码

import { msg, decodeMsg } from 'gt-react';
const encodedString = msg('你好，世界！');
const decodedString = decodeMsg(encodedString);
console.log(decodedString); // “你好，世界！”

参考资料

参数

名称	类型	描述
`content`	`string`	要进行编码的字符串内容。
`options?`	`InlineTranslationOptions`	自定义 `msg` 行为的翻译选项。

一个编码后的字符串，其中插值的变量（如果有）会被替换为其对应的值。

行为

生产环境

在 CD 流程中，任何位于 msg 函数内的内容都会在应用部署前完成翻译。这可确保所有 locale 的快速加载，但只能翻译构建时已知的内容。

请务必遵循此部署指南。

开发

在开发过程中，msg 函数会按需翻译内容。这有助于进行原型设计，预览应用在不同语言下的呈现效果。请记得在环境中添加 Dev API key 以启用此行为。

在开发环境中进行按需翻译时，你可能会看到一些延迟。在生产构建中不会出现这种情况，除非内容被明确按需翻译，即使用 tx 或 <Tx>。

示例

基本用法

可以使用 msg 标注待翻译的字符串。

import { msg, useMessages } from 'gt-react';

const encodedString = msg('你好,世界!');

export default function TranslateGreeting() {
  const m = useMessages();
  return (
    <p>
      {m(encodedString)}
    </p>
  );
}

注意：“Hello, world!” 将会根据用户的首选语言进行翻译。

使用变量

你可以向字典中的翻译传入变量。

import { msg, useMessages } from 'gt-react';

const encodedString = msg('你好，{name}！', { name: 'Alice' });

export default function TranslateGreeting() {
  const m = useMessages();

  return (
    <p>
      {m(encodedString)}
    </p>
  );
}

Note: "Alice" 不会被翻译成用户的首选语言，因为它是一个变量。

使用 ICU 消息格式

gt-react 支持 ICU 消息格式，可用于格式化变量。

import { msg, useMessages } from 'gt-react';

const encodedString = msg('购物车中有 {count, plural, =0 {没有商品} =1 {1 件商品} other {{count} 件商品}}', { count: 10 });

export default function TranslateGreeting() {
  const m = useMessages();
  return (
    <p>
      {m(encodedString)}
    </p>
  );
}

ICU 消息格式是用于格式化变量的强大方式。了解更多，请参阅 ICU 消息格式文档。

注意

msg 函数用于标记待翻译的字符串。
使用 msg 的字符串会在运行时之前、于构建阶段完成翻译（开发环境除外）。

下一步

查看 useMessages 了解如何翻译字符串。

msg

本页目录

msg

本页目录

msg

本页目录

GitHub在 GitHub 上加星标

GitHub在 GitHub 上加星标

在 GitHub 上加星标

在 GitHub 上加星标