En esta página, presentamos cómo se pueden adjuntar controladores a varios eventos de Kintone. Los diferentes tipos de eventos de Kintone se enumeran en el menú lateral.

Registra un controlador de eventos.

kintone.events.on(type, handler)

PARÁMETRO	VALOR	OBLIGATORIO	DESCRIPCIÓN
type	Una cadena o una matriz de cadenas	Sí	Tipo de evento o matriz de tipos de eventos, a los que se enlazará el controlador de eventos.
handler	Función(Objeto)	Sí	Controlador que se ejecutará cuando se desencadene el evento. Todos los objetos de evento tienen un tipo de evento en su propiedad type. Al devolver un archivo kintone.Promise objeto* En el controlador de eventos, se pueden procesar las siguientes operaciones después de esperar a que finalicen los procesos asincrónicos en el controlador de eventos: Eventos de la lista de registros: Evento Onload Evento de edición en línea Guardar evento Guardar evento de éxito Evento de eliminación Eventos de detalles de registro: Evento de carga Evento de eliminación Evento de estado de actualización Eventos de creación de registros: Evento Onload Guardar evento Guardar evento de éxito Grabar eventos de edición: Guardar evento Guardar evento de éxito Evento Onload Grabar eventos de impresión: Evento Onload Eventos de visualización de gráficos: Evento Onload Eventos de visualización del portal: Evento Onload *Un kintone.Promise object es un objeto que contiene un método "then". Referencia (Sitio externo): https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise

Nada

1
2
3
4
5
6

var handler = function(event) {
  console.log(event);
};
kintone.events.on('app.record.index.show', handler);

kintone.events.on(['app.record.detail.show', 'app.record.edit.show'], handler);

Quita los controladores de eventos de los tipos de eventos especificados.

kintone.events.off(type, handler)

True, si se ha quitado algún controlador de eventos.
False, si no se ha quitado ningún controlador de eventos.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

var handler = function(event) {
  console.log(event);
};
kintone.events.on('app.record.index.show', handler);

// Option 1: Remove the specified handler from the specified event type
kintone.events.off('app.record.index.show', handler);

// Option 2: Remove all handlers from the specified event type
kintone.events.off('app.record.index.show');

// Option 3: Remove all handlers from all event types
kintone.events.off();

• Si hay archivos JavaScript para aplicaciones y complementos en la misma aplicación, el orden en el que se leen los archivos es el siguiente:
  • Archivos JavaScript para aplicaciones
  • Archivos JavaScript para plug-ins
• Los controladores de eventos no se pueden sobrescribir. Será necesario eliminar el controlador de eventos existente y, a continuación, agregar un nuevo controlador de eventos.
• Si hay varias categorías con el mismo nombre dentro de la misma aplicación, en cualquiera de los siguientes eventos, al devolver un objeto que contiene la propiedad category, se puede devolver una categoría no deseada. Para evitar esto, devuelva el objeto después de eliminar la propiedad category.
  Eventos:
  • Evento de lista de registros
    • app.record.index.edit.submit
    • app.record.index edit.change.(field code)
  • Evento de creación de registros
    • app.record.create.show
    • app.record.create.submit
    • app.record.create.change. (código de campo)
    • mobile.app.record.create.show
    • mobile.app.record.create.submit
    • mobile.app.registro.crear.cambio. (código de campo)
  • Grabar evento de edición
    • app.record.edit.show
    • app.record.edit.submit
    • app.record.edit.change.(field code)
    • mobile.app.record.edit.show
    • mobile.app.record.edit.submit
    • mobile.app.record.edit.change.(field code)
  • Evento de detalles de registro
    • app.record.detail.process.proceed