#ctx.openView()

Abre programaticamente uma visualização especificada (gaveta, diálogo, página incorporada, etc.). Fornecido pelo FlowModelContext, é usado para abrir visualizações ChildPage ou PopupAction configuradas em cenários como JSBlock, células de tabela e fluxos de trabalho.

#Cenários de uso

Nota: ctx.openView está disponível em um ambiente RunJS onde existe um contexto FlowModel. Se o modelo correspondente ao uid não existir, um PopupActionModel será criado automaticamente e persistido.

#Assinatura

openView(uid: string, options?: OpenViewOptions): Promise<void>

#Descrição dos parâmetros

#uid

O identificador único do modelo de visualização. Se não existir, será criado e salvo automaticamente. Recomenda-se usar um UID estável, como ${ctx.model.uid}-detail, para que a configuração possa ser reutilizada ao abrir o mesmo diálogo várias vezes.

#Campos comuns de options

#Exemplos

#Uso básico: Abrir uma gaveta (drawer)

const popupUid = `${ctx.model.uid}-detail`;
await ctx.openView(popupUid, {
  mode: 'drawer',
  size: 'medium',
  title: ctx.t('Detalhes'),
});

#Passando o contexto da linha atual

const primaryKey = ctx.collection?.primaryKey || 'id';
await ctx.openView(`${ctx.model.uid}-1`, {
  mode: 'dialog',
  title: ctx.t('Detalhes da Linha'),
  params: {
    filterByTk: ctx.record?.[primaryKey],
    record: ctx.record,
  },
});

#Abrir via runAction

Quando um modelo está configurado com uma ação openView (como campos de associação ou campos clicáveis), você pode chamar:

await ctx.runAction('openView', {
  navigation: false,
  mode: 'dialog',
  collectionName: 'users',
  filterByTk: ctx.record?.id,
});

#Injetando contexto personalizado

await ctx.openView(`${ctx.model.uid}-edit`, {
  mode: 'drawer',
  filterByTk: ctx.record?.id,
  defineProperties: {
    onSaved: {
      get: () => () => ctx.resource?.refresh?.(),
      cache: false,
    },
  },
});

#Relação com ctx.viewer e ctx.view

ctx.openView abre uma FlowPage (ChildPageModel), que renderiza uma página de fluxo completa internamente; ctx.viewer abre qualquer conteúdo React.

#Observações

• Recomenda-se associar o uid ao ctx.model.uid (ex: ${ctx.model.uid}-xxx) para evitar conflitos entre múltiplos blocos.
• Quando defineProperties ou defineMethods são passados, navigation é forçado para false para evitar a perda de contexto após uma atualização.
• Dentro do diálogo, ctx.view refere-se à instância da visualização atual, e ctx.view.inputArgs pode ser usado para ler os parâmetros passados durante a abertura.

#Relacionado

• ctx.view: A instância da visualização aberta no momento.
• ctx.model: O modelo atual, usado para construir um popupUid estável.