#ctx.getModel()

Récupère une instance de modèle (telle que BlockModel, PageModel, ActionModel, etc.) à partir du moteur actuel ou de la pile de vues en fonction de l'identifiant uid du modèle. Ceci est utilisé dans RunJS pour accéder à d'autres modèles à travers les blocs, les pages ou les fenêtres contextuelles (popups).

Si vous avez seulement besoin du modèle ou du bloc où se trouve le contexte d'exécution actuel, utilisez de préférence ctx.model ou ctx.blockModel au lieu de ctx.getModel.

#Scénarios d'utilisation

#Définition du type

getModel<T extends FlowModel = FlowModel>(
  uid: string,
  searchInPreviousEngines?: boolean
): T | undefined

#Paramètres

#Valeur de retour

• Retourne l'instance de la sous-classe FlowModel correspondante (ex : BlockModel, FormBlockModel, ActionModel) si elle est trouvée.
• Retourne undefined si elle n'est pas trouvée.

#Portée de la recherche

• Par défaut (searchInPreviousEngines: false) : Recherche uniquement dans le moteur actuel par uid. Dans les fenêtres contextuelles ou les vues à plusieurs niveaux, chaque vue possède un moteur indépendant ; par défaut, il ne recherche que les modèles au sein de la vue actuelle.
• searchInPreviousEngines: true : Recherche vers le haut le long de la chaîne previousEngine en partant du moteur actuel, en retournant la première correspondance. Utile pour accéder à un modèle sur la page ayant ouvert la fenêtre contextuelle actuelle.

#Exemples

#Obtenir un autre bloc et le rafraîchir

const block = ctx.getModel('list-block-uid');
if (block?.resource) {
  await block.resource.refresh();
}

#Accéder à un modèle sur la page depuis une fenêtre contextuelle

// Accéder à un bloc sur la page qui a ouvert la fenêtre contextuelle actuelle
const pageBlock = ctx.getModel('page-block-uid', true);
if (pageBlock) {
  pageBlock.rerender?.();
}

#Lecture/écriture entre modèles et déclenchement d'un nouveau rendu (rerender)

const target = ctx.getModel('other-block-uid');
if (target) {
  target.setProps({ loading: true });
  target.rerender?.();
}

#Vérification de sécurité

const model = ctx.getModel(someUid);
if (!model) {
  ctx.message.warning('Le modèle cible n’existe pas');
  return;
}

#Relatif à

• ctx.model : Le modèle où se trouve le contexte d'exécution actuel.
• ctx.blockModel : Le modèle de bloc parent où se trouve le JS actuel ; généralement accessible sans avoir besoin de getModel.