Disponibilidade de Material de Apoio

Este texto do catálogo contém as orientações inline abaixo, mas não inclui os seguintes caminhos de suporte. Eles são pré-requisitos externos, não arquivos incluídos:

• <support-root>/references/widget-patterns.md
• <support-root>/references/styling-patterns.md
• <support-root>/references/moly-widget-patterns.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 nem 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.

Habilidade de Padrões de Widgets Robius

Melhores práticas para projetar widgets Makepad reutilizáveis baseados em padrões de código Robrix e Moly.

Bases de código fonte:

• Robrix: Cliente de chat Matrix - Widgets Avatar, RoomsList, RoomScreen
• Moly: Aplicação de chat com IA - Widgets Slot, ChatLine, PromptInput, AdaptiveView

Quando Usar

Use esta habilidade quando:

• Criar widgets Makepad reutilizáveis
• Projetar APIs de componentes de widget
• Implementar padrões de alternância de texto/imagem
• Estilização dinâmica em Makepad
• Palavras-chave: widget robrix, componente makepad, widget reutilizável, padrão de design de widget

Padrões de Produção

Para padrões de widgets prontos para produção, consulte o diretório _base/:

Estrutura Padrão de Widget

use makepad_widgets::*;

live_design! {
    use link::theme::*;
    use link::widgets::*;

    pub MyWidget = {{MyWidget}} {
        width: Fill, height: Fit,
        flow: Down,

        // Child widgets defined in DSL
        inner_view = <View> {
            // ...
        }
    }
}

#[derive(Live, LiveHook, Widget)]
pub struct MyWidget {
    #[deref] view: View,              // Delegate to inner View

    #[live] some_property: f64,       // DSL-configurable property
    #[live(100.0)] default_val: f64,  // With default value

    #[rust] internal_state: State,    // Rust-only state (not in DSL)

    #[animator] animator: Animator,   // For animations
}

impl Widget for MyWidget {
    fn handle_event(&mut self, cx: &mut Cx, event: &Event, scope: &mut Scope) {
        self.view.handle_event(cx, event, scope);
        // Custom event handling...
    }

    fn draw_walk(&mut self, cx: &mut Cx2d, scope: &mut Scope, walk: Walk) -> DrawStep {
        self.view.draw_walk(cx, scope, walk)
    }
}

Padrão de Alternância Texto/Imagem

Um padrão comum para widgets que exibem texto ou uma imagem (como avatares):

live_design! {
    pub Avatar = {{Avatar}} {
        width: 36.0, height: 36.0,
        align: { x: 0.5, y: 0.5 }
        flow: Overlay,  // Empilha visualizações umas sobre as outras

        text_view = <View> {
            visible: true,  // Visível por padrão
            show_bg: true,
            draw_bg: {
                uniform background_color: #888888
                fn pixel(self) -> vec4 {
                    let sdf = Sdf2d::viewport(self.pos * self.rect_size);
                    let c = self.rect_size * 0.5;
                    sdf.circle(c.x, c.x, c.x)
                    sdf.fill_keep(self.background_color);
                    return sdf.result
                }
            }
            text = <Label> {

…