#ctx.openView()

Abre de forma programática una vista especificada (cajón, diálogo, página incrustada, etc.). Proporcionado por FlowModelContext, se utiliza para abrir vistas configuradas de ChildPage o PopupAction en escenarios como JSBlock, celdas de tabla y flujos de trabajo.

#Escenarios de uso

Nota: ctx.openView está disponible en un entorno RunJS donde exista un contexto de FlowModel. Si el modelo correspondiente al uid no existe, se creará y persistirá automáticamente un PopupActionModel.

#Firma

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

#Parámetros

#uid

El identificador único del modelo de vista. Si no existe, se creará y guardará automáticamente. Se recomienda usar un UID estable, como ${ctx.model.uid}-detail, para que la configuración pueda reutilizarse al abrir el mismo diálogo varias veces.

#Campos comunes de options

#Ejemplos

#Uso básico: Abrir un cajón (drawer)

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

#Pasar el contexto de la fila actual

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

#Abrir a través de runAction

Cuando un modelo está configurado con una acción openView (como campos de asociación o campos clicables), usted puede llamar a:

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

#Inyectar contexto personalizado

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

#Relación con ctx.viewer y ctx.view

ctx.openView abre una FlowPage (ChildPageModel), que renderiza internamente una página de flujo completa; ctx.viewer abre contenido arbitrario de React.

#Notas

• Se recomienda asociar el uid con ctx.model.uid (por ejemplo, ${ctx.model.uid}-xxx) para evitar conflictos entre múltiples bloques.
• Cuando se pasan defineProperties o defineMethods, navigation se fuerza a false para evitar la pérdida de contexto tras una actualización.
• Dentro del diálogo, ctx.view se refiere a la instancia de la vista actual, y ctx.view.inputArgs se puede usar para leer los parámetros pasados durante la apertura.

#Relacionado

• ctx.view: La instancia de la vista abierta actualmente.
• ctx.model: El modelo actual, utilizado para construir un popupUid estable.