Éditeur de script

L'Éditeur de script dans Studio est l'outil principal de création de scripts sur Roblox. Il s'agit d'un environnement qui s'améliore lui-même et peut vous aider à écrire du code à fort impact, à réduire le temps que vous consacrez au développement et à itérer vos expériences. Il peut améliorer votre expérience de script de la manière suivante :

  • Formatte et met en évidence la syntaxe de votre code.
  • Propose des moyens de compléter automatiquement les phrases de votre code lorsque vous le saisissez.
  • Vous aide à naviguer dans le code an accédant aux déclarations de variable et de fonction.
  • Vous aide à trouver et à remplacer le code dans les scripts ouverts ou tous les scripts.
  • Vous donne des commentaires et retours en temps réel sur la qualité et la performance de votre code.

L'Éditeur de script prend en charge tous les types de scripts. Il s'ouvre automatiquement lorsque vous créez un nouveau script ou double-cliquez sur un script existant dans la fenêtre Explorateur.

Saisie automatique

L'Éditeur de script génère des informations sur le code qui peuvent améliorer l'efficacité de votre programmation.

  • La saisie semi-automatique offre des suggestions sur la façon de compléter les phrases au fur et à mesure que vous les tapez. Utilisez les touches de direction haut et bas pour parcourir les suggestions, puis appuyez sur Tab ou Entrée pour accepter une suggestion et insérer l'intégralité de la phrase.

    Remplissage automatique montrant des suggestions basées sur ce que l'utilisateur a tapé
  • La saisie automatique est liée au modèle de données de l'expérience. Si un Part dans Workspace est appelé CoolRocketShip, alors la saisie automatique suggère CoolRocketShip lorsque vous saisissez workspace.cool et indique qu'il s'agit d'un Part.

    Compléter automatiquement les suggestions en fonction du modèle de données de l'expérience
  • La saisie automatique propose également des noms pour les variables et les fonctions que vous déclarez, ce qui vous aidera à éviter les fautes de frappe et à réutiliser un code.

    Auto-complétion affichant les suggestions basées sur une variable précédemment déclarée
  • La fenêtre contextuelle de saisie automatique propose des échantillons de documentation et de code similaires à ceux de la Référence API du moteur et vous fournit du contenu sur l'utilisation d'une API.

    Auto-complétion affichant les suggestions basées sur une API de moteur Roblox
  • Lorsque vous saisissez un argument dans une fonction, la fenêtre contextuelle de saisie automatique affiche également la signature de la fonction qui vous fournit une référence pour ses paramètres et ses valeurs de renvoi.

    Autocomplétion affichant la signature de la fonction

Aller à la déclaration

Vous pouvez aller directement à la déclaration d'une fonction ou d'une variable en cliquant droit sur son appel, puis en cliquant sur Aller à la déclaration. Vous pouvez également accéder à une déclaration en maintenant enfoncée la touche Ctrl sous Windows, ou sous macOS, lorsque vous cliquez sur l'appel.

Aller au flux de travail Déclaration sur une fonction déclarée

Filtre de fonction de script

Le Filtre de fonction de script affiche une liste des fonctions déclarées dans un script. Pour l'ouvrir, cliquez droit sur n'importe où dans l'éditeur, puis cliquez sur Filtre de fonction de script. Une fois la liste ouverte, vous pouvez parcourir les signatures de chaque fonction, les filtrer par nom et double-cliquer sur l'une d'elle pour accéder à sa déclaration.

L'Éditeur de script intègre plusieurs méthodes pour naviguer dans vos déclarations de variable et de fonction.

Rechercher et remplacer

Le widget Rechercher et remplacer vous permet de rechercher et remplacer un code dans un script ouvert. Le widget prend en charge les correspondances de casse, de mot entier et d'expressions régulières. Pour ouvrir le widget Rechercher et remplacer, appuyez sur Ctrl+F sous Windows ou +F sous macOS.

Trouver/Remplacer le widget étiqueté

Commentaires et retours en temps réel

Analyse du script

La fenêtre Analyse de script, accessible à partir de l'onglet Voir, procède à une analyse statique sur vos scripts et affiche les erreurs et avertissements actifs. Pour plus d'informations sur les erreurs et les avertissements, voir la documentation de Luau Lang.

