feat(cursor): Add getParentContainer() helper function.

Author: jenstroeger

src/cursor.js

@@ -37,6 +37,35 @@ export default class Cursor {
     this.isCursor = true
   }
 
+  // Get all tags that affect the current selection. Optionally pass a
+  // method to filter the returned elements.
+  //
+  // @param {Function filter(node)} [Optional] Method to filter the returned
+  //   DOM Nodes.
+  // @return {Array of DOM Nodes}
+  getTags (filterFunc) {
+    return content.getTags(this.host, this.range, filterFunc)
+  }
+
+  // Get the names of all tags that affect the current selection. Optionally
+  // pass a method to filter the returned elements.
+  //
+  // @param {Function filter(node)} [Optional] Method to filter the DOM
+  //   Nodes whose names are returned.
+  // @return {Array<String> of tag names}
+  getTagNames (filterFunc) {
+    return content.getTagNames(this.getTags(filterFunc))
+  }
+
+  // Get all tags of the specified type that affect the current selection.
+  //
+  // @method getTagsByName
+  // @param {String} tagName. E.g. 'a' to get all links.
+  // @return {Array of DOM Nodes}
+  getTagsByName (tagName) {
+    return content.getTagsByName(this.host, this.range, tagName)
+  }
+
   isAtEnd () {
     return parser.isEndOfHost(
       this.host,
@@ -341,6 +370,24 @@ export default class Cursor {
     return content.adoptElement(node, this.win.document)
   }
 
+  // Check whether the cursor's closest parent element node matches
+  // the given tagName (and optional className), and return that
+  // parent if it does or null if not.
+  getParentContainer (tagName, className) {
+    const tags = this.getTags()
+
+    let node = tags.shift()
+    if (node.nodeType !== Node.TEXT_NODE) return null
+
+    if (tags.length === 0) return null
+
+    node = tags.shift()
+    if (node.nodeName !== tagName) return null
+    if (className && !node.classList.contains(className)) return null
+
+    return node
+  }
+
   // Currently we call triggerChange manually after format changes.
   // This is to prevent excessive triggering of the change event during
   // merge or split operations or other manipulations by scripts.

src/selection.js

@@ -249,35 +249,6 @@ export default class Selection extends Cursor {
     this.setSelection()
   }
 
-  // Get all tags that affect the current selection. Optionally pass a
-  // method to filter the returned elements.
-  //
-  // @param {Function filter(node)} [Optional] Method to filter the returned
-  //   DOM Nodes.
-  // @return {Array of DOM Nodes}
-  getTags (filterFunc) {
-    return content.getTags(this.host, this.range, filterFunc)
-  }
-
-  // Get the names of all tags that affect the current selection. Optionally
-  // pass a method to filter the returned elements.
-  //
-  // @param {Function filter(node)} [Optional] Method to filter the DOM
-  //   Nodes whose names are returned.
-  // @return {Array<String> of tag names}
-  getTagNames (filterFunc) {
-    return content.getTagNames(this.getTags(filterFunc))
-  }
-
-  // Get all tags of the specified type that affect the current selection.
-  //
-  // @method getTagsByName
-  // @param {String} tagName. E.g. 'a' to get all links.
-  // @return {Array of DOM Nodes}
-  getTagsByName (tagName) {
-    return content.getTagsByName(this.host, this.range, tagName)
-  }
-
   // Check if the selection is the same as the elements contents.
   //
   // @method isExactSelection