#ctx.blockModel

O modelo do bloco pai (instância de BlockModel) onde o campo JS / bloco JS atual está localizado. Em cenários como JSField, JSItem e JSColumn, ctx.blockModel aponta para o bloco de formulário ou bloco de tabela que contém a lógica JS atual. Em um JSBlock independente, ele pode ser null ou o mesmo que ctx.model.

#Cenários de uso

Nota: ctx.blockModel está disponível apenas em contextos RunJS onde existe um bloco pai. Em JSBlocks independentes (sem um formulário/tabela pai), ele pode ser null. Recomenda-se realizar uma verificação de valor nulo antes do uso.

#Definição de Tipo

blockModel: BlockModel | FormBlockModel | TableBlockModel | CollectionBlockModel | DataBlockModel | null;

O tipo específico depende do tipo do bloco pai: blocos de formulário são geralmente FormBlockModel ou EditFormModel, enquanto blocos de tabela são geralmente TableBlockModel.

#Propriedades Comuns

#Relação com ctx.model e ctx.form

Em um JSField, ctx.model é o modelo do campo, e ctx.blockModel é o bloco de formulário ou tabela que contém esse campo; ctx.form é tipicamente ctx.blockModel.form.

#Exemplos

#Tabela: Obter linhas selecionadas e processar

const rows = ctx.blockModel?.resource?.getSelectedRows?.() || [];
if (rows.length === 0) {
  ctx.message.warning('Por favor, selecione os dados primeiro');
  return;
}

#Cenário de Formulário: Validar e Atualizar

if (ctx.blockModel?.form) {
  await ctx.blockModel.form.validateFields();
  await ctx.blockModel.resource?.refresh?.();
}

#Ouvir mudanças no formulário

ctx.blockModel?.emitter?.on?.('formValuesChange', (payload) => {
  // Implementar vinculação ou re-renderização com base nos valores mais recentes do formulário
});

#Acionar a re-renderização do bloco

ctx.blockModel?.rerender?.();

#Observações

• Em um JSBlock independente (sem um bloco de formulário ou tabela pai), ctx.blockModel pode ser null. Recomenda-se usar o encadeamento opcional (optional chaining) ao acessar suas propriedades: ctx.blockModel?.resource?.refresh?.().
• Em JSField / JSItem / JSColumn, ctx.blockModel refere-se ao bloco de formulário ou tabela que contém o campo atual. Em um JSBlock, ele pode ser o próprio bloco ou um bloco de nível superior, dependendo da hierarquia real.
• resource existe apenas em blocos de dados; form existe apenas em blocos de formulário. Blocos de tabela geralmente não possuem um form.

#Relacionado

• ctx.model: O modelo do contexto de execução atual.
• ctx.form: Instância de formulário, comumente usada em blocos de formulário.
• ctx.resource: Instância de recurso (equivalente a ctx.blockModel?.resource, use diretamente se disponível).
• ctx.getModel(): Obter outros modelos de bloco por UID.