Script avec diverses erreurs marquées
Erreurs de script soulignées dans l'éditeur de scripts
Fenêtre d'analyse de script avec des détails sur les erreurs marquées du script
Erreurs expliquées dans la fenêtre d'analyse de script

Fenêtre de sortie

La fenêtre Sortie, accessible à partir de l'onglet Voir, affiche les erreurs capturées dans les scripts en cours d'exécution, les messages du moteur Roblox, les messages des appels à print(), et les erreurs des appels à warn(). Pour plus de détails sur sa configuration en fonction de votre flux de travail, voir Fenêtre de sortie.

Aide au code

Aide au code est un assistant IA qui suggère des lignes ou des fonctions de code à mesure que vous écrivez pour vous aider à coder plus efficacement et à rester focalisé. En fonction des contextes de votre commentaire et de votre code, les suggestions seront déclenchées des deux façons suivantes :

  • Automatiquement lorsque vous vous arrêtez sur une ligne et que le modèle IA dispose de suffisamment de contenu pour faire une suggestion.
  • Manuellement avec le raccourci Alt sous Windows, ou sous MacOS (ce raccourci est personnalisable).

Appuyez sur Tab pour accepter une suggestion. Pour l'ignorer, poursuivez la saisie. Actuellement, il faut que votre script comporte un minimum de quelques lignes de code pour déclencher une suggestion.

Améliorer les suggestions

Pour obtenir des suggestions plus précises et plus pertinentes, il est recommandé de suivre des pratiques de codage saines, sans tenir compte de l'assistance de l'IA. Il est également recommandé de suivre ce qui suit :

  • Décomposez votre code en fonctions plus petites.
  • Utilisez des noms de script descriptifs qui reflètent l'intention globale de l'action de chaque script. Par exemple, désignez votre script SonsPersoSync, plutôt que d'utiliser tout simplement Sons.
  • Attribuez des noms descriptifs aux paramètres, aux fonctions et aux scripts. Par exemple, nommez un élément GreenSphere au lieu d'un simple grs, ou nommez une fonction generateSphere() au lieu de gen(). Le fait d'utiliser des fonctions nommées, et non pas des fonctions anonymes, peut également vous permettre d'obtenir de meilleures suggestions.
  • Incluez systématiquement des commentaires correctement rédigés pour décrire la tâche que vous mettez en œuvre et ce que les entrées/sorties doivent être.
    • Envisagez d'inclure quelques exemples d'appels avec les résultats attendus dans les commentaires.
    • Suggérez une méthode pour résoudre un problème, par exemple-- Use raycast .
    • Utilisez la fonction exacte ou le nom de la variable que vous avez défini, par exemple -- Create 10 greenSphere objects au lieu de -- Create 10 spheres.
  • Si vous êtes un scripteur débutant, commencez par des projets de base comme « faire sauter le joueur lorsqu'il touche la pièce » ou utilisez l'outil pour générer de petits extraits de code que vous pourrez développer à mesure que vous en apprendrez plus.

Limitations

L'outil permet d'automatiser les tâches de codage de base, mais le code qu'il suggère n'est pas toujours parfait. Les limitations actuelles sont notamment les suivantes :

  • Le déclenchement manuel n'engendre pas toujours la génération d'une suggestion.
  • Les suggestions sont apprises par machine à partir d'un corpus de code. Il se peut qu'elles présentent certaines des limitations du code sur lequel elles sont formées. Par exemple, il se peut que les suggestions n'utilisent les API les plus récentes en faveur des API plus anciennes ou qu'elle utilisent Lua au lieu de Luau.
  • L'outil peut générer des informations erronées ou trompeuses qui ne seront pas utiles pour atteindre votre objectif.
  • Les filtres internes tentent de bloquer le langage offensant, mais ils ne sont pas exhaustifs. Il est possible que l'outil génère des informations offensantes ou biaisées.
  • Les suggestions peuvent être les mêmes, similaires ou différentes d'un utilisateur à un autre, même avec les mêmes invites. Votre code, cependant, ne sera jamais partagé avec d'autres personnes.
  • Il se peut que la suggestion soit incomplète en raison de la longueur limitée de sortie des modèles d'apprentissage.
  • Le nombre de suggestions est plafonné quotidiennement. Une fois le plafond atteint, vous ne recevrez aucune suggestion jusqu'au lendemain.

Confidentialité du code

