Componente
A unidade de interface, uma árvore de elementos associada a estado local, dados e à lógica de fluxo de trabalho que a liga.
Um Componente é uma unidade de interface: uma árvore de elementos associada a estado local, dados opcionais, lógica de ciclo de vida e uma interface de entrada e saída. Uma página, um cartão, um modal, um popover, um fragmento em linha, são todos Componentes, e é o tipo de documento mais rico da plataforma, com a sua própria árvore de interface a par dos campos, eventos e fonte de dados partilhados com todos os outros tipos de programa.
Propriedades
renderType (form / grid / list) está obsoleto e já não é necessário; os novos componentes são criados sem ele. O que um novo Componente realmente recebe é uma escolha de estrutura, single ou multi, escolhida uma só vez na caixa de diálogo Novo Componente: single cria uma raiz xu-template simples, pronta para construir diretamente, multi cria a mesma raiz xu-template com um div de carregamento e um xu-multi-view já aninhado dentro dela. xu-single-view continua a ser uma etiqueta real e utilizável, apenas não é uma que a fábrica coloque por si: só um documento antigo não migrado (raiz ainda não xu-template) é verificado face a ela, quando o seu renderType obsoleto ainda diz form.
progUi, a árvore de elementos
O nó raiz é sempre um xu-template transparente, criado pelo scaffold_prog_ui de create_prog. Escolher a estrutura multi aninha por si um div de carregamento e um xu-multi-view lá dentro; a estrutura single deixa-o vazio, construa diretamente dentro dos seus children. Cada nó precisa de um id único, type: "element", um tagName e attributes: {} e children: [] mesmo quando vazios.
Além das etiquetas HTML simples, algumas etiquetas da xuda são escritas diretamente: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.
Um tagName com maiúscula inicial (Button, Dialog) é sempre reivindicado como um componente compilado do sistema de design, nunca como um elemento HTML, mesmo quando é um erro de escrita: lança um erro na montagem, indicando a etiqueta e todas as origens tentadas. Os seus atributos simples tornam-se props, não atributos do DOM (variant, color, class chegam todos como props.<name>), e, ao contrário do xu-panel, não tem parâmetros de saída, uma etiqueta de componente só lê o que lhe passa.
Comportamento dinâmico: atributos xu-*
Todos os atributos xu-* que a árvore de elementos de um Componente pode ter:
Dois são fáceis de trocar: xu-bind recebe o id de campo simples, sem @, a única exceção à regra do @ em todo o lado; e xu-exp:class substitui por completo o atributo class estático, pelo que as classes de esquema têm de ser repetidas dentro da expressão.
progFields, progEvents, progDataSource
Estado local (progFields, virtual ou associado a table), uma Fonte de dados incorporada opcional e eventos de ciclo de vida. Três desses eventos dividem o trabalho de uma forma fácil de trocar:
Colocar trabalho de atualização em screen_ready volta a executar a lógica de criação sobre um DOM que ainda existe e empilha um segundo widget sobre o primeiro.
Incorporar outro programa: xu-panel
xu-panel (tagName em minúsculas, atributo program) monta outro programa Componente com os seus próprios campos, fonte de dados e eventos, em contraste com uma etiqueta de sistema de design com maiúscula inicial. Passe valores para os seus parâmetros _in com atributos xu-exp:<param>; ao contrário de uma etiqueta de sistema de design, um painel pode escrever valores de volta nos seus campos através dos parâmetros _out.
Exemplo prático
Escolha a forma
Escolha single na caixa de diálogo Novo Componente para um só registo: construa diretamente dentro da raiz xu-template. Escolha multi para uma lista: cria por si um xu-multi-view dentro dessa raiz, adicione xu-for (ou a abreviatura for= do .xu) no nó repetido.
Associe os dados
xu-bind para campos de entrada, xu-exp:xu-content para texto calculado, um progDataSource se o componente tiver a sua própria leitura.
Ligue a interação
xu-on:click com um fluxo de trabalho ou, em .xu, um bloco de ação nomeado referenciado com @click.
Construa a árvore na tela: arraste elementos, defina atributos no painel de propriedades, ligue handlers xu-on:* a passos de fluxo de trabalho no editor de fluxos de trabalho. Prima o botão de reprodução da pré-visualização para verificar o resultado em direto.
O .xu compila <single-view> para xu-single-view, :content para uma expressão xu-exp:xu-content e um atributo simples for="@list_v" para xu-for.