Session Events

content_changed

Emitted when the document content has been updated due to changes made by any user in the session.

// invoked whenever the document has been updated
codox.on("content_changed", function(data){
    // data.source === 'local' for local changes
    // data.source === 'remote' for remote changes 
});

This event allows for post-content-update actions, such as triggering third party plugins that can perform any number of actions, such as word-counting, spellchecking, or taking content snapshots

If your application listens to the editor 'onChanged' event to trigger actions like saving document content to the backend, it should instead listen to this 'content_changed' or use the hook equivalent.

note: this hook will not be invoked when edits are made by the local user.

From v1.3.3, contentChanged hook will be invoked for both local and remote updates

users_update

Emitted every time a new user joins a session or an existing user leaves a session

//emitted whenever a user joins or leaves the session
codox.on("users_update", function(data){
});

The event'sdata object is an array that contains the current snapshot of users currently connected to the session. Each element of the array is a JSON object defined as follows:

Key

Value

user

object

joinTime

Date

The user object will contain all the user meta-data that was supplied to the initialization config parameter.

As an example, the data object might look like:

[{
  "user":{
     "name": "Hari",
     "email": "hari@foundation.org",
     "id": "001";
  },
  "joinTime": Mon Sep 02 2019 16:28:47 GMT-0700 (Pacific Daylight Time) {}
},
{
 "name": {
      "name": "Salvor",
      "email": "salvor@foundation.org",
      "id": "002"
 },
 "joinTime": Mon Sep 02 2019 16:38:47 GMT-0700 (Pacific Daylight Time) {}

If you plan to roll your own avatar component implementation, this event provides the data you need to render and update the list of "online" users.

Last updated