diff --git a/src/Angular.js b/src/Angular.js index 9dddaded..cc85f927 100644 --- a/src/Angular.js +++ b/src/Angular.js @@ -1022,10 +1022,31 @@ function merge(src, dst) { } } -function compile(element, existingScope) { + +/** + * @workInProgress + * @ngdoc function + * @name angular.compile + * @function + * + * @description + * Compiles a piece of HTML or DOM into a {@link angular.scope scope} object. +
+ var scope1 = angular.compile(window.document);
+ scope1.$init();
+
+ var scope2 = angular.compile('click me');
+ scope2.$init();
+
+ *
+ * @param {string|DOMElement} element Element to compile.
+ * @param {Object} parentScope Scope to become the parent scope of the newly compiled scope.
+ * @returns {Object} Compiled scope object.
+ */
+function compile(element, parentScope) {
var compiler = new Compiler(angularTextMarkup, angularAttrMarkup, angularDirective, angularWidget),
$element = jqLite(element);
- return compiler.compile($element)($element, existingScope);
+ return compiler.compile($element)($element, parentScope);
}
/////////////////////////////////////////////////