sindri-form

0.1.4 • Public • Published

sindri-form

Este módulo disponibiliza uma diretiva que permiter automatizar a criação de formulários apartir de um modelo no formato sindri.

Tem como base a biblitoeca angular-formly e utiliza uma versão modificada do formly LumX

É utilizado pelo sindri-crud para gerar um crud completo de modelo definidos, sendo usado em conjunto com o sindri-grid

Quando usado em conjunto com sindri-crud, funciona apenas como uma dependencia.

O Objetivo é facilitar criação de formulários comuns que simplesmente persistem dados no modelo

Módulos Relacionados

  • sindri-crud
  • sindri-grid
  • sindri-model (atualmente incorporado ao sindri-framework)
  • sindri-framework

TODO: Documentar. IMPORTANTE!!!!!!!

  • Funcionamento geral do sindriFOrmly (talvez com diagrama, é complexo)
  • Como funciona o formly
  • Como definir campos e wrapper
  • Como vincular ao sindrimodel
  • Documentar os métodos padrões acessado pela api
    • /schema
    • Se model for especificado, não é obrigatório /schema (explicar pq)
    • Documentação parcial no Zim (PASSO A PASSO fo formly criar a partir de lá)
  • Como criar validação personalizada
  • Documentar como definir atributos personalizado do formulário aqui, Expressions propertyes

Configuração

Propriedade Status Descrição
api Url da API com acesso ao Sindri Model, para geração do formulário automaticamente
template É possível carregar templates diferente do mesmo schema, definição é feita no servidor
id Id do registro, se definido é uma atualização, carrega dados do servidor, caso contrário novo registro
model Caso deseje um formulário personalizado, possível definir modelo aqui TODO
customFields Definição de campo diretamente pelo Formly sem acessar o sindriModel, neste caso não será salvo automaticamente no servidor (TODO)
httpRequest Função que será usada para enviar e receber dados do servidor, DEVE ter a mesma interface do angular $http.(OPCIONAL). Quando
definido, é usado para interceptar a comunicação com servidor e verificar se ocorreu alguma problema, como problema de autenticação,
dessa forma pode ser tomada medidas para resolver o problema sem que o destinatiario, saiba, assim q o problema estiver resolido os
dados são retornados normalmente como se nada tivesse acontecido

TODO:

  • Configuração de botão Submit

    • Salvar
    • Salvar e Adicionar Outro
    • Cancelar
    • Voltar Proximo
  • Adicionar ng-model (Com o atributo api, o formulário consegue fazer toda comunicação com servidor desde a geração de formulário até persistencia) Porém pode haver casos em que precisamos de um formulário simples ou diferente, cuja comunicação com servidor precisa ser personalizada

  • Separar o Grow do Sindri Admin, deixar generico, pois é usado no sindri-form

  • Por enquanto cada campo tem dois modo: sucesso e erro, mas tb podemos usar o aviso (que tem no materialDesign), exemplo de uso: Senha Fraca

  • Na verdade podemos ter um status personalizado pra sucesso tb, com um icone de ok no final (ver no template do material design)

Dependencies (14)

Dev Dependencies (0)

    Package Sidebar

    Install

    npm i sindri-form

    Weekly Downloads

    0

    Version

    0.1.4

    License

    ISC

    Last publish

    Collaborators

    • atimermann