Description: Attach an event handler function for one or more events to the selected elements.

• version added: 1.7.on( events [, selector ] [, data ], handler )

  • events
    Type: String
    One or more space-separated event types and optional namespaces, such as "click" or "keydown.myPlugin".
  • selector
    Type: String
    A selector string to filter the descendants of the selected elements that trigger the event. If the selector is null or omitted, the event is always triggered when it reaches the selected element.
  • data
    Type: Anything
    Data to be passed to the handler in event.data when an event is triggered.
  • handler
    Type: Function( Event eventObject [, Anything extraParameter ] [, ... ] )
    A function to execute when the event is triggered. The value false is also allowed as a shorthand for a function that simply does return false.

• version added: 1.7.on( events [, selector ] [, data ] )

  • events
    Type: PlainObject
    An object in which the string keys represent one or more space-separated event types and optional namespaces, and the values represent a handler function to be called for the event(s).
  • selector
    Type: String
    A selector string to filter the descendants of the selected elements that will call the handler. If the selector is null or omitted, the handler is always called when it reaches the selected element.
  • data
    Type: Anything
    Data to be passed to the handler in event.data when an event occurs.