Autore:
    Aymeric PINEAU
    Creazione:2026-01-21Ultimo aggiornamento:2026-01-21

    Pacchetto intlayer

    Il pacchetto intlayer è la libreria core dell'ecosistema Intlayer. Fornisce le funzioni essenziali, i tipi e le utility per gestire contenuti multilingue in applicazioni JavaScript e TypeScript.

    Installazione

    bash
    npm install intlayer

    Esportazioni

    Configurazione

    Importazione:

    tsx
    import "intlayer";
    VariableTypeDescriptionRelated Doc
    configurationIntlayerConfigL'oggetto di configurazione di Intlayer.getConfiguration
    getConfiguration() => IntlayerConfigRestituisce l'oggetto di configurazione di Intlayer. (Deprecato: usare configuration al suo posto)getConfiguration
    localesLocales[]L'elenco di tutte le localizzazioni supportate.-
    requiredLocalesLocales[]L'elenco di tutte le localizzazioni richieste.-
    defaultLocaleLocalesLa locale predefinita.-

    Tipi

    Importazione:

    tsx
    import "intlayer";
    TipoDescrizione
    DictionaryIl tipo Dictionary utilizzato per definire la struttura di un dizionario.
    DeclarationContent(Deprecato) Usa Dictionary<T> invece.
    IntlayerConfigIl tipo che definisce la configurazione di Intlayer.
    ContentNodeUn nodo nel contenuto del dizionario.
    LocaleIl tipo che rappresenta una locale.
    LocalesValuesI possibili valori per una locale.
    StrictModeLocaleMapUna mappa di locales con controllo rigoroso dei tipi.

    Funzioni di contenuto

    Importazione:

    tsx
    import "intlayer";
    FunzioneTipoDescrizioneDoc correlato
    t / getTranslationFunctionSeleziona il contenuto in base alla locale corrente.traduzione
    enu / getEnumerationFunctionSeleziona il contenuto in base a una quantità.enumerazione
    cond / getConditionFunctionSeleziona il contenuto in base a una condizione booleana.condizione
    genderFunctionSeleziona il contenuto in base al genere.genere
    insertFunctionInserisce valori all'interno di una stringa di contenuto.inserimento
    nest / getNestingFunctionInnestare un altro dizionario.nesting
    mdFunctionElabora contenuto Markdown.markdown
    htmlFunctionElabora contenuto HTML.html
    fileFunctionGestisce il contenuto dei file.file
    getDictionaryFunctionElabora oggetti che assomigliano a dizionari (chiave, contenuto). Elabora traduzioni t(), enumerazioni, ecc.getDictionary
    getDictionaryAsyncFunctionCarica un singolo chunk di locale di un dizionario da una mappa di caricamento per locale, quindi lo elabora.getDictionaryAsync
    getIntlayerFunctionBasato su getDictionary, ma inietta una versione ottimizzata del dizionario proveniente dalla dichiarazione generata.getIntlayer
    getIntlayerAsyncFunctionControparte asincrona di getIntlayer, che carica solo la locale richiesta. Per metadati, loader, funzioni server.getIntlayerAsync

    Utility di localizzazione

    Importazione:

    tsx
    import "intlayer";
    FunzioneTipoDescrizioneDoc correlata
    getLocaleFunctionRileva la locale da una stringa o da un percorso.getLocale
    getLocaleLangFunctionEstrae la parte lingua di una locale.getLocaleLang
    getLocaleNameFunctionRestituisce il nome di visualizzazione di una locale.getLocaleName
    getLocalizedPathFunctionConverte un percorso canonico in un percorso localizzato.getLocalizedPath
    getCanonicalPathFunctionRisolve un percorso localizzato nella forma canonica.getCanonicalPath
    getLocalizedUrlFunctionGenera un URL localizzato.getLocalizedUrl
    getMultilingualUrlsFunctionGenera URL per tutte le locali supportate.getMultilingualUrls
    getPathWithoutLocaleFunctionRimuove il prefisso locale da un percorso.getPathWithoutLocale
    getPrefixFunctionOttiene il prefisso locale da un percorso.getPrefix
    comparePathsFunctionConfronta due percorsi ignorando la lingua (locale).comparePaths
    normalizePathFunctionNormalizza un percorso rendendolo indipendente dalla lingua.comparePaths
    getHTMLTextDirFunctionOttiene la direzione del testo (LTR/RTL).getHTMLTextDir
    validatePrefixFunctionValida un prefisso locale.validatePrefix

    Utility del browser

    Importa:

    tsx
    import "intlayer";
    FunctionTipoDescrizione
    getBrowserLocaleFunctionRileva la locale preferita del browser.
    getCookieFunctionRecupera il valore di un cookie.
    getLocaleFromStorageFunctionRecupera la locale dallo storage.
    setLocaleInStorageFunctionSalva la locale nello storage.

    Formattatori

    Importa:

    tsx
    import "intlayer";
    FunzioneDescrizione
    numberFormatta un numero.
    currencyFormatta un valore in valuta.
    percentageFormatta una percentuale.
    compactFormatta un numero in forma compatta.
    dateFormatta una data.
    relativeTimeFormatta il tempo relativo.
    unitsFormatta un valore con unità.
    IntlL'oggetto Intl standard.
    Ottimizzazione del bundlegetIntlayer