aboutsummaryrefslogtreecommitdiffstats
path: root/docs/content/error/$compile/nonassign.ngdoc
diff options
context:
space:
mode:
Diffstat (limited to 'docs/content/error/$compile/nonassign.ngdoc')
-rw-r--r--docs/content/error/$compile/nonassign.ngdoc41
1 files changed, 41 insertions, 0 deletions
diff --git a/docs/content/error/$compile/nonassign.ngdoc b/docs/content/error/$compile/nonassign.ngdoc
new file mode 100644
index 00000000..3a7d996b
--- /dev/null
+++ b/docs/content/error/$compile/nonassign.ngdoc
@@ -0,0 +1,41 @@
+@ngdoc error
+@name $compile:nonassign
+@fullName Non-Assignable Expression
+@description
+
+This error occurs when a directive defines an isolate scope property
+(using the `=` mode in the {@link ng.$compile#description_comprehensive-directive-api_directive-definition-object
+`scope` option} of a directive definition) but the directive is used with an expression that is not-assignable.
+
+In order for the two-way data-binding to work, it must be possible to write new values back into the path defined with the expression.
+
+For example, given a directive:
+
+```
+myModule.directive('myDirective', function factory() {
+ return {
+ ...
+ scope: {
+ 'bind': '=localValue'
+ }
+ ...
+ }
+});
+```
+
+Following are invalid uses of this directive:
+```
+<!-- ERROR because `1+2=localValue` is an invalid statement -->
+<my-directive bind="1+2">
+
+<!-- ERROR because `myFn()=localValue` is an invalid statement -->
+<my-directive bind="myFn()">
+```
+
+
+To resolve this error, always use path expressions with scope properties that are two-way data-bound:
+```
+<my-directive bind="some.property">
+<my-directive bind="some[3]['property']">
+```
+