Autor:

Criação:2026-06-12Última atualização:2026-06-12

Referência esta documentação ao seu assistente AI favorito

Google AI mode Gemini

Perplexity Mistral

Faça sua pergunta e obtenha um resumo do documento referenciando esta página e o provedor AI de sua escolha

Histórico de versões

"Lançamento do recurso de variantes de dicionários"
v9.0.012/06/2026

O conteúdo desta página foi traduzido com uma IA.

Veja a última versão do conteúdo original em inglês

Edit this doc

If you have an idea for improving this documentation, please feel free to contribute by submitting a pull request on GitHub.

GitHub link to the documentation

Copy

Copy doc Markdown to clipboard

Variantes

Uma variante (Variant) é um conjunto de arquivos de conteúdo que compartilham a mesma chave de dicionário (key), mas cada um carrega um nome de variante (variant) diferente. O Intlayer serve o arquivo apropriado com base no seletor passado para useIntlayer.

Declarando variantes

Cada arquivo representa uma alternativa nomeada. Omitir variant (ou defini-lo como "default") o marca como a variante padrão (fallback).

hero-banner.content.ts

Copiar código

Copiar o código para a área de transferência

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

const dictionary = {
  key: "hero-banner",
  variant: "default",
  content: {
    headline: t({
      en: "Build faster with Intlayer",
      fr: "Développez plus vite avec Intlayer",
    }),
    cta: t({ en: "Get started", fr: "Commencer" }),
  },
} satisfies Dictionary;

export default dictionary;

hero-banner.black-friday.content.ts

Copiar código

Copiar o código para a área de transferência

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

const dictionary = {
  key: "hero-banner",
  variant: "black_friday",
  content: {
    headline: t({
      en: "50 % off — today only",
      fr: "−50 % — aujourd'hui seulement",
    }),
    cta: t({ en: "Shop now", fr: "Acheter agora" }),
  },
} satisfies Dictionary;

export default dictionary;

Consumindo variantes

Variante padrão

Hero.tsx

Copiar código

Copiar o código para a área de transferência

import { useIntlayer } from "react-intlayer";

export const Hero = () => {
  const { headline, cta } = useIntlayer("hero-banner");
  // → variante padrão

  return (
    <section>
      <h1>{headline}</h1>
      <a>{cta}</a>
    </section>
  );
};

Hero.tsx

Copiar código

Copiar o código para a área de transferência

import { useIntlayer } from "next-intlayer";

export const Hero = () => {
  const { headline, cta } = useIntlayer("hero-banner");
  // → variante padrão

  return (
    <section>
      <h1>{headline}</h1>
      <a>{cta}</a>
    </section>
  );
};

Hero.vue

Copiar código

Copiar o código para a área de transferência

<script setup>
import { useIntlayer } from "vue-intlayer";
const { headline, cta } = useIntlayer("hero-banner");
</script>

<template>
  <section>
    <h1>{{ headline }}</h1>
    <a>{{ cta }}</a>
  </section>
</template>

Hero.svelte

Copiar código

Copiar o código para a área de transferência

<script lang="ts">
import { useIntlayer } from "svelte-intlayer";
const content = useIntlayer("hero-banner");
</script>

<section>
  <h1>{$content.headline}</h1>
  <a>{$content.cta}</a>
</section>

Hero.tsx

Copiar código

Copiar o código para a área de transferência

import { useIntlayer } from "preact-intlayer";

export const Hero = () => {
  const { headline, cta } = useIntlayer("hero-banner");
  // → variante padrão

  return (
    <section>
      <h1>{headline}</h1>
      <a>{cta}</a>
    </section>
  );
};

Hero.tsx

Copiar código

Copiar o código para a área de transferência

import { useIntlayer } from "solid-intlayer";

export const Hero = () => {
  const content = useIntlayer("hero-banner");
  // → variante padrão

  return (
    <section>
      <h1>{content().headline}</h1>
      <a>{content().cta}</a>
    </section>
  );
};

hero.component.ts

Copiar código

Copiar o código para a área de transferência

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

@Component({
  selector: "app-hero",
  template: `
    <section>
      <h1>{{ content().headline }}</h1>
      <a>{{ content().cta }}</a>
    </section>
  `,
})
export class HeroComponent {
  content = useIntlayer("hero-banner");
}

hero.js

Copiar código

Copiar o código para a área de transferência

import { useIntlayer } from "vanilla-intlayer";const { headline, cta } = useIntlayer("hero-banner");document.body.innerHTML = `  <section>    <h1>${headline}</h1>    <a>${cta}</a>  </section>`;

Variante nomeada

tsx

Copiar código

Copiar o código para a área de transferência

const { headline, cta } = useIntlayer("hero-banner", {  variant: "black_friday",});

Variante nomeada com localidade explícita

tsx

Copiar código

Copiar o código para a área de transferência

const content = useIntlayer("hero-banner", {  variant: "black_friday",  locale: "pt",});

Casos de uso típicos

Testes A/B de textos controlados por uma chave de experimento
Banners promocionais ou sazonais
Mensagens baseadas em sinalizadores de recursos (feature flags)
Campanhas de marketing específicas de uma região

Registros dinâmicos