嵌套 / 子内容引用
如何实现嵌套
在 Intlayer 中,嵌套是通过 nest 函数实现的,该函数允许您引用并重用来自另一个字典的内容。与其重复内容,不如通过其键指向现有的内容模块。
设置嵌套
要在 Intlayer 项目中设置嵌套,首先需要定义您希望重用的基础内容。然后,在一个单独的内容模块中,使用 nest 函数来导入该内容。
基础字典
以下是一个包含嵌套内容的基础字典示例:
firstDictionary.content.ts
import { type Dictionary } from "intlayer";const firstDictionary = { key: "key_of_my_first_dictionary", content: { content: "content", subContent: { contentNumber: 0, contentString: "string", }, },} satisfies Dictionary;export default firstDictionary;
使用 Nest 引用
现在,创建另一个内容模块,使用 nest 函数来引用上面的内容。您可以引用整个内容或特定的嵌套值:
secondDictionary.content.ts
import { nest, type Dictionary } from "intlayer";const myNestingContent = { key: "key_of_my_second_dictionary", content: { // 引用整个字典: fullNestedContent: nest("key_of_my_first_dictionary"), // 引用特定嵌套值: partialNestedContent: nest( "key_of_my_first_dictionary", "subContent.contentNumber" ), },} satisfies Dictionary;export default myNestingContent;
作为参数的第二部分,您可以指定该内容中一个嵌套值的路径。如果未提供路径,则返回引用字典的整个内容。
在 React Intlayer 中使用嵌套
在 React 组件中使用嵌套内容时,可以利用 react-intlayer 包中的 useIntlayer hook。此 hook 根据指定的键检索正确的内容。以下是一个使用它的示例:
**/*.tsx
import type { FC } from "react";import { useIntlayer } from "react-intlayer";const NestComponent: FC = () => { const { fullNestedContent, partialNestedContent } = useIntlayer( "key_of_my_second_dictionary" ); return ( <div> <p> 完整嵌套内容: {JSON.stringify(fullNestedContent)} {/* 输出: {"content": "content", "subContent": {"contentNumber": 0, "contentString": "string"}} */} </p> <p> 部分嵌套值: {partialNestedContent} {/* 输出: 0 */} </p> </div> );};export default NestComponent;
其他资源
有关配置和使用的更多详细信息,请参考以下资源:
这些资源提供了在不同环境和各种框架中设置和使用 Intlayer 的更多见解。
如果您有改善此文档的想法,请随时通过在GitHub上提交拉取请求来贡献。
文档的 GitHub 链接