logologo
Empezar
Manual
Desarrollo
Plugins
API
Inicio
English
简体中文
日本語
한국어
Español
Português
Deutsch
Français
Русский
Empezar
Manual
Desarrollo
Plugins
API
Inicio
logologo
Descripción general de RunJS
Importación de módulos
Renderizado en contenedor

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()
Aviso de traducción IA

Este documento ha sido traducido por IA. Para información precisa, consulte la versión en inglés.

#ctx.notification

API de notificación global basada en Ant Design Notification, utilizada para mostrar paneles de notificación en la esquina superior derecha de la página. En comparación con ctx.message, las notificaciones pueden incluir un título y una descripción, lo que las hace adecuadas para contenido que debe mostrarse durante más tiempo o que requiere la atención del usuario.

#Escenarios de uso

EscenarioDescripción
JSBlock / Eventos de acciónNotificaciones de finalización de tareas, resultados de operaciones por lotes, finalización de exportaciones, etc.
Flujo de eventosAlertas a nivel de sistema tras la finalización de procesos asíncronos.
Contenido que requiere una visualización más prolongadaNotificaciones completas con títulos, descripciones y botones de acción.

#Definición de tipos

notification: NotificationInstance;

NotificationInstance es la interfaz de notificación de Ant Design, que proporciona los siguientes métodos.

#Métodos comunes

MétodoDescripción
open(config)Abre una notificación con una configuración personalizada
success(config)Muestra una notificación de tipo éxito
info(config)Muestra una notificación de tipo información
warning(config)Muestra una notificación de tipo advertencia
error(config)Muestra una notificación de tipo error
destroy(key?)Cierra la notificación con la clave (key) especificada; si no se proporciona una clave, se cierran todas

Parámetros de configuración (consistentes con Ant Design notification):

ParámetroTipoDescripción
messageReactNodeTítulo de la notificación
descriptionReactNodeDescripción de la notificación
durationnumberRetraso de cierre automático (segundos). El valor predeterminado es 4.5 segundos; establezca 0 para que no se cierre automáticamente
keystringIdentificador único de la notificación, utilizado en destroy(key) para cerrar una notificación específica
onClose() => voidFunción de callback al cerrar
placementstringUbicación: topLeft | topRight | bottomLeft | bottomRight

#Ejemplos

#Uso básico

ctx.notification.open({
  message: 'Operación exitosa',
  description: 'Los datos se han guardado en el servidor.',
});

#Llamadas rápidas por tipo

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'),
});

#Duración y clave personalizadas

ctx.notification.open({
  key: 'task-123',
  message: ctx.t('Task in progress'),
  description: ctx.t('Please wait...'),
  duration: 0,  // No cerrar automáticamente
});

// Cerrar manualmente tras la finalización de la tarea
ctx.notification.destroy('task-123');

#Cerrar todas las notificaciones

ctx.notification.destroy();

#Diferencia con ctx.message

Característicactx.messagectx.notification
UbicaciónCentro superior de la páginaEsquina superior derecha (configurable)
EstructuraAviso ligero de una sola líneaPuede incluir título + descripción
PropósitoRetroalimentación temporal, desaparece automáticamenteNotificación completa, puede mostrarse durante mucho tiempo
Escenarios típicosÉxito de operación, fallo de validación, copia exitosaFinalización de tareas, mensajes del sistema, contenido extenso que requiere atención

#Relacionado

  • ctx.message - Aviso ligero superior, adecuado para una retroalimentación rápida
  • ctx.modal - Confirmación en ventana emergente, interacción de tipo bloqueante
  • ctx.t() - Internacionalización, se utiliza a menudo junto con las notificaciones