Documentazione: getEnumerationContent Funzione in intlayer

    Descrizione:

    La funzione getEnumerationContent recupera contenuto corrispondente a una specifica quantità in base a condizioni predefinite in un oggetto di enumerazione. Le condizioni sono definite come chiavi e la loro priorità è determinata dal loro ordine nell'oggetto.

    Parametri:

    • enumerationContent: QuantityContent<Content>

      • Descrizione: Un oggetto dove le chiavi rappresentano condizioni (ad es., <=, <, >=, =) e i valori rappresentano il contenuto corrispondente. L'ordine delle chiavi definisce la loro priorità di corrispondenza.
      • Tipo: QuantityContent<Content>
        • Content può essere di qualsiasi tipo.
    • quantity: number

      • Descrizione: Il valore numerico utilizzato per confrontare le condizioni in enumerationContent.
      • Tipo: number

    Restituisce:

    • Tipo: Content
    • Descrizione: Il contenuto corrispondente alla prima condizione corrispondente in enumerationContent. Se non viene trovata alcuna corrispondenza, si applicano le modalità di gestione predefinite (ad es., errore o contenuto di fallback).

    Esempio di Utilizzo:

    Utilizzo di Base:

    typescript
    import { getEnumerationContent } from "intlayer";const content = getEnumerationContent(  {    "<=-2.3": "Hai meno di -2.3",    "<1": "Hai meno di uno",    "2": "Hai due",    ">=3": "Hai tre o più",  },  2);console.log(content); // Output: "Hai due"

    Priorità delle Condizioni:

    typescript
    import { getEnumerationContent } from "intlayer";const content = getEnumerationContent(  {    "<4": "Hai meno di quattro",    "2": "Hai due",  },  2);console.log(content); // Output: "Hai meno di quattro"

    Casi Marginali:

    • Nessuna Condizione Corrispondente:

      • Se nessuna condizione corrisponde alla quantità fornita, la funzione restituirà undefined o gestirà esplicitamente lo scenario predefinito/fallback.
    • Condizioni Ambigue:

      • Se le condizioni si sovrappongono, la prima condizione corrispondente (in base all'ordine dell'oggetto) ha la precedenza.
    • Chiavi Non Valide:

      • La funzione presume che tutte le chiavi in enumerationContent siano valide e formattabili come condizioni. Chiavi non valide o formattate in modo errato possono portare a comportamenti imprevisti.
    • Forzatura di TypeScript:

      • La funzione garantisce che il tipo Content sia coerente tra tutte le chiavi, consentendo la sicurezza dei tipi nel contenuto recuperato.

    Note:

    • L'utility findMatchingCondition è utilizzata per determinare la condizione appropriata in base alla quantità fornita.

    Se hai un’idea per migliorare questa documentazione, non esitare a contribuire inviando una pull request su GitHub.

    Collegamento GitHub alla documentazione