SelectData

gradio.SelectData(···)

描述

gr.SelectData 类是 gr.EventData 的子类，专门携带关于 `.select()` 事件的信息。当 gr.SelectData 作为类型提示添加到事件监听器方法的参数时，一个 gr.SelectData 对象将自动作为该参数的值传递。此对象的属性包含有关触发监听器的事件的信息。

示例用法

import gradio as gr

with gr.Blocks() as demo:
    table = gr.Dataframe([[1, 2, 3], [4, 5, 6]])
    gallery = gr.Gallery([("cat.jpg", "Cat"), ("dog.jpg", "Dog")])
    textbox = gr.Textbox("Hello World!")
    statement = gr.Textbox()

    def on_select(evt: gr.SelectData):
        return f"You selected {evt.value} at {evt.index} from {evt.target}"

    table.select(on_select, None, statement)
    gallery.select(on_select, None, statement)
    textbox.select(on_select, None, statement)

demo.launch()

属性

🔗

index: int | tuple[int, int]

所选项目的索引。如果组件是二维的或选择是一个范围，则为元组。

🔗

value: Any

所选项目的值。

🔗

row_value: list[float | str]

所选项目所属的整行值，以一维列表形式。仅对 `Dataframe` 组件实现，对于其他组件返回 None。

🔗

col_value: list[float | str]

所选项目所属的整列值，以一维列表形式。仅对 `Dataframe` 组件实现，对于其他组件返回 None。

🔗

selected: bool

如果项目被选中，则为 True；如果取消选中，则为 False。

演示

import gradio as gr import numpy as np with gr.Blocks() as demo: imgs = gr.State() gallery = gr.Gallery(allow_preview=False) def deselect_images(): return gr.Gallery(selected_index=None) def generate_images(): images = [] for _ in range(9): image = np.ones((100, 100, 3), dtype=np.uint8) * np.random.randint( 0, 255, 3 ) # image is a solid single color images.append(image) return images, images demo.load(generate_images, None, [gallery, imgs]) with gr.Row(): selected = gr.Number(show_label=False) darken_btn = gr.Button("Darken selected") deselect_button = gr.Button("Deselect") deselect_button.click(deselect_images, None, gallery) def get_select_index(evt: gr.SelectData): return evt.index gallery.select(get_select_index, None, selected) def darken_img(imgs, index): index = int(index) imgs[index] = np.round(imgs[index] * 0.8).astype(np.uint8) return imgs, imgs darken_btn.click(darken_img, [imgs, selected], [imgs, gallery]) if __name__ == "__main__": demo.launch()

import gradio as gr
import numpy as np

with gr.Blocks() as demo:
    imgs = gr.State()
    gallery = gr.Gallery(allow_preview=False)

    def deselect_images():
        return gr.Gallery(selected_index=None)

    def generate_images():
        images = []
        for _ in range(9):
            image = np.ones((100, 100, 3), dtype=np.uint8) * np.random.randint(
                0, 255, 3
            )  # image is a solid single color
            images.append(image)
        return images, images

    demo.load(generate_images, None, [gallery, imgs])

    with gr.Row():
        selected = gr.Number(show_label=False)
        darken_btn = gr.Button("Darken selected")
    deselect_button = gr.Button("Deselect")

    deselect_button.click(deselect_images, None, gallery)

    def get_select_index(evt: gr.SelectData):
        return evt.index

    gallery.select(get_select_index, None, selected)

    def darken_img(imgs, index):
        index = int(index)
        imgs[index] = np.round(imgs[index] * 0.8).astype(np.uint8)
        return imgs, imgs

    darken_btn.click(darken_img, [imgs, selected], [imgs, gallery])

if __name__ == "__main__":
    demo.launch()

import gradio as gr with gr.Blocks() as demo: turn = gr.Textbox("X", interactive=False, label="Turn") board = gr.Dataframe(value=[["", "", ""]] * 3, interactive=False, type="array") def place(board: list[list[int]], turn, evt: gr.SelectData): if evt.value: return board, turn board[evt.index[0]][evt.index[1]] = turn turn = "O" if turn == "X" else "X" return board, turn board.select(place, [board, turn], [board, turn], show_progress="hidden") if __name__ == "__main__": demo.launch()

import gradio as gr

with gr.Blocks() as demo:
    turn = gr.Textbox("X", interactive=False, label="Turn")
    board = gr.Dataframe(value=[["", "", ""]] * 3, interactive=False, type="array")

    def place(board: list[list[int]], turn, evt: gr.SelectData):  
        if evt.value:
            return board, turn
        board[evt.index[0]][evt.index[1]] = turn
        turn = "O" if turn == "X" else "X"
        return board, turn

    board.select(place, [board, turn], [board, turn], show_progress="hidden")

if __name__ == "__main__":
    demo.launch()

←

LikeData

FileData

→