Codox
Search…
Hooks
contentChanged
This hook is the callback equivalent of the
'content_changed'event. It is invoked when the document content has been updated due to changes made by any user in the session. 1
const config = {
2
'hooks': {
3
// invoked whenever the document has been updated
4
contentChanged: (data) => {
5
// data.source === 'local' for local changes
6
// data.source === 'remote' for remote changes
7
doSomthingUseful(data);
8
}
9
}
10
}
11
​
Copied!
Event
data will contain a source field, where 'local' indicates local user changes, and 'remote' indicates remote user changes. Typical use-cases include triggering third party plugins that perform actions such as word-counting, spellchecking, or taking content snapshots
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 updatesIf your application listens to the editor 'onChanged' event to trigger actions like saving document content to the backend, it should instead use this hook callback or the
content_changed event. usersUpdate
usersUpdateThis hook is the callback equivalent of the
'users_update'event. It is invoked every time a new user joins a session or an existing user leaves a session 1
const config = {
2
'hooks': {
3
// invoked whenever a user joins or leaves the session
4
usersUpdate: (data) => {
5
doSomthingUseful(data);
6
}
7
}
8
}
Copied!
The hook's
data object is an array that contains the current snapshot of users currently connected to the session. See 'users_update'event for details.fetchDocOnNetworkReconnect
fetchDocOnNetworkReconnectIf specified, this hook will be invoked whenever an offline user's browser becomes online. It expects a Promise that resolves the latest document version stored in your backend data-store.
1
const config = {
2
'hooks': {
3
// invoked whenever the user's brwosers comes goes from offline -> online
4
fetchDocOnNetworkReconnect: async () => {
5
6
// example: run your doc data fetch api
7
const doc = await fetchDocument();
8
return doc;
9
}
10
}
11
}
Copied!
Last modified 2yr ago
Copy link