Disponibilidade de Material de Apoio

Esta cópia do catálogo contém as orientações embutidas abaixo, mas não inclui os seguintes caminhos de suporte. Eles são pré-requisitos externos, não arquivos agrupados:

• ./references/splash-tutorial.md

Solicite o material de apoio original ou uma instalação existente antes de usar uma etapa que dependa desses caminhos; este catálogo não identifica uma fonte de download verificada para eles. Resolva cada caminho em relação a essa instalação, inspecione seu conteúdo e verifique quaisquer licenças e pré-requisitos de execução aplicáveis. Não execute um comando ou afirme que um procedimento referenciado foi seguido até que seu arquivo necessário exista. Não fabrique os scripts ausentes nem trate um arquivo não relacionado com o mesmo nome como equivalente. Etapas independentes totalmente documentadas aqui podem prosseguir dentro do escopo autorizado do usuário; relate qualquer etapa dependente como indisponível.

Makepad Splash Skill

Versão: makepad-widgets (branch dev) | Última Atualização: 2026-01-19

Verifique atualizações: https://crates.io/crates/makepad-widgets

Você é um especialista na linguagem de script Makepad Splash. Ajude os usuários:

• Escrevendo scripts Splash: UI dinâmica e automação de fluxo de trabalho
• Entendendo Splash: Propósito, sintaxe e capacidades

Quando Usar

• Você precisa de scripting dinâmico dentro do Makepad usando Splash.
• A tarefa envolve script!, cx.eval, UI gerada em tempo de execução ou automação de fluxo de trabalho no Makepad.
• Você deseja orientação sobre a sintaxe e o propósito do Splash, em vez de padrões estáticos apenas em Rust.

Documentação

Consulte os arquivos locais para documentação detalhada:

• ./references/splash-tutorial.md - Tutorial da linguagem Splash

IMPORTANTE: Verificação de Completude da Documentação

Antes de responder a perguntas, Claude DEVE:

1. Ler o(s) arquivo(s) de referência relevante(s) listado(s) acima
2. Se a leitura do arquivo falhar ou o arquivo estiver vazio:
   • Informar ao usuário: "本地文档不完整，建议运行 /sync-crate-skills makepad --force 更新文档"
   • Ainda assim, responder com base nos padrões do SKILL.md + conhecimento interno
3. Se o arquivo de referência existir, incorporar seu conteúdo à resposta

O que é Splash?

Splash é a linguagem de script dinâmica do Makepad projetada para:

• Fluxos de trabalho assistidos por IA
• Geração de UI dinâmica
• Prototipagem rápida
• Requisições HTTP e operações assíncronas

Macro de Script

// Embed Splash code in Rust
script!{
    fn main() {
        let x = 10;
        console.log("Hello from Splash!");
    }
}

Execução

// Evaluate Splash code at runtime
cx.eval(code_string); // security-allowlist: Makepad runtime API; require trusted code_string

// With context
cx.eval_with_context(code, context);

Sintaxe Básica

Variáveis

let x = 10;
let name = "Makepad";
let items = [1, 2, 3];
let config = { width: 100, height: 50 };

Funções

fn add(a, b) {
    return a + b;
}

fn greet(name) {
    console.log("Hello, " + name);
}

Fluxo de Controle

// If-else
if x > 10 {
    console.log("big");
} else {
    console.log("small");
}

// Loops
for i in 0..10 {
    console.log(i);
}

while condition {
    // ...
}

Objetos Embutidos

console

console.log("Message");
console.warn("Warning");
console.error("Error");

http

// GET request
let response = http.get("https://api.example.com/data");

// POST request
let response = http.post("https://api.example.com/data", {
    body: { key: "value" }
});

timer

// Set timeout
timer.set(1000, fn() {
    console.log("1 second passed");
});

// Set interval
let id = timer.interval(500, fn() {
    console.log("tick");
});

// Clear timer
timer.clear(id);

Interação com Widgets

// Access widgets
let button = ui.widget("my_button");
button.set_text("Click Me");
button.set_visible(true);

// Listen to events
button.on_click(fn() {
    console.log("Button clicked!");
});

Operações Assíncronas

// Async function
async fn fetch_data() {
    let response = await http.get("https://api.example.com");
    return response.json();
}

// Call async
fetch_data().then(fn(data) {
    console.log(data);
});

Integração de Fluxo de Trabalho de IA

Splash foi projetado para desenvolvimento assistido por IA:

// Geração de UI dinâmica
fn create_form(fields) {
    let form = ui.create("View");
    for field in fields {
        let input = ui.create("TextInput");
        input.set_label(field.label);
        form.add_child(input);
    }
    return form;
}

// A IA pode gerar isso dinamicamente
create_form([
    { label: "Nome" },

…