aboutsummaryrefslogtreecommitdiffstats
path: root/docs/content/api/angular.widget.ngdoc
diff options
context:
space:
mode:
Diffstat (limited to 'docs/content/api/angular.widget.ngdoc')
-rw-r--r--docs/content/api/angular.widget.ngdoc78
1 files changed, 0 insertions, 78 deletions
diff --git a/docs/content/api/angular.widget.ngdoc b/docs/content/api/angular.widget.ngdoc
deleted file mode 100644
index 5fd7b259..00000000
--- a/docs/content/api/angular.widget.ngdoc
+++ /dev/null
@@ -1,78 +0,0 @@
-@workInProgress
-@ngdoc overview
-@name angular.widget
-@namespace Namespace for all widgets.
-@description
-# Overview
-Widgets allow you to create DOM elements that the browser doesn't
-already understand. You create the widget in your namespace and
-assign it behavior. You can only bind one widget per DOM element
-(unlike directives, in which you can use any number per DOM
-element). Widgets are expected to manipulate the DOM tree by
-adding new elements whereas directives are expected to only modify
-element properties.
-
-Widgets come in two flavors: element and attribute.
-
-# Element Widget
-Let's say we would like to create a new element type in the
-namespace `my` that can watch an expression and alert() the user
-with each new value.
-
-<pre>
-&lt;my:watch exp="name"/&gt;
-</pre>
-
-You can implement `my:watch` like this:
-<pre>
-angular.widget('my:watch', function(compileElement) {
- var compiler = this;
- var exp = compileElement.attr('exp');
- return function(linkElement) {
- var currentScope = this;
- currentScope.$watch(exp, function(value){
- alert(value);
- });
- };
-});
-</pre>
-
-# Attribute Widget
-Let's implement the same widget, but this time as an attribute
-that can be added to any existing DOM element.
-<pre>
-&lt;div my:watch="name"&gt;text&lt;/div&gt;
-</pre>
-You can implement `my:watch` attribute like this:
-<pre>
-angular.widget('@my:watch', function(expression, compileElement) {
- var compiler = this;
- return function(linkElement) {
- var currentScope = this;
- currentScope.$watch(expression, function(value){
- alert(value);
- });
- };
-});
-</pre>
-
-@example
-<doc:example>
- <doc:source>
- <script>
- angular.widget('my:time', function(compileElement){
- compileElement.css('display', 'block');
- return function(linkElement){
- function update(){
- linkElement.text('Current time is: ' + new Date());
- setTimeout(update, 1000);
- }
- update();
- };
- });
- </script>
- <my:time></my:time>
- </doc:source>
- <doc:scenario>
- </doc:scenario>
-</doc:example>