logologo
Démarrer
Manuel
Développement
Plugins
API
Accueil
English
简体中文
日本語
한국어
Español
Português
Deutsch
Français
Русский
Démarrer
Manuel
Développement
Plugins
API
Accueil
logologo
Présentation de RunJS
Importation de modules
Rendu dans le conteneur

Variables globales

window
document
navigator

ctx

ctx.blockModel
ctx.collection
ctx.collectionField
ctx.dataSource
ctx.dataSourceManager
ctx.element
ctx.exit()
ctx.exitAll()
ctx.filterManager
ctx.form
ctx.getModel()
ctx.getValue()
ctx.getVar()
ctx.i18n
ctx.importAsync()
ctx.initResource()
ctx.libs
ctx.location
ctx.logger
ctx.makeResource()
ctx.message
ctx.modal
ctx.model
ctx.notification
ctx.off()
ctx.on()
ctx.openView()
ctx.render()
ctx.request()
ctx.requireAsync()
ctx.resource
ctx.route
ctx.router
ctx.setValue()
ctx.sql
ctx.t()
ctx.view
Previous Pagectx.model
Next Pagectx.off()
Avis de traduction IA

Ce document a été traduit par IA. Pour des informations précises, veuillez consulter la version anglaise.

#ctx.notification

Basée sur Ant Design Notification, cette API de notification globale est utilisée pour afficher des panneaux de notification dans le coin supérieur droit de la page. Par rapport à ctx.message, les notifications peuvent inclure un titre et une description, ce qui les rend adaptées aux contenus devant être affichés plus longtemps ou nécessitant l'attention de l'utilisateur.

#Scénarios d'utilisation

ScénarioDescription
JSBlock / Événements d'actionNotifications de fin de tâche, résultats d'opérations groupées, fin d'exportation, etc.
Flux de travailAlertes au niveau du système après la fin de processus asynchrones.
Contenu nécessitant un affichage prolongéNotifications complètes avec titres, descriptions et boutons d'action.

#Définition du type

notification: NotificationInstance;

NotificationInstance est l'interface de notification d'Ant Design, fournissant les méthodes suivantes.

#Méthodes courantes

MéthodeDescription
open(config)Ouvre une notification avec une configuration personnalisée
success(config)Affiche une notification de type succès
info(config)Affiche une notification de type information
warning(config)Affiche une notification de type avertissement
error(config)Affiche une notification de type erreur
destroy(key?)Ferme la notification avec la clé spécifiée ; si aucune clé n'est fournie, ferme toutes les notifications

Paramètres de configuration (Identiques à Ant Design notification) :

ParamètreTypeDescription
messageReactNodeTitre de la notification
descriptionReactNodeDescription de la notification
durationnumberDélai de fermeture automatique (en secondes). Par défaut 4,5 secondes ; réglez sur 0 pour désactiver la fermeture automatique
keystringIdentifiant unique de la notification, utilisé pour destroy(key) afin de fermer une notification spécifique
onClose() => voidFonction de rappel déclenchée lors de la fermeture
placementstringPosition : topLeft | topRight | bottomLeft | bottomRight

#Exemples

#Usage de base

ctx.notification.open({
  message: 'Opération réussie',
  description: 'Les données ont été enregistrées sur le serveur.',
});

#Appels rapides par type

ctx.notification.success({
  message: ctx.t('Export completed'),
  description: ctx.t('Exported {{count}} records', { count: 10 }),
});

ctx.notification.error({
  message: ctx.t('Export failed'),
  description: ctx.t('Please check the console for details'),
});

ctx.notification.warning({
  message: ctx.t('Warning'),
  description: ctx.t('Some data may be incomplete'),
});

#Durée et clé personnalisées

ctx.notification.open({
  key: 'task-123',
  message: ctx.t('Task in progress'),
  description: ctx.t('Please wait...'),
  duration: 0,  // Ne pas fermer automatiquement
});

// Fermeture manuelle après la fin de la tâche
ctx.notification.destroy('task-123');

#Fermer toutes les notifications

ctx.notification.destroy();

#Différence avec ctx.message

Caractéristiquectx.messagectx.notification
PositionHaut au centre de la pageCoin supérieur droit (configurable)
StructureIndication légère sur une seule lignePeut inclure titre + description
UsageRetour temporaire, disparaît automatiquementNotification plus complète, peut être affichée longtemps
Scénarios typiquesSuccès d'opération, échec de validation, copie réussieFin de tâche, messages système, contenu long nécessitant l'attention de l'utilisateur

#Relatif

  • ctx.message - Indication légère en haut, adaptée aux retours rapides
  • ctx.modal - Confirmation par fenêtre modale, interaction bloquante
  • ctx.t() - Internationalisation, souvent utilisée avec les notifications