#ctx.blockModel

Le modèle de bloc parent (instance de BlockModel) dans lequel se trouve le champ JS ou le bloc JS actuel. Dans des scénarios tels que JSField, JSItem et JSColumn, ctx.blockModel pointe vers le bloc de formulaire ou le bloc de tableau portant la logique JS actuelle. Dans un JSBlock indépendant, il peut être null ou identique à ctx.model.

#Scénarios d'utilisation

Remarque : ctx.blockModel n'est disponible que dans les contextes RunJS où un bloc parent existe. Dans les JSBlock indépendants (sans formulaire/tableau parent), il peut être null. Il est recommandé d'effectuer une vérification de valeur nulle avant utilisation.

#Définition du type

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

Le type spécifique dépend du type de bloc parent : les blocs de formulaire sont principalement des FormBlockModel ou EditFormModel, tandis que les blocs de tableau sont principalement des TableBlockModel.

#Propriétés courantes

#Relation avec ctx.model et ctx.form

Dans un JSField, ctx.model est le modèle de champ, et ctx.blockModel est le bloc de formulaire ou de tableau portant ce champ ; ctx.form est généralement ctx.blockModel.form.

#Exemples

#Tableau : Obtenir les lignes sélectionnées et les traiter

const rows = ctx.blockModel?.resource?.getSelectedRows?.() || [];
if (rows.length === 0) {
  ctx.message.warning('Veuillez d\'abord sélectionner des données');
  return;
}

#Scénario de formulaire : Valider et rafraîchir

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

#Écouter les changements du formulaire

ctx.blockModel?.emitter?.on?.('formValuesChange', (payload) => {
  // Implémenter la liaison ou le rendu basé sur les dernières valeurs du formulaire
});

#Déclencher le rendu du bloc

ctx.blockModel?.rerender?.();

#Précautions

• Dans un JSBlock indépendant (sans bloc de formulaire ou de tableau parent), ctx.blockModel peut être null. Il est recommandé d'utiliser le chaînage optionnel lors de l'accès à ses propriétés : ctx.blockModel?.resource?.refresh?.().
• Dans JSField / JSItem / JSColumn, ctx.blockModel fait référence au bloc de formulaire ou de tableau portant le champ actuel. Dans un JSBlock, il peut s'agir de lui-même ou d'un bloc de niveau supérieur, selon la hiérarchie réelle.
• resource n'existe que dans les blocs de données ; form n'existe que dans les blocs de formulaire. Les blocs de tableau n'ont généralement pas de form.

#Relatif à

• ctx.model : Le modèle du contexte d'exécution actuel.
• ctx.form : Instance de formulaire, couramment utilisée dans les blocs de formulaire.
• ctx.resource : Instance de ressource (équivalent à ctx.blockModel?.resource, à utiliser directement si disponible).
• ctx.getModel() : Obtenir d'autres modèles de blocs par UID.