From c35b0a7907de1535269876668c345ce944681804 Mon Sep 17 00:00:00 2001 From: Igor Minar Date: Mon, 6 Jun 2011 22:02:30 -0700 Subject: yet another docs batch --- docs/content/api/angular.markup.ngdoc | 66 ----------------------------------- 1 file changed, 66 deletions(-) delete mode 100644 docs/content/api/angular.markup.ngdoc (limited to 'docs/content/api/angular.markup.ngdoc') diff --git a/docs/content/api/angular.markup.ngdoc b/docs/content/api/angular.markup.ngdoc deleted file mode 100644 index a40385c8..00000000 --- a/docs/content/api/angular.markup.ngdoc +++ /dev/null @@ -1,66 +0,0 @@ -@workInProgress -@ngdoc overview -@name angular.markup - -@description -#Overview -Markups allow the angular compiler to transform content of DOM elements or portions of this content -into other text or DOM elements for further compilation. Markup extensions do not themselves produce -linking functions. Think of markup as a way to produce shorthand for a {@link angular.widget widget} - or a {@link angular.directive directive}. - -#`{{}}` (double curly) built-in markup -`{{}}` markup is a built-in markup, which translates the enclosed expression into an -{@link angular.directive.ng:bind ng:bind} directive. It simply transforms - -
-{{expression}}
-
- -to: - -
-
-
- -For example `{{1+2}}` is easier to write and understand than ``. The -expanded elements are then {@link guide.compiler compiled} normally. - -# Custom markup -Let's say you want to define this shorthand for a horizontal rule: `---` for `
`. - -In other words, this HTML: -
-header
----
-footer
-
- -should translate to: -
-header
-
-footer -
- -Here's how the angular compiler could be extended to achieve this: -
-angular.markup('---', function(text, textNode, parentElement) {
-  var compiler = this;
-  var index = text.indexOf('---');
-  if (index > -1) {
-    var before = compiler.text(text.substring(0, index));
-    var hr = compiler.element('hr');
-    var after = compiler.text(text.substring(index + 3));
-    textNode.after(after);
-    textNode.after(hr);
-    textNode.after(before);
-    textNode.remove();
-  }
-});
-
- -Unlike {@link angular.widget widgets} and {@link angular.directive directives}, in which the -compiler matches the name of handler function to a DOM element or attribute name, for markup the -compiler calls every markup handler for every text node, giving the handler a chance to transform -the text. The markup handler needs to find all the matches in the text. -- cgit v1.2.3