Criação:2026-01-21Última atualização:2026-01-21

    Pacote intlayer

    O pacote intlayer é a biblioteca core do ecossistema Intlayer. Ele fornece as funções essenciais, tipos e utilitários para gerenciar conteúdo multilíngue em aplicações JavaScript e TypeScript.

    Instalação

    npm install intlayer
    yarn add intlayer
    pnpm add intlayer
    bun add intlayer

    Exportações

    Configuração

    Importação:

    import "intlayer";
    Variável Tipo Descrição Documento Relacionado
    configuration IntlayerConfig O objeto de configuração do Intlayer. getConfiguration
    getConfiguration () => IntlayerConfig Retorna o objeto de configuração do Intlayer. (Obsoleto: Use configuration em vez disso) getConfiguration
    locales Locales[] A lista de todos os locales suportados. -
    requiredLocales Locales[] A lista de todos os locales obrigatórios. -
    defaultLocale Locales O locale padrão. -

    Tipos

    Importação:

    import "intlayer";
    Tipo Descrição
    Dictionary O tipo Dictionary usado para definir a estrutura de um dicionário.
    DeclarationContent (Depreciado) Use Dictionary<T> em vez disso.
    IntlayerConfig O tipo que define a configuração do Intlayer.
    ContentNode Um nó no conteúdo do dicionário.
    Locale O tipo que representa um locale.
    LocalesValues Os valores possíveis para um locale.
    StrictModeLocaleMap Um mapa de locales com verificação de tipos estrita.

    Funções de Conteúdo

    Importação:

    import "intlayer";
    Função Tipo Descrição Doc Relacionado
    t / getTranslation Function Seleciona conteúdo com base na localidade atual. tradução
    enu / getEnumeration Function Seleciona conteúdo com base na quantidade. enumeração
    cond / getCondition Function Seleciona conteúdo com base numa condição booleana. condition
    gender Function Seleciona conteúdo com base no género. gender
    insert Function Insere valores numa string de conteúdo. insertion
    nest / getNesting Function Aninha outro dicionário. aninhamento
    md Function Processa conteúdo em Markdown. markdown
    html Function Processa conteúdo HTML. html
    file Function Trata o conteúdo do ficheiro. file
    getDictionary Function Processa objetos que se parecem com dicionários (key, content). Processa traduções t(), enumerações, etc. -
    getIntlayer Function Baseado em getDictionary, mas injeta uma versão otimizada do dicionário a partir da declaração gerada. -

    Utilitários de Localização

    Importação:

    import "intlayer";
    Função Tipo Descrição Documento Relacionado
    getLocale Function Detecta a locale a partir de uma string ou path. getLocale
    getLocaleLang Function Obtém a parte de idioma de uma locale. getLocaleLang
    getLocaleName Function Obtém o nome de exibição de uma locale. getLocaleName
    getLocalizedPath Function Resolve um caminho canônico para a versão localizada. getLocalizedPath
    getCanonicalPath Function Resolve um caminho localizado para sua forma canônica. getCanonicalPath
    getLocalizedUrl Function Gera uma URL localizada. getLocalizedUrl
    getMultilingualUrls Function Gera URLs para todos os locales suportados. getMultilingualUrls
    getPathWithoutLocale Function Remove o prefixo de locale de um caminho. getPathWithoutLocale
    getPrefix Function Obtém o prefixo de locale de um caminho. getPrefix
    getHTMLTextDir Function Obtém a direção do texto (LTR/RTL). getHTMLTextDir
    validatePrefix Function Valida um prefixo de locale. validatePrefix

    Utilitários do Navegador

    Importação:

    import "intlayer";
    Função Tipo Descrição
    getBrowserLocale Function Detecta o locale preferido do navegador.
    getCookie Function Recupera o valor de um cookie.
    getLocaleFromStorage Function Recupera o locale do armazenamento.
    setLocaleInStorage Function Salva o locale no armazenamento.

    Formatadores

    Importação:

    import "intlayer";
    Function Description
    number Formata um número.
    currency Formata um valor monetário.
    percentage Formata uma percentagem.
    compact Formata um número em formato compacto.
    date Formata uma data.
    relativeTime Formata tempo relativo.
    units Formata um valor com unidades.
    Intl O objeto Intl padrão.