gradio toggle

gradio_toggle

Un composant à bascule qui représente une valeur booléenne, permettant aux utilisateurs de basculer entre les états True et False. Peut fonctionner à la fois comme entrée, pour capturer l’interaction de l’utilisateur, et comme sortie, pour afficher un état booléen.

Installation

pip install gradio_toggle

Usage

 import gradio as gr
from gradio_toggle import Toggle

def update ( input ):
    output = input
    return output

with gr . Blocks () as demo :
    title = gr . HTML ( "<h1><center>gradio-toggle demo</center></h1>" )
    with gr . Row ():
        with gr . Column ():
            input = Toggle (
                label = "Input" ,
                value = False ,
                info = "Input version of the component" ,
                interactive = True ,
            )
        with gr . Column ():
            output = Toggle (
                label = "Output" ,
                value = False ,
                color = "green" ,
                interactive = False ,
            )
        
    input . change ( fn = update , inputs = input , outputs = output )
        
if __name__ == "__main__" :
    demo . launch ()

Toggle

Initialisation

Événements

nom	taper	défaut	description
value	bool | Callable	False	État initial de la bascule. S'il est appelable, il définit l'état initial de manière dynamique lors du chargement de l'application.
label	str | None
label	str | Aucun	None	Étiquette de texte affichée à côté de la bascule. Si Aucun et utilisé dans une `gr.Interface`, il s'agit par défaut du nom du paramètre.
info	str | Aucun	None	Texte affiché sous la bascule pour des conseils ou des informations supplémentaires.
color	str | Aucun	None	Paramètre de couleur facultatif pour la bascule, prenant en charge les valeurs de couleur CSS (par exemple, noms, codes hexadécimaux).
radius	Littéral["sm", "lg"]	"lg"	Taille du rayon de bordure utilisé pour le style de bascule.
transition	flotter	0.3	Temps de transition (en secondes) entre l'état activé et désactivé.
show_label	booléen | Aucun	None	Si True, l'étiquette est affichée ; sinon, il est caché.
container	bouffon	True	Si True, la bascule est placée dans un conteneur stylisé pour le regroupement visuel et le remplissage.
scale	entier | Aucun	None	Dimensionnement relatif de la bascule par rapport aux composants adjacents lorsqu'elle est affichée dans une ligne ou un bloc.
min_width	int	160	Largeur minimale en pixels qu'occupera la bascule, garantissant qu'elle ne rétrécit pas en dessous de cette taille.
interactive	booléen | Aucun	None	Si True, la bascule peut être utilisée pour interagir ; si False, il est désactivé. Le comportement par défaut est détecté automatiquement en fonction de l'utilisation.
visible	bouffon	True	Si False, la bascule n’est pas rendue visible dans l’interface.
elem_id	str | Aucun	None	Identifiant facultatif de l'élément HTML ; utile pour les personnalisations CSS.
elem_classes	liste[str] | str | Aucun	None	Liste facultative de noms de classe pour l'élément HTML ; utile pour les personnalisations CSS.
every	flotter | Aucun	None	Si la valeur est appelable, spécifie la fréquence (en secondes) d'actualisation de la valeur lorsque l'interface est ouverte.
render	bouffon	True	Si False, le composant n'est pas rendu immédiatement, ce qui est utile pour le rendu différé ou les mises à jour conditionnelles de l'interface utilisateur.
key	entier | str | Aucun	None	S'il est attribué, sera utilisé pour assumer l'identité lors d'un nouveau rendu. Les composants qui ont la même clé lors d'un nouveau rendu verront leur valeur préservée.

nom	description
change	Déclenché lorsque la valeur de la bascule change soit en raison d'une entrée de l'utilisateur (par exemple, un utilisateur tape dans une zone de texte) OU en raison d'une mise à jour de fonction (par exemple, une image reçoit une valeur de la sortie d'un déclencheur d'événement). Voir .input() pour un écouteur qui n'est déclenché que par l'entrée de l'utilisateur.
input	Cet écouteur est déclenché lorsque l'utilisateur modifie la valeur de la bascule.
select	Écouteur d'événements lorsque l'utilisateur sélectionne ou désélectionne la bascule. Utilise les données d'événement gradio.SelectData pour transporter value faisant référence à l'étiquette de la bascule, et selected pour faire référence à l'état de la bascule. Consultez la documentation EventData pour savoir comment utiliser ces données d'événement.

Fonction utilisateur

L'impact sur la fonction de prévision des utilisateurs varie selon que le composant est utilisé comme entrée ou comme sortie pour un événement (ou les deux).

• Lorsqu'il est utilisé comme entrée, le composant n'impacte que la signature d'entrée de la fonction utilisateur.
• Lorsqu'il est utilisé en sortie, le composant n'impacte que la signature de retour de la fonction utilisateur.

L'extrait de code ci-dessous est précis dans les cas où le composant est utilisé à la fois comme entrée et comme sortie.

• En sortie : est transmis, l'état de bascule sous forme de valeur booléenne.
• En entrée : doit être renvoyé, l'état de bascule à renvoyer.

 def predict (
    value : bool | None
) -> bool | None :
    return value