@formkit/core

Introdução

A biblioteca oficial do núcleo FormKit. Este pacote é responsável pela maior parte da funcionalidade interna do FormKit. Você pode ler a documentação especificamente sobre como ele funciona em formkit.com.

Você pode adicionar este pacote usando npm install @formkit/core ou yarn add @formkit/core.

FormKitNode

O objeto Node do FormKit produzido pelo createNode(). Cada entrada <FormKit /> tem 1 FormKitNode ("nó central") associado a ela. Todas as entradas, formulários e grupos são instâncias de nós. Leia mais sobre nós centrais na documentação de arquitetura.

add()

Adicione um filho a um nó. O nó deve ser um grupo ou lista.

Assinatura

add: (node: FormKitNode, index?: number) => FormKitNode

Parâmetros

  • node — Um FormKitNode.
  • index opcional — Um índice para onde será adicionado.

Retorna

O FormKitNode adicionado.

address

O endereço do nó atual a partir da raiz da árvore.

Assinatura

address: FormKitAddress

Retorna

Um FormKitAddress.

addProps()

Adiciona props ao nó dado, removendo-os de node.props.attrs e movendo-os para o objeto node.props de nível superior.

Assinatura

addProps: (props: string[]) => FormKitNode

Parâmetros

  • props — Uma matriz de strings para serem adicionadas como chaves para props.

Retorna

O FormKitNode.

at()

Obtém um nó em outro endereço. Os endereços são caminhos de sintaxe de ponto (ou matrizes) de nomes de nós. Por exemplo: form.users.0.first_name. Existem também alguns tokens de travessia "especiais":

  • $root — Seleciona o nó raiz.
  • $parent — Seleciona o nó pai.
  • $self — Seleciona o nó atual.

Assinatura

at: (address: FormKitAddress | string) => FormKitNode | undefined

Parâmetros

Retorna

O FormKitNode encontrado ou undefined.

children

Uma matriz de nós filhos (grupos e listas).

Assinatura

children: Array<FormKitNode>

Retorna

Uma matriz de FormKitNode.

clearErrors()

Limpa os erros do nó, e opcionalmente todos os filhos.

Assinatura

clearErrors: (clearChildren?: boolean, sourceKey?: string) => FormKitNode

Parâmetros

  • clearChildren opcional — Se deve limpar os filhos.
  • sourceKey opcional — Uma chave de origem para usar para resetar.

Retorna

O FormKitNode.

config

Um objeto de FormKitConfig que é compartilhado em toda a árvore com várias opções de configuração que devem ser aplicadas a toda a árvore.

Assinatura

config: FormKitConfig

Retorna

Um FormKitConfig.

define()

Define o tipo de biblioteca de entrada atual, incluindo tipo de nó, esquema e props.

Assinatura

define: (definition: FormKitTypeDefinition) => void

Parâmetros

destroy()

Remove o nó do registro global, de seu pai, e emite o evento 'destroying'.

Assinatura

destroy: () => void

each()

Executa o callback fornecido em cada um dos filhos do nó dado.

Assinatura

each: (callback: FormKitChildCallback) => void

Parâmetros

emit()

Emite um evento do nó para que possa ser ouvido por on.

Assinatura

emit: (event: string, payload?: any, bubble?: boolean, meta: Record<string, unknown>) => FormKitNode

Parâmetros

  • event — O nome do evento a ser emitido.
  • payload opcional — Um valor a ser passado junto com o evento.
  • bubble opcional — Se o evento deve subir para o pai.

Retorna

O FormKitNode.

extend()

Estende um FormKitNode adicionando propriedades arbitrárias que são acessíveis via node.{property}().

Assinatura

extend: (property: string, trap: FormKitTrap) => FormKitNode

Parâmetros

  • property — A propriedade para adicionar ao nó principal (node.{property}).
  • trap — Um objeto com uma propriedade get e set.

Retorna

O FormKitNode.

find()

Dentro de uma determinada árvore, encontra um nó que corresponda a um determinado seletor. Os seletores podem ser strings simples ou uma função.

Assinatura

find: (
 selector: string,
 searcher?: keyof FormKitNode | FormKitSearchFunction
) => FormKitNode | undefined