Tween
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
L'objet Tween contrôle la lecture d'une interpolation. La création et la configuration d'une Tween est faite avec la fonction TweenService:Create() ; 2>Datatype.Instance.new()2> ne peut pas être utilisé pour cet objet spécifique.
Remarquez que bien que la configuration d'un tween puisse être modifiée après la création d'un tween, il ne peut pas être modifié. Si de nouveaux objectifs sont nécessaires pour une interpolation, un nouveau Tween doit être créé.
Notez également que plusieurs tweens peuvent être joués sur le même objet en même temps, mais ils ne doivent pas interpoler la même propriété. Si deux tweens tentent de modifier la même propriété, le tween initial sera annulé et écrasé par le tween le plus récent.
Échantillons de code
local TweenService = game:GetService("TweenService")
local part = Instance.new("Part")
part.Position = Vector3.new(0, 10, 0)
part.Color = Color3.new(1, 0, 0)
part.Anchored = true
part.Parent = game.Workspace
local goal = {}
goal.Position = Vector3.new(10, 10, 0)
goal.Color = Color3.new(0, 1, 0)
local tweenInfo = TweenInfo.new(5)
local tween = TweenService:Create(part, tweenInfo, goal)
tween:Play()Résumé
Propriétés
Propriété de lecture qui pointe sur la Instance dont les propriétés sont interpolées par le tween.
Propriété de lecture qui inclut des informations sur la façon dont l'interpolation du Tween est à effectuer.
Propriété de lecture qui montre l'état actuel pour l'animationsTween.
Méthodes
Méthodes hérités de TweenBaseArrête la lecture et réinitialise les variables de tween. Si vous appelez ensuite TweenBase:Play(), les propriétés de la tween interpolent vers leur destination, mais prenez la longueur complète de l'animation pour le faire.
Arrête la lecture du tween. Ne réinitialise pas ses variables de progression, ce qui signifie que si vous appelez TweenBase:Play(), le tween reprend la lecture à partir du moment qu'il a été interrompue.
Démarre la lecture d'une tween. Notez que si la lecture a déjà commencé, en appelant Play() n'a aucun effet à moins que la tween n'ait fini ou soit arrêté (par TweenBase:Cancel() ou TweenBase:Pause()).
Évènements
Évènements hérités de TweenBaseSe déclenche lorsque la fin de la balise tween est terminée ou lorsque vous l'arrêtez avec TweenBase:Cancel().
Propriétés
Instance
La propriété Instance d'un Tween (points de lecture uniquement) pointe vers la Instance dont les propriétés sont en cours d'interprétation.
Échantillons de code
local TweenService = game:GetService("TweenService")
local function isInstanceAPart(tween)
local instance = tween.Instance
return instance:IsA("BasePart")
end
local tweenInfo = TweenInfo.new()
local instance = Instance.new("Part")
local tween = TweenService:Create(instance, tweenInfo, {
Transparency = 1,
})
print(isInstanceAPart(tween))TweenInfo
Propriété de lecture qui inclut des informations sur la façon dont l'interpolation du Tween est à effectuer, en utilisant le taperde données Datatype.TweenInfo.
Échantillons de code
-- A TweenInfo with all default parameters
TweenInfo.new()
-- A TweenInfo with its time set to 0.5 seconds.
TweenInfo.new(0.5)
-- A TweenInfo with its easing style set to Back.
TweenInfo.new(0.5, Enum.EasingStyle.Back)
-- A TweenInfo with its easing direction set to In.
TweenInfo.new(0.5, Enum.EasingStyle.Back, Enum.EasingDirection.In)
-- A TweenInfo that repeats itself 4 times.
TweenInfo.new(0.5, Enum.EasingStyle.Back, Enum.EasingDirection.In, 4)
-- A TweenInfo that reverses its interpolation after reaching its goal.
TweenInfo.new(0.5, Enum.EasingStyle.Back, Enum.EasingDirection.In, 4, true)
-- A TweenInfo that loops indefinitely.
TweenInfo.new(0.5, Enum.EasingStyle.Back, Enum.EasingDirection.In, -1, true)
-- A TweenInfo with a delay of 1 second between each interpolation.
TweenInfo.new(0.5, Enum.EasingStyle.Back, Enum.EasingDirection.In, 4, true, 1)