editor.surroundByTagName(tagname)
Get the content of selection and place it into an element. Then insert this new element.
Syntax
editor.surroundByTagName(tagname)
Parameter
Type: String
Required. The tagname of the elements you want to insert.
Return Value
Type: HTMLElement
The HtmlElement that was just inserted.
Example usage
Code example
var editor1 = new RichTextEditor("#div_editor1");
editor1.setHTMLCode("hello world");
editor1.selectDoc();
editor1.surroundByTagName("blockquote"); Calling editor.surroundByTagName() from your app
editor.surroundByTagName() belongs to the editor instance. Every integration below works the same way: keep the object that new RichTextEditor(...) returns, and call it on that object.
Plain JavaScript
Code example
var editor1 = new RichTextEditor("#div_editor1");
// The constructor is synchronous: the editor is ready on the next line.
editor1.surroundByTagName(tagname);React and Next.js
Code example
// editorRef is filled by the RichTextEditor wrapper from the React guides.
const editorRef = useRef(null);
function onClick() {
editorRef.current?.surroundByTagName(tagname);
}
return <RichTextEditor editorRef={editorRef} />;In Vue and Angular, the wrapper components in the guides keep the instance in a component variable (editor), so the call is the same. See the React, Vue and Angular pages, or download a tested project from the guides.
If the editor is undefined
- The call ran before the component mounted. Call it from an event handler or after the mount effect has run.
- In React development mode, Strict Mode mounts, unmounts and mounts again, so the wrapper sets
editorRef.currenttonullin between. UseeditorRef.current?.rather than storing the instance elsewhere. - The editor was destroyed (
editor.destroy()) when its component unmounted.
All methods: method reference · all events: event reference.