Actuellement, Roblox n'utilise aucune donnée non publique pour former les modèles d'apprentissage. L'outil utilise uniquement un petit sous-ensemble d'actifs de marketplace libre pour affiner les modèles de langue volumineuse. Le sous-ensemble a fait l'objet de diverses vérifications sur la qualité et les filtres de sécurité.

En outre, toutes les suggestions sont générées par le modèle IA. Elles ne sont pas transférées d'un utilisateur à un autre. Étant donné que votre code n'est pas utilisé pour la formation des modèles, il ne sera pas suggéré aux autres utilisateurs de Code Assist, à l'exception du code affiché sur les objets gratuits du marketplace.

Multi-curseur

L'Éditeur de script prend en charge l'utilisation de plusieurs curseurs afin de pouvoir faire des modifications simultanées. Vous pouvez ajouter des curseurs en fonction de vos besoins, à l'aide d'un clic ou d'un raccourci clavier. Le curseur initial se nomme le curseur principal. Les curseurs supplémentaires sont appelés curseurs auxiliaires.

  • Les modifications apportées au niveau du curseur principal sont copiées sur les curseurs auxiliaires. Chaque modification compte pour une action, de sorte que l'annulation/le rétablissement d'une modification s'applique à tous les curseurs.
  • Les widgets, comme la saisie automatique, apparaissent sur le curseur principal, mais pas sur les curseurs auxiliaires.
  • Les raccourcis clavier standard pour la modification dans l'Éditeur de script (l'indentation du code, l'activation des commentaires, la suppression de lignes, etc.) fonctionnent tous avec la modification multi-curseurs.

Le tableau suivant résume les flux de travail multi-curseurs et leurs raccourcis.

