作者:

Creation:2026-06-12Last update:2026-06-12

将此文档参考到您的 AI 助手ChatGPT Claude DeepSeek Google AI mode Gemini Perplexity Mistral Grok

使用您最喜欢的AI助手总结文档，并引用此页面和AI提供商

版本历史

"发布动态内容功能"
v9.0.02026/6/12

此页面的内容已使用 AI 翻译。

查看英文原文的最新版本

编辑此文档

如果您有改善此文档的想法，请随时通过在GitHub上提交拉取请求来贡献。

文档的 GitHub 链接

Copy

复制文档 Markdown 到剪贴板

动态记录

Name: Intlayer
Author: Intlayer

动态记录（dynamic record）是指其唯一身份标识不是顺序索引或命名变体，而是在 meta 字段中声明的任意键值对集合的内容文件。Intlayer 将在运行时使用这些字段作为选择器，从而可以定位 CMS 记录、用户特定文案或任何在构建时未知其键的内容。

声明动态记录

product-copy.abc.content.ts

复制代码

复制代码到剪贴板

import { t, type Dictionary } from "intlayer";

const dictionary = {
  key: "product-copy",
  meta: {
    id: "prod_abc",
    userId: "user_123",
  },
  content: {
    name: t({ en: "Widget Pro", fr: "Widget Pro" }),
    description: t({ en: "The best widget.", fr: "Le meilleur widget." }),
  },
} satisfies Dictionary;

export default dictionary;

product-copy.abcd.content.ts

复制代码

复制代码到剪贴板

import { t, type Dictionary } from "intlayer";

const dictionary = {
  key: "product-copy",
  meta: {
    id: "prod_abcd",
    userId: "user_123",
  },
  content: {
    name: t({ en: "Widget Lite", fr: "Widget Lite" }),
    description: t({ en: "A lighter option.", fr: "Une option plus légère." }),
  },
} satisfies Dictionary;

export default dictionary;

使用动态记录

选择器中所有的 meta 字段都是必填的。省略任何字段都将返回 null 并导致 TypeScript 报错。

ProductCopy.tsx

复制代码

复制代码到剪贴板

import { useIntlayer } from "react-intlayer";

export const ProductCopy = ({
  productId,
  userId,
}: {
  productId: string;
  userId: string;
}) => {
  const content = useIntlayer("product-copy", { id: productId, userId });
  // TypeScript 会强制要求同时提供 `id` 和 `userId`。

  if (!content) return null;

  return <p>{content.description}</p>;
};

ProductCopy.tsx

复制代码

复制代码到剪贴板

import { useIntlayer } from "next-intlayer";

export const ProductCopy = ({
  productId,
  userId,
}: {
  productId: string;
  userId: string;
}) => {
  const content = useIntlayer("product-copy", { id: productId, userId });
  // TypeScript 会强制要求同时提供 `id` 和 `userId`。

  if (!content) return null;

  return <p>{content.description}</p>;
};

ProductCopy.vue

复制代码

复制代码到剪贴板

<script setup>
import { useIntlayer } from "vue-intlayer";

const props = defineProps({
  productId: String,
  userId: String,
});

const content = useIntlayer("product-copy", { id: props.productId, userId: props.userId });
</script>

<template>
  <p v-if="content">{{ content.description }}</p>
</template>

ProductCopy.svelte

复制代码

复制代码到剪贴板

<script lang="ts">
import { useIntlayer } from "svelte-intlayer";

export let productId: string;
export let userId: string;

const content = useIntlayer("product-copy", { id: productId, userId });
</script>

{#if $content}
  <p>{$content.description}</p>
{/if}

ProductCopy.tsx

复制代码

复制代码到剪贴板

import { useIntlayer } from "preact-intlayer";

export const ProductCopy = ({
  productId,
  userId,
}: {
  productId: string;
  userId: string;
}) => {
  const content = useIntlayer("product-copy", { id: productId, userId });
  // TypeScript 会强制要求同时提供 `id` 和 `userId`。

  if (!content) return null;

  return <p>{content.description}</p>;
};

ProductCopy.tsx

复制代码

复制代码到剪贴板

import { useIntlayer } from "solid-intlayer";

export const ProductCopy = (props: {
  productId: string;
  userId: string;
}) => {
  const content = useIntlayer("product-copy", { id: props.productId, userId: props.userId });
  // TypeScript 会强制要求同时提供 `id` 和 `userId`。

  return (
    <>
      {content() && <p>{content().description}</p>}
    </>
  );
};

product-copy.component.ts

复制代码

复制代码到剪贴板

import { Component, Input, OnInit } from "@angular/core";
import { useIntlayer } from "angular-intlayer";

@Component({
  selector: "app-product-copy",
  template: `
    @if (content()) {
      <p>{{ content().description }}</p>
    }
  `,
})
export class ProductCopyComponent implements OnInit {
  @Input() productId!: string;
  @Input() userId!: string;

  content: any;

  ngOnInit() {
    this.content = useIntlayer("product-copy", { id: this.productId, userId: this.userId });
  }
}

product-copy.js

复制代码

复制代码到剪贴板

import { useIntlayer } from "vanilla-intlayer";const content = useIntlayer("product-copy", {  id: "prod_abcd",  userId: "user_123"});if (content) {  document.body.innerHTML = `<p>${content.description}</p>`;}

使用显式语言环境

tsx

复制代码

复制代码到剪贴板

const content = useIntlayer("product-copy", {  id: "prod_abc",  userId: "user_123",  locale: "zh",});

缺少 meta 字段 — 编译时错误

复制代码

复制代码到剪贴板

// 类型错误：缺少 `userId`const content = useIntlayer("product-copy", { id: "prod_abc" });

加载模式 (loading mode)

动态记录通常采用延迟加载方式。在字典中设置 importMode 来控制此行为：

复制代码

复制代码到剪贴板

const dictionary = {
  key: "product-copy",
  importMode: "fetch", // 或 "dynamic"
  meta: { id: "prod_abc", userId: "user_123" },
  content: { … },
} satisfies Dictionary;

export default dictionary;

关于 static、dynamic 和 fetch 模式的详细信息，请参阅分包优化。

典型使用场景

在 CMS 中管理的单件商品营销文案
用户特定或账户特定的内容
在运行时通过不透明 ID 标识的任何内容

变体每个语言环境的文件