#ctx.openView()

Ouvrez une vue spécifiée (tiroir, boîte de dialogue, page intégrée, etc.) par programmation. Fourni par FlowModelContext, il est utilisé pour ouvrir des vues ChildPage ou PopupAction configurées dans des scénarios tels que JSBlock, les cellules de tableau, les flux de travail, etc.

#Scénarios d'utilisation

Remarque : ctx.openView est disponible dans un environnement RunJS où un contexte FlowModel existe. Si le modèle correspondant à l' uid n'existe pas, un PopupActionModel sera automatiquement créé et persisté.

#Signature

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

#Paramètres

#uid

L'identifiant unique du modèle de vue. S'il n'existe pas, il sera automatiquement créé et enregistré. Il est recommandé d'utiliser un UID stable, tel que ${ctx.model.uid}-detail, afin que la configuration puisse être réutilisée lors de l'ouverture de la même boîte de dialogue plusieurs fois.

#Champs communs de options

#Exemples

#Utilisation de base : Ouvrir un tiroir

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

#Passer le contexte de la ligne actuelle

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

#Ouvrir via runAction

Lorsqu'un modèle est configuré avec une action openView (comme les champs d'association ou les champs cliquables), vous pouvez appeler :

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

#Injecter un contexte personnalisé

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

#Relation avec ctx.viewer et ctx.view

ctx.openView ouvre une FlowPage (ChildPageModel), qui rend une page de flux complète en interne ; ctx.viewer ouvre n'importe quel contenu React.

#Notes

• Il est recommandé d'associer l' uid à ctx.model.uid (par exemple, ${ctx.model.uid}-xxx) pour éviter les conflits entre plusieurs blocs.
• Lorsque defineProperties ou defineMethods sont transmis, navigation est forcée à false pour éviter la perte de contexte après un rafraîchissement.
• À l'intérieur de la boîte de dialogue, ctx.view fait référence à l'instance de la vue actuelle, et ctx.view.inputArgs peut être utilisé pour lire les paramètres passés lors de l'ouverture.

#Voir aussi

• ctx.view : L'instance de la vue actuellement ouverte.
• ctx.model : Le modèle actuel, utilisé pour construire un popupUid stable.