CommandeWindowsmacOS
Ajouter/supprimer le curseur à l'emplacement de la sourisAlt + cliquer + cliquer
Supprimer le curseur le plus récemment ajoutéCtrl + +[
Ajouter/Modifier le curseur lors du glissement de la sourisAjouter un curseur au-dessus du curseur principalZoom arrière
Ajouter un curseur ci-dessus/ci-dessousCtrl + Alt + + +
Ajouter un curseur à la prochaine sélection correspondanteCtrl + D + D
Pour ajouter un curseur à toutes les sélections correspondantes :Maj + Alt + LAnnuler l'indentation
Sélection de colonne/blocL'occurrence précédente est sélectionnée et intègre un curseur supplémentaire.Ajouter des curseurs à la fin des lignes sélectionnées et à la fin de sélection
Diviser les sélections en lignesAlt + SOption+ + Haut/Bas

Ajouter des curseurs

Vous pouvez ajouter des curseurs avec une combinaison de raccourcis clavier et de manœuvres de la souris. Les curseurs fusionnent s'ils occupent le même espace, par exemple lorsque vous ajoutez des curseurs avec des touches de direction ou supprimez tous les caractères entre les curseurs.

À l'emplacement de la souris

Pour ajouter un curseur à votre souris :

  1. Appuyez et maintenez la touche Alt sous Windows ou sous macOS.
  2. Cliquez sur l'Éditeur de script où vous souhaitez ajouter le curseur.

Avec un glissement de souris

Vous pouvez faire glisser la souris pour ajouter un curseur à une sélection, séparer une sélection à plusieurs lignes en lignes, ou sélectionner des colonnes et des blocs de code/espace.

Sélectionnez les lignes de code.

Pour ajouter un curseur à une sélection de texte :

  1. Appuyez et maintenez enfoncée la touche Alt sous Windows ou sous macOS.
  2. Cliquez et faites glisser votre souris sur la sélection de texte.
Aux extrémités de ligne sélectionnées et à la fin de sélection

Pour ajouter des curseurs à la fin de chaque ligne d'une sélection à lignes multiples et à la fin de la sélection :

Sélection de colonne/bloc

Pour sélectionner des colonnes et des blocs de code ou des espaces, faites glisser la souris tout en maintenant la toucheMajAlt sous Windows ou Maj sous macOS. Au fur et à mesure que vous faites glisser, un curseur sera ajouté sur chaque ligne surlignée.

Au-dessus et en-dessous du curseur principal

Pour ajouter un curseur directement au-dessus ou en-dessous du curseur principal :

  1. Appuyez et maintenez la touche Ctrl + Alt sous Windows ou + sous macOS.
  2. Appuyez sur les flèches haut et bas.

À toutes les sélections correspondantes

Vous pouvez ajouter des curseurs à toutes les correspondances d'une sélection ou à la correspondance suivante/précédente, et optionnellement basculer si les correspondances sont sensibles à la casse et/ou correspondent à l'ensemble du mot.

Réduire tous les volets

Pour ajouter un curseur à la sélection correspondante suivante :

  1. Sélectionnez le code pour lequel vous souhaitez trouver des correspondances.
  2. Appuyez sur Maj + Alt + L sous Windows ou Maj + + L sous macOS.
Correspondance suivante/précédente

Pour ajouter un curseur à la sélection correspondante suivante :

  1. Sélectionnez le code pour lequel vous souhaitez trouver des correspondances.
  2. Appuyez sur Ctrl + D sous Windows ou + D sous macOS.
  3. Appuyez sur Ctrl/ + D jusqu'à sélectionner toutes les correspondances suivantes que vous souhaitez.

Il n'y a pas de raccourci par défaut pour ajouter un curseur à la sélection précédente mais vous pouvez ajouter le vôtre :

  1. L'Éditeur de script peut vous aider à maîtriser Luau plus rapidement en proposant des retours et commentaires en temps réel sur les fenêtres Analyse de script et Sortie.

  2. Pour cela, ouvrez la fenêtre Personnaliser les raccourcis dans Fichiers> Avancé > Personnaliser les raccourcis et modifiez le raccourci pour « Sélectionner l'occurrence précédente ».

  3. À la prochaine sélection correspondante

  4. Confirmez votre paramètre en cliquant sur OK dans le coin inférieur droit de la fenêtre.

Cas ou mot entier correspondant

Pour chacun des flux de travail liés à la correspondance ci-dessus, vous pouvez faire correspondre cas et/ou mot entier comme suit :

  1. Ouvrez la Fenêtre d'ouverture avec Ctrl + P sous Windows ou + P sous macOS.

  2. Utilisez les boutons de bascule pour choisir si une sélection correspondante doit être sensible à la casse et/ou correspondre à l'ensemble du mot seulement.

Supprimer des curseurs

Vous pouvez supprimer des curseurs avec une combinaison de raccourcis clavier et de manœuvres de la souris. Pour supprimer tous les curseurs auxiliaires et quitter la modification multi-curseurs, appuyez sur Échap ou cliquez n'importe où dans l'Éditeur de script.

À l'emplacement de la souris

Pour supprimer un curseur :

  1. Appuyez et maintenez enfoncée la touche Alt sous Windows ou sous macOS.
  2. Cliquez sur le curseur que vous souhaitez supprimer.

Le plus récemment ajouté

Pour supprimer le curseur le plus récemment ajouté, appuyez sur Ctrl + U sous Windows ou + U sous macOS.

Copier et coller des curseurs

La copie d'une sélection de texte comporte les curseurs qui s'y trouvent. Le comportement du collage dépend du nombre de curseurs au niveau de la source et du nombre de curseurs au niveau de la destination :

  • Si le nombre de curseurs est le même, chaque curseur copié est collé sur chaque curseur de destination correspondant.
  • Si le nombre de curseurs est différent, chaque curseur de la destination reçoit l'intégralité du collage et chaque curseur est copié sous forme d'une nouvelle ligne.

Indentation

En appuyant sur Entrée/Retour, chaque curseur sur la nouvelle ligne sera automatiquement en retrait par rapport à la ligne précédente. Si la ligne précédente commence par un bloc incomplet, le formateur essaiera de le compléter.

Raccourcis clavier

L'Éditeur de script dispose des raccourcis clavier suivants. Vous pouvez également accéder à de nombreuses commandes depuis l’onglet Script qui apparaît dans la barre d’outils du Studio à chaque fois que vous visualisez ou éditez un script.

CommandeWindowsmacOS
Fermer le scriptCtrl + W + W
Rouvrir le dernier script ferméCtrl + Maj + T + Maj + T
Ouverture rapideCtrl + P + P
Montrer le script dans ExplorateurCtrl + Alt + K + Maj + K
Zoom avantCouper= +=
Zoom arrièreDocumentation- +-
Réinitialiser le zoom du scriptCtrl + 0 + 0