Enums de chaînes comme unions
Fait partie de la section Introduction à Luau du Journey Lua de Coddy — leçon 53 sur 73.
Les nombres créent des journaux cryptiques : voir 2 ne vous apprend pas grand-chose, voir "down" vous dit tout. Pour des enums lisibles, les types union de littéraux de Luau sont l'outil idéal — un type dont les membres sont des chaînes exactes :
type Direction = "up" | "down" | "left" | "right"
local facing: Direction = "up" -- ✓
local typo: Direction = "upp" -- ✗ erreur de type lors de l'éditionUne variable typée avec Direction peut contenir ces quatre chaînes et rien d'autre. Faites une faute de frappe et le vérificateur la détecte instantanément — le bug n'atteint jamais le joueur.
À l'exécution, les valeurs sont de simples chaînes. Affichez-les avec print, concaténez-les, comparez-les avec == — tout ce que vous savez sur les chaînes s'applique :
print(facing) -- haut
print(`facing {facing}`) -- face vers le hautComparez les deux modèles que vous avez maintenant : la table de constantes crée une valeur à l'exécution (UserRole) contenant des membres, tandis que l'union de littéraux ne crée aucune valeur — il n'y a pas de table Direction, seulement une règle que le vérificateur applique sur les chaînes autorisées. Des valeurs descriptives et auto-documentées sans aucun coût à l'exécution font des unions de littéraux le style d'enum privilégié dans le code Luau.
Défi
FacileCréez un type union de littéraux nommé Direction avec les membres "up", "down", "left" et "right".
Créez quatre variables, chacune annotée avec Direction :
upDirection="up"downDirection="down"leftDirection="left"rightDirection="right"
Affichez, chacun sur sa propre ligne :
upDirectiondownDirectionleftDirectionrightDirection- le message
The player moves left, construit avec une interpolation de chaîne à partir deleftDirection
Essayez vous-même
-- Écrivez le code ici
-- 1) définir le type Direction comme une union des quatre littéraux de chaîne
-- 2) créer les quatre variables annotées
-- 3) afficher chacune, puis le message interpolé
Testez-vousCette leçon comprend un petit quiz. Commencez la leçon pour y répondre et suivre votre progression.
Toutes les leçons de Introduction à Luau
1Premiers pas avec Luau
Qu'est-ce que Luau ?Pourquoi utiliser Luau ?Votre premier code LuauVérification de type et modes d'erreurRécapitulatif : Introduction à Luau4Travailler avec les fonctions
Typage des paramètres et valeurs de retourTypage des fonctions anonymesFonctions ne retournant rienParamètres optionnelsValeurs par défaut des paramètresFonctions variadiquesDéfinition des types de fonctionsRécapitulatif : Fonctions typées
2Types fondamentaux
Types de base : num, str, boolLe type 'any' : la porte de sortieLe type 'unknown'Types Nil et optionnelsL'inférence de type en actionAnnotations explicites de typeRécapitulatif : Pratique des types fondamentaux5Alias, unions et intersections
Alias de types pour les types primitifsTypes unionsTravailler avec les types unionsTypes littérauxTypes intersectionsCombinaison d'alias de typesRécapitulatif : Combinaisons de types avancées8Les Enums, à la manière de Luau
Le pattern Enum dans LuauEnums numériques avec des tablesEnums de chaînes comme unionsUtiliser des Enums d'unions littéralesGeler les tables de constantesRécapitulatif : Les Enums, à la manière de Luau3Tables typées : Tableaux et Maps
Tableaux typésAjout et lecture d'élémentsQu'est-ce qu'un type Map ?Déclaration et accès aux MapsItération sur les tablesTables à formes mixtesTableaux typés multidimensionnelstable.unpack et VarargsRécapitulatif : Tableaux et Maps