honeymoose
/
angular-cn
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs(attribute-directives): small fixes. 

closes #618
This commit is contained in:
Kion Stephen 2015-12-28 21:55:13 -04:00 committed by Ward Bell
parent af458737be
commit 7269d3481d
1 changed files with 12 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
public/docs/ts/latest/guide/attribute-directives.jade
View File

@ -81,11 +81,17 @@ include ../../../../_includes/_util-fns
:marked
### Why not call it "highlight"?
*highlight* is a nicer name than *myHighlight* and, technically, it would work if we called it that.
However, the good folks at Angular strongly prefer hyphenated directive selector names.
The HTML standards body will never name one of its attributes with a hyphen and there is
less risk of colliding with a third-party directive name when we give ours a prefix.
The `ng` prefix belongs to Angular.
However, we recommend picking a selector name with a prefix to ensure
that it cannot conflict with any standard HTML attribute, now or in the future.
There is also less risk of colliding with a third-party directive name when we give ours a prefix.
We do **not** prefix our `highlight` directive name with **`ng`**.
That prefix belongs to Angular and
we don't want to confuse our directives with their directives.
We need a prefix of our own, preferably short, and `my` will do for now.
:marked
After the `@Directive` metadata comes the directive's controller class which we are exporting
to make it accessible to other components.
@ -355,7 +361,7 @@ figure.image-display
In all previous bindings, the directive or component property was a binding ***source***.
A property is a *source* if it appears in the template expression to the ***right*** of the (=).
A property is a *target* when it appears to the ***left** of the (=) ...
A property is a *target* when it appears to the **left** of the (=) ...
as it is does when we bind to the `myHighlight` property of the `HighlightDirective`,
+makeExample('attribute-directives/ts/app/app.component.html','span')(format=".")
:marked
@ -378,4 +384,4 @@ figure.image-display
That could really mess up our directive in ways we didn't anticipate and have no desire to support.
The *input* declaration ensures that consumers of our directive can only bind to
the properties of our public API ... nothing else.
the properties of our public API ... nothing else.