docs(error/compile/tplrt): split long lines

This commit is contained in:
Pete Bacon Darwin 2013-10-26 20:13:27 +01:00
parent 81d5bc860d
commit 0bbb9e6258

View file

@ -3,13 +3,16 @@
@fullName Invalid Template Root
@description
When a directive is declared with `template` (or `templateUrl`) and `replace` mode on, the template must have exactly one root element.
That is, the text of the template property or the content referenced by the templateUrl must be contained within a single html element.
When a directive is declared with `template` (or `templateUrl`) and `replace` mode on, the template
must have exactly one root element. That is, the text of the template property or the content
referenced by the templateUrl must be contained within a single html element.
For example, '<p>blah <em>blah</em> blah</p>' instead of simply 'blah <em>blah</em> blah'.
Otherwise, the replacement operation would result in a single element (the directive) being replaced with multiple elements or nodes, which is unsupported and not commonly needed in practice.
Otherwise, the replacement operation would result in a single element (the directive) being replaced
with multiple elements or nodes, which is unsupported and not commonly needed in practice.
For example a directive with definition:
```
myModule.directive('myDirective', function factory() {
return {
@ -21,12 +24,16 @@ myModule.directive('myDirective', function factory() {
});
```
And a template provided at URL `someUrl`. The template must be an html fragment that has only a single root element, like the `div` element in this template:
And a template provided at URL `someUrl`. The template must be an html fragment that has only a
single root element, like the `div` element in this template:
```
<div><b>Hello</b> World!</div>
```
An an invalid template to be used with this directive is one that defines multiple root nodes or elements. For example:
An an invalid template to be used with this directive is one that defines multiple root nodes or
elements. For example:
```
<b>Hello</b> World!
```