Method Configuration
This section is used to configure methods for Umo Editor, including document saving, file upload, file deletion, AI document assistant response handling, and more.
Default Methods
{
async onSave(content, page, document) {
throw new Error('Key "onSave": Please set the save method')
},
async onFileUpload(file) {
if (!file) throw new Error('File not found')
throw new Error('Key "onFileUpload": Please set the upload method')
},
onFileDelete(id, url) {
console.error('The file has been deleted. Please configure the onFileDelete to completely delete the file from the server.')
},
}
Configuration Details
onSave
Description:
Configures the document saving method. When the user saves a document, this method will be called to save it to the server.
Type: AsyncFunction
, Promise
Parameters:
content
: The content of the document.page
: Page information.document
: Document metadata.
Return Value:
Return true
if the save is successful, otherwise return false
or throw an error.
Example:
The following example uses Axios to demonstrate how to configure the onSave
method to save documents to the server:
import axios from 'axios'
import { useUmoEditor } from '@umoteam/editor'
const options = {
async onSave(content, page, document) {
const res = await axios.post('/api/save', {
content,
page,
document,
}, {
headers: {
'Content-Type': 'application/json',
}
});
return true;
},
};
app.use(useUmoEditor, options)
onFileUpload
Description:
Configures the file upload method. This method is triggered when the user inserts a file, uploading it to the server.
Type: AsyncFunction
, Promise
Parameter:
file
: TheFile
object to be uploaded.
Return Value:
id
: The file ID returned upon successful upload.url
: The file URL returned upon successful upload.
Example:
The following example uses Axios to demonstrate how to configure the onFileUpload
method to upload files to the server:
import axios from 'axios'
import { useUmoEditor } from '@umoteam/editor'
const options = {
async onFileUpload(file) {
let formData = new FormData();
formData.append('file', file);
const res = await axios.post('/api/file-upload', formData, {
headers: {
'Content-Type': 'multipart/form-data',
}
});
return {
id: res.data.id,
url: res.data.url,
};
},
};
app.use(useUmoEditor, options)
onFileDelete
Description:
Configures the file deletion method. This method is triggered when a user deletes a file, removing it from the server.
Type: Function
Parameters:
id
: File ID.url
: File URL.
Example:
The following example uses Axios to demonstrate how to configure the onFileDelete
method to delete files from the server:
import axios from 'axios'
import { useUmoEditor } from '@umoteam/editor'
const options = {
onFileDelete(id, url) {
axios.delete(`/api/file/${id}`);
},
};
app.use(useUmoEditor, options)