gradio toggle

gradio_toggle

Eine Umschaltkomponente, die einen booleschen Wert darstellt und es Benutzern ermöglicht, zwischen den Zuständen „Wahr“ und „Falsch“ zu wechseln. Kann sowohl als Eingabe zur Erfassung der Benutzerinteraktion als auch als Ausgabe zur Anzeige eines booleschen Zustands fungieren.

Installation

pip install gradio_toggle

Verwendung

 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

Initialisierung

Veranstaltungen

Name	Typ	Standard	Beschreibung
value	bool | Callable	False	Anfangszustand des Umschalters. Wenn es aufrufbar ist, legt es den Anfangszustand dynamisch fest, wenn die App geladen wird.
label	str | None
label	str | Keiner	None	Neben dem Umschalter wird eine Textbeschriftung angezeigt. Wenn „Keine“ vorhanden ist und innerhalb eines „gr.Interface“ verwendet wird, wird standardmäßig der Parametername verwendet.
info	str | Keiner	None	Unterhalb des Schalters wird Text für zusätzliche Anleitungen oder Informationen angezeigt.
color	str | Keiner	None	Optionale Farbeinstellung für den Umschalter, unterstützt CSS-Farbwerte (z. B. Namen, Hex-Codes).
radius	Literal["sm", "lg"]	"lg"	Größe des Rahmenradius, der für den Umschaltstil verwendet wird.
transition	schweben	0.3	Übergangszeit (in Sekunden) zwischen dem Ein- und Aus-Zustand.
show_label	bool | Keiner	None	Bei „True“ wird die Bezeichnung angezeigt; andernfalls ist es ausgeblendet.
container	bool	True	Bei „True“ wird der Schalter zur visuellen Gruppierung und Auffüllung in einem gestalteten Container platziert.
scale	int | Keiner	None	Relative Größe des Umschalters im Vergleich zu benachbarten Komponenten bei Anzeige in einer Reihe oder einem Block.
min_width	int	160	Mindestbreite in Pixeln, die der Schalter einnimmt, um sicherzustellen, dass er nicht unter diese Größe schrumpft.
interactive	bool | Keiner	None	Wenn True, kann mit dem Schalter interagiert werden. Wenn False, ist es deaktiviert. Das Standardverhalten wird basierend auf der Nutzung automatisch erkannt.
visible	bool	True	Bei „Falsch“ wird der Umschalter in der Benutzeroberfläche nicht sichtbar dargestellt.
elem_id	str | Keiner	None	Optionaler Bezeichner für das HTML-Element; nützlich für CSS-Anpassungen.
elem_classes	list[str] | str | Keiner	None	Optionale Liste von Klassennamen für das HTML-Element; nützlich für CSS-Anpassungen.
every	schweben | Keiner	None	Wenn der Wert aufrufbar ist, gibt er an, wie oft (in Sekunden) der Wert aktualisiert werden soll, während die Schnittstelle geöffnet ist.
render	bool	True	Bei False wird die Komponente nicht sofort gerendert, was für verzögertes Rendern oder bedingte UI-Updates nützlich ist.
key	int | str | Keiner	None	Wenn zugewiesen, wird es verwendet, um bei einem erneuten Rendering die Identität anzunehmen. Der Wert von Komponenten, die bei einem erneuten Rendern denselben Schlüssel haben, bleibt erhalten.

Name	Beschreibung
change	Wird ausgelöst, wenn sich der Wert des Schalters ändert, entweder aufgrund einer Benutzereingabe (z. B. ein Benutzer gibt etwas in ein Textfeld ein) ODER aufgrund einer Funktionsaktualisierung (z. B. erhält ein Bild einen Wert von der Ausgabe eines Ereignisauslösers). Siehe .input() für einen Listener, der nur durch Benutzereingaben ausgelöst wird.
input	Dieser Listener wird ausgelöst, wenn der Benutzer den Wert des Schalters ändert.
select	Ereignis-Listener für den Fall, dass der Benutzer den Schalter auswählt oder abwählt. Verwendet die Ereignisdaten gradio.SelectData, um value zu übertragen, der sich auf die Beschriftung des Umschalters bezieht, und selected um auf den Status des Umschalters zu verweisen. Informationen zur Verwendung dieser Ereignisdaten finden Sie in der EventData-Dokumentation

Benutzerfunktion

Die Auswirkungen auf die Vorhersagefunktion des Benutzers variieren je nachdem, ob die Komponente als Eingabe oder Ausgabe für ein Ereignis (oder beides) verwendet wird.

• Bei Verwendung als Eingabe wirkt sich die Komponente nur auf die Eingabesignatur der Benutzerfunktion aus.
• Bei Verwendung als Ausgabe wirkt sich die Komponente nur auf die Rückgabesignatur der Benutzerfunktion aus.

Der folgende Codeausschnitt ist in Fällen korrekt, in denen die Komponente sowohl als Eingabe als auch als Ausgabe verwendet wird.

• Als Ausgabe: Übergeben wird der Toggle-Zustand als boolescher Wert.
• Als Eingabe: Sollte zurückgeben, der Umschaltstatus, der zurückgegeben werden soll.

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