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