Adding prepend function on metal-dom

packages/metal-dom/src/domNamed.js

@@ -521,6 +521,28 @@ export function parent(element, selector) {
 	return closest(element.parentNode, selector);
 }
 
+/**
+ * Inserts a node before first child of the parent. If child is a HTML string
+ * it will be converted to document fragment before prepending it to the parent.
+ * @param {!Element} parent The node to prepend to.
+ * @param {!(Element|NodeList|string)} child The thing who must be prepended
+ * @return {!Element} The prepended child
+ */
+export function prepend(parent, child) {
+	if (isString(child)) {
+		child = buildFragment(child);
+	}
+	if (isNodeListLike(child)) {
+		const childArr = Array.prototype.slice.call(child);
+		for (let i = 0; i < childArr.length; i++) {
+			parent.insertBefore(childArr[i].firstChild, parent);
+		}
+	} else {
+		parent.insertBefore(child, parent.firstChild);
+	}
+	return child;
+}
+
 /**
  * Registers a custom event.
  * @param {string} eventName The name of the custom event.

packages/metal-dom/test/dom.js

@@ -215,6 +215,26 @@ describe('dom', function() {
 			assert.strictEqual('myChild2', parent.childNodes[1].className);
 		});
 
+		it('should prepend an element into a div', function() {
+			let parent = document.createElement('div');
+			let p = document.createElement('p');
+			let span = document.createElement('span');
+
+			dom.append(parent, p);
+			dom.prepend(parent, span);
+
+			assert.strictEqual(parent.innerHTML, '<span></span><p></p>');
+		});
+
+		it('should prepend a text into a div', function() {
+			let parent = document.createElement('div');
+
+			dom.append(parent, 'Some text');
+			dom.prepend(parent, 'Headline: ');
+
+			assert.strictEqual(parent.innerHTML, 'Headline: Some text');
+		});
+
 		it('should replace an element with a requested element', function() {
 			let element1 = document.createElement('div');
 			let element2 = document.createElement('div');