Limitações

• Verifique com a documentação atual do Makepad 2.0; as APIs de upstream mudam frequentemente.
• Não execute scripts empacotados sem aprovação explícita do usuário.

Quando Usar

• Use quando este fluxo de trabalho de upstream corresponder ao objetivo declarado do usuário.
• Use quando a tarefa exigir os procedimentos documentados nesta habilidade.

Sistema de Eventos e Ações do Makepad 2.0

Visão Geral

O Makepad 2.0 usa um sistema de eventos de duas camadas:

1. Camada Splash -- Manipuladores de eventos inline escritos diretamente no código script_mod! Splash (on_click, on_render, on_return, on_startup). Eles manipulam interações da UI declarativamente dentro do script, perto das definições dos widgets.

2. Camada Rust -- O trait MatchEvent com handle_actions, handle_timer, handle_http_response, etc. Eles manipulam a lógica de negócios, I/O externo e qualquer coisa que precise do poder total do Rust.

Ambas as camadas se comunicam através de duas macros de ponte:

• script_eval!(cx, { ... }) -- Executa código Splash a partir do Rust (atualiza estado, aciona renders)
• script_apply_eval!(cx, widget_ref, { ... }) -- Corrige propriedades de widgets a partir do Rust em tempo de execução

1. Manipuladores de Eventos Inline do Splash

Os manipuladores de eventos são anexados diretamente aos widgets dentro de blocos script_mod!. Eles usam sintaxe de closure com || para nenhum argumento ou |arg| para callbacks que recebem um valor.

on_click -- Clique de Botão/Widget

Dispara quando o usuário clica em um botão ou widget clicável. Nenhum argumento para botões simples, ou |checked| para CheckBox, que passa o novo estado booleano.

// Plain button click
add_button := Button{
    text: "Add"
    on_click: ||{
        let text = ui.todo_input.text()
        if text != "" {
            add_todo(text, "")
            ui.todo_input.set_text("")
        }
    }
}

// CheckBox click with checked state argument
check.on_click: |checked| toggle_todo(i, checked)

// Inline delete with closure capturing loop variable
delete.on_click: || delete_todo(i)

// Calling another widget's click programmatically
clear_done := ButtonFlatter{
    text: "Clear completed"
    on_click: ||{
        todos.retain(|todo| !todo.done)
        ui.todo_list.render()
    }
}

on_render -- Renderização Dinâmica

Dispara quando .render() é chamado na view alvo. Este é o mecanismo principal para conteúdo dinâmico. O corpo substitui o conteúdo de desenho anterior da view.

main_view := View{
    width: Fill
    height: Fill
    on_render: ||{
        counter_label := Label{
            text: "Count: " + state.counter
            draw_text.text_style.font_size: 24
        }
    }
}

// List rendering with for loop and per-item event handlers
todo_list := ScrollYView{
    width: Fill height: Fill
    new_batch: true
    on_render: ||{
        if todos.len() == 0
            EmptyState{}
        else for i, todo in todos {
            TodoItem{
                label.text: todo.text
                check.active: todo.done
                check.on_click: |checked| toggle_todo(i, checked)
                delete.on_click: || delete_todo(i)
            }
        }
    }
    EmptyState{}
}

Ponto chave: on_render NÃO é chamado automaticamente. Você deve chamar ui.widget_name.render() para acioná-lo. A propriedade new_batch: true em uma view diz ao sistema para limpar o conteúdo de desenho anterior antes de renderizar novamente.

on_return -- Tecla Enter do TextInput

Dispara quando o usuário pressiona Enter/Return dentro de um TextInput. Comumente usado para enviar formulários.

todo_input := TextInput{
    width: Fill height: 9. * theme.space_1
    empty_text: "What needs to be done?"
    on_return: || ui.add_button.on_click()
}

on_startup -- Inicialização do App

Dispara uma vez quando o aplicativo inicia. Definido no nível Root. Comumente usado para acionar renders iniciais.

ui: Root{
    on_startup: ||{
        ui.main_view.render()
    }
    main_window := Window{
        // ...
    }
}

Capacidades do Manipulador de Eventos

Dentro dos manipuladores de eventos você pode:

• Chamar funções Splash: add_todo(text, "dev")
• Ler valores de widgets: let text = ui.todo_input.text()
• Definir valores de widgets: ui.todo_input.set_text("")
• Acionar re-renders: ui.todo_list.render()
• Acionar outros cliques de widgets: ui.add_button.on_click()
• Modificar variáveis de estado: state.counter += 1
• Usar métodos de array: todos.push({text: "new", done: false})
• Usar fluxo de controle: if text != "" { ... }

2. Manipulação de Eventos Rust -- Trait MatchEvent

O trait MatchEvent é o despachante de eventos do lado Rust. Ele recebe eventos da plataforma

…