| OLD | NEW |
|---|
| (Empty) | |
| 1 <!doctype html> |
| 2 <!-- |
| 3 This file is autogenerated with polymer/tool/create_message_details_page.dart |
| 4 --> |
| 5 <html> |
| 6 <style> |
| 7 @font-face { |
| 8 font-family: 'Montserrat'; |
| 9 font-style: normal; |
| 10 font-weight: 400; |
| 11 src: url(https://themes.googleusercontent.com/static/fonts/montserrat/v4/zhcz-
_WihjSQC0oHJ9TCYL3hpw3pgy2gAi-Ip7WPMi0.woff) format('woff'); |
| 12 } |
| 13 @font-face { |
| 14 font-family: 'Montserrat'; |
| 15 font-style: normal; |
| 16 font-weight: 700; |
| 17 src: url(https://themes.googleusercontent.com/static/fonts/montserrat/v4/IQHow
_FEYlDC4Gzy_m8fcnbFhgvWbfSbdVg11QabG8w.woff) format('woff'); |
| 18 } |
| 19 @font-face { |
| 20 font-family: 'Roboto'; |
| 21 font-style: normal; |
| 22 font-weight: 300; |
| 23 src: url(https://themes.googleusercontent.com/static/fonts/roboto/v10/Hgo13k-t
fSpn0qi1SFdUfbO3LdcAZYWl9Si6vvxL-qU.woff) format('woff'); |
| 24 } |
| 25 @font-face { |
| 26 font-family: 'Roboto'; |
| 27 font-style: normal; |
| 28 font-weight: 400; |
| 29 src: url(https://themes.googleusercontent.com/static/fonts/roboto/v10/CrYjSnGj
rRCn0pd9VQsnFOvvDin1pK8aKteLpeZ5c0A.woff) format('woff'); |
| 30 } |
| 31 |
| 32 body { |
| 33 width: 80vw; |
| 34 margin: 20px; |
| 35 font-family: Roboto, sans-serif; |
| 36 } |
| 37 |
| 38 h1 { |
| 39 font-family: Montserrat, sans-serif; |
| 40 box-sizing: border-box; |
| 41 color: rgb(72, 72, 72); |
| 42 display: block; |
| 43 font-style: normal; |
| 44 font-variant: normal; |
| 45 font-weight: normal; |
| 46 } |
| 47 |
| 48 h2 { |
| 49 font-family: Montserrat, sans-serif; |
| 50 box-sizing: border-box; |
| 51 color: rgb(72, 72, 72); |
| 52 display: block; |
| 53 font-style: normal; |
| 54 font-variant: normal; |
| 55 font-weight: normal; |
| 56 } |
| 57 |
| 58 pre { |
| 59 display: block; |
| 60 padding: 9.5px; |
| 61 margin: 0 0 10px; |
| 62 line-height: 1.42857143; |
| 63 color: #333; |
| 64 word-break: break-all; |
| 65 word-wrap: break-word; |
| 66 background-color: #f5f5f5; |
| 67 border: 1px solid #ccc; |
| 68 border-radius: 4px; |
| 69 } |
| 70 |
| 71 code { |
| 72 font-family: Menlo,Monaco,Consolas,"Courier New",monospace; |
| 73 box-sizing: border-box; |
| 74 padding: 0; |
| 75 font-size: 90%; |
| 76 color: #0084c5; |
| 77 white-space: nowrap; |
| 78 border-radius: 4px; |
| 79 background-color: #f9f2f4; |
| 80 } |
| 81 |
| 82 pre > code { |
| 83 white-space: inherit; |
| 84 } |
| 85 |
| 86 a { |
| 87 color: rgb(42, 100, 150); |
| 88 } |
| 89 |
| 90 h2 > a { |
| 91 display: none; |
| 92 font-size: 0.8em; |
| 93 } |
| 94 |
| 95 h2:hover > a { |
| 96 display: inline; |
| 97 } |
| 98 </style> |
| 99 <body> |
| 100 <h1>Messages from package <code>code_transformers</code></h1> |
| 101 <hr /> |
| 102 |
| 103 <h2 id="msg_code_transformers_1">Absolute paths not allowed <a href="#msg_code_t
ransformers_1">#1</a></h2> |
| 104 <p>The transformers processing your code were trying to resolve a URL and identi
fy |
| 105 a file that they correspond to. Currently only relative paths can be resolved.</
p> |
| 106 <hr /> |
| 107 |
| 108 <h2 id="msg_code_transformers_2">Invalid URL to reach another package <a href="#
msg_code_transformers_2">#2</a></h2> |
| 109 <p>To reach an asset that belongs to another package, use <code>package:</code>
URLs in |
| 110 Dart code, but in any other language (like HTML or CSS) use relative URLs.</p> |
| 111 <p>These are the rules you must follow to write URLs that refer to files in othe
r |
| 112 packages:</p><ul><li> |
| 113 <p>If the file containing the relative URL is an entrypoint under <code>web</cod
e>, use |
| 114 <code>packages/package_name/path_to_file</code></p></li><li> |
| 115 <p>If the file containing the URL is under <code>web</code>, but in a different
directory |
| 116 than your entrypoint, walk out to the same level as the entrypoint first, |
| 117 then enter the <code>packages</code> directory.</p> |
| 118 <p><strong>Note</strong>: If two entrypoints include the file under <code>web</c
ode> containing the |
| 119 URL, either both entrypoints have to live in the same directory, or you need |
| 120 to move the file to the <code>lib</code> directory.</p></li><li> |
| 121 <p>If the file containing the URL lives under <code>lib</code>, walk up as many
levels as |
| 122 directories you have + 1. This is because code in <code>lib/a/b</code> is loaded
from |
| 123 <code>packages/package_name/a/b</code>.</p></li></ul> |
| 124 <p>The rules are easier to follow if you know how the code is laid out for |
| 125 Dartium before you build, and how it is laid out after you build it with <code>p
ub |
| 126 build</code>. Consider the following example:</p> |
| 127 <p> package a</p> |
| 128 <pre><code> lib/ |
| 129 |- a1.html |
| 130 |
| 131 web/ |
| 132 |- a2.html |
| 133 </code></pre> |
| 134 <p> package b</p> |
| 135 <pre><code> lib/ |
| 136 |- b1.html |
| 137 |- b2/ |
| 138 |- b3.html |
| 139 </code></pre> |
| 140 <p> package c</p> |
| 141 <pre><code> lib/ |
| 142 |- c3.html |
| 143 |
| 144 web/ |
| 145 |- index.html |
| 146 |- index.dart |
| 147 |- c1/ |
| 148 |- c2.html |
| 149 </code></pre> |
| 150 <p>If your app is package <code>c</code>, then <code>pub get</code> generates a
packages directory under |
| 151 the web directory, like this:</p> |
| 152 <pre><code> web/ |
| 153 |- index.html |
| 154 |- index.dart |
| 155 |- c1/ |
| 156 | |- c2.html |
| 157 |- packages/ |
| 158 |- a/ |
| 159 | |- a1.html |
| 160 |- b/ |
| 161 | |- b1.html |
| 162 | |- b2/ |
| 163 | |- b3.html |
| 164 |- c/ |
| 165 |- c3.html |
| 166 </code></pre> |
| 167 <p>Note that no <code>lib</code> directory is under the <code>packages</code> di
rectory. |
| 168 When you launch <code>web/index.html</code> in Dartium, Dartium loads <code>pack
age:</code> imports from |
| 169 <code>web/packages/</code>.</p> |
| 170 <p>If you need to refer to any file in other packages from <code>index.html</cod
e>, you can |
| 171 simply do <code>packages/package_name/path_to_file</code>. For example |
| 172 <code>packages/b/b2/b3.html</code>. From <code>index.html</code> you can also re
fer to files under the |
| 173 web directory of the same package using a simple relative URL, like |
| 174 <code>c1/c2.html</code>.</p> |
| 175 <p>However, if you want to load <code>a1.html</code> from <code>c2.html</code>,
you need to reach out to |
| 176 the packages directory that lives next to your entrypoint and then load the file |
| 177 from there, for example <code>../packages/a/a1.html</code>. Because pub generate
s symlinks |
| 178 to the packages directory also under c1, you may be tempted to write |
| 179 <code>packages/a/a1.html</code>, but that is incorrect - it would yield a canoni
calization |
| 180 error (see more below).</p> |
| 181 <p>If you want to load a file from the lib directory of your own package, you |
| 182 should also use a package URL. For example, <code>packages/c/c3.html</code> and
not |
| 183 <code>../lib/c3.html</code>. This will allow you to write code in <code>lib</cod
e> in a way that it |
| 184 can be used within and outside your package without making any changes to it.</p
> |
| 185 <p>Because any time you reach inside a <code>lib/</code> directory you do so usi
ng a |
| 186 <code>packages/</code> URL, the rules for reaching into other files in other pac
kages are |
| 187 always consistent: go up to exit the <code>packages</code> directory and go back
inside to |
| 188 the file you are looking for. For example, to reach <code>a1.html</code> from <
code>b3.html</code> |
| 189 you need to write <code>../../../packages/a/a1.html</code>.</p> |
| 190 <p>The motivation behind all these rules is that URLs need to work under many |
| 191 scenarios at once:</p><ul><li> |
| 192 <p>They need to work in Dartium without any code transformation: resolving the |
| 193 path in the context of a simple HTTP server, or using <code>file:///</code> URLs
, |
| 194 should yield a valid path to assets. The <code>packages</code> directory is safe
to use |
| 195 because pub already creates it next to entrypoints of your application.</p></li>
<li> |
| 196 <p>They need to be canonical. To take advantage of caching, multiple URLs |
| 197 reaching the same asset should resolve to the same absolute URL.</p> |
| 198 <p>Also, in projects that use HTML imports (like polymer) tools support that |
| 199 you reach a library with either Dart imports or HTML imports, and correctly |
| 200 resolve them to be the same library. The rules are designed to allow tools |
| 201 to support this.</p> |
| 202 <p>For example, consider you have an import might like:</p> |
| 203 <pre><code><link rel=import href=packages/a/a.html> |
| 204 </code></pre> |
| 205 <p>where a.html has <code><script type="application/dart" src="a.dart"></c
ode>. If your |
| 206 Dart entrypoint also loads <code>"package:a/a.dart"</code>, then a tool need to
make |
| 207 sure that both versions of <code>a.dart</code> are loaded from the same URL. Oth
erwise, |
| 208 you may see errors at runtime like: <code>A is not a subtype of A</code>, which
can be |
| 209 extremely confusing.</p> |
| 210 <p>When you follow the rules above, our tools can detect the pattern in the |
| 211 HTML-import URL containing <code>packages/</code> and canonicalize the import |
| 212 by converting <code>packages/a/a.dart</code> into <code>package:a/a.dart</code>
under the hood.</p></li><li> |
| 213 <p>They need to continue to be valid after applications are built. |
| 214 Technically this could be done automatically with pub transformers, but to |
| 215 make sure that code works also in Dartium with a simple HTTP Server, |
| 216 existing transformers do not fix URLs, they just detect inconsistencies and |
| 217 produce an error message like this one, instead.</p></li></ul> |
| 218 <hr /> |
| 219 |
| 220 <h2 id="msg_code_transformers_3">Incomplete URL to asset in another package <a h
ref="#msg_code_transformers_3">#3</a></h2> |
| 221 <p>URLs that refer to assets in other packages need to explicitly mention the |
| 222 <code>packages/</code> directory. In the future this requirement might be remove
d, but for |
| 223 now you must use a canonical URL form for it.</p> |
| 224 <p>For example, if <code>packages/a/a.html</code> needs to import <code>packages
/b/b.html</code>, |
| 225 you might expect a.html to import <code>../b/b.html</code>. Instead, it must imp
ort |
| 226 <code>../../packages/b/b.html</code>. |
| 227 See <a href="http://dartbug.com/15797">issue 15797</a>.</p> |
| 228 <hr /><h1>Messages from package <code>observe</code></h1> |
| 229 <hr /> |
| 230 |
| 231 <h2 id="msg_observe_1"><code>@observable</code> not supported on libraries <a hr
ef="#msg_observe_1">#1</a></h2> |
| 232 <p>Only instance fields on <code>Observable</code> classes can be observable, |
| 233 and you must explicitly annotate each observable field as <code>@observable</cod
e>.</p> |
| 234 <p>Support for using the <code>@observable</code> annotation in libraries, class
es, and |
| 235 elsewhere is deprecated.</p> |
| 236 <hr /> |
| 237 |
| 238 <h2 id="msg_observe_2"><code>@observable</code> not supported on top-level field
s <a href="#msg_observe_2">#2</a></h2> |
| 239 <p>Only instance fields on <code>Observable</code> classes can be observable, |
| 240 and you must explicitly annotate each observable field as <code>@observable</cod
e>.</p> |
| 241 <p>Support for using the <code>@observable</code> annotation in libraries, class
es, and |
| 242 elsewhere is deprecated.</p> |
| 243 <hr /> |
| 244 |
| 245 <h2 id="msg_observe_3"><code>@observable</code> not supported on classes <a href
="#msg_observe_3">#3</a></h2> |
| 246 <p>Only instance fields on <code>Observable</code> classes can be observable, |
| 247 and you must explicitly annotate each observable field as <code>@observable</cod
e>.</p> |
| 248 <p>Support for using the <code>@observable</code> annotation in libraries, class
es, and |
| 249 elsewhere is deprecated.</p> |
| 250 <hr /> |
| 251 |
| 252 <h2 id="msg_observe_4"><code>@observable</code> not supported on static fields <
a href="#msg_observe_4">#4</a></h2> |
| 253 <p>Only instance fields on <code>Observable</code> classes can be observable, |
| 254 and you must explicitly annotate each observable field as <code>@observable</cod
e>.</p> |
| 255 <p>Support for using the <code>@observable</code> annotation in libraries, class
es, and |
| 256 elsewhere is deprecated.</p> |
| 257 <hr /> |
| 258 |
| 259 <h2 id="msg_observe_5"><code>@observable</code> field not in an <code>Observable
</code> class <a href="#msg_observe_5">#5</a></h2> |
| 260 <p>Only instance fields on <code>Observable</code> classes can be observable, |
| 261 and you must explicitly annotate each observable field as <code>@observable</cod
e>.</p> |
| 262 <p>Support for using the <code>@observable</code> annotation in libraries, class
es, and |
| 263 elsewhere is deprecated.</p> |
| 264 <hr /><h1>Messages from package <code>polymer</code></h1> |
| 265 <hr /> |
| 266 |
| 267 <h2 id="msg_polymer_1">Import not found <a href="#msg_polymer_1">#1</a></h2> |
| 268 <p>An HTML import seems to be broken. This could be because the file doesn't exi
st |
| 269 or because the link URL is incorrect.</p> |
| 270 <hr /> |
| 271 |
| 272 <h2 id="msg_polymer_2">Duplicate definition <a href="#msg_polymer_2">#2</a></h2> |
| 273 <p>Custom element names are global and can only be defined once. Some common |
| 274 reasons why you might get two definitions:</p><ul><li>Two different elements are
declared with the same name.</li><li> |
| 275 <p>A single HTML file defining an element, has been imported using two different |
| 276 URLs.</p></li></ul> |
| 277 <hr /> |
| 278 |
| 279 <h2 id="msg_polymer_3">Missing import to polymer.html <a href="#msg_polymer_3">#
3</a></h2> |
| 280 <p>Starting with polymer 0.11.0, each file that uses the definition |
| 281 of polymer-element must import it either directly or transitively.</p> |
| 282 <hr /> |
| 283 |
| 284 <h2 id="msg_polymer_4">Invalid import inside <polymer-element> <a href="#msg_
polymer_4">#4</a></h2> |
| 285 <p>HTML imports are expected at the top of each document, outside of any |
| 286 polymer-element definitions. The polymer build process combines all your HTML |
| 287 files together so you can deploy a single HTML file with your application. This |
| 288 build process ignores imports that appear to be in the wrong location.</p> |
| 289 <hr /> |
| 290 |
| 291 <h2 id="msg_polymer_5">Missing call to <code>initPolymer()</code> <a href="#msg_
polymer_5">#5</a></h2> |
| 292 <p>Your application entry point didn't have any Dart script tags, so it's missin
g |
| 293 some initialization needed for polymer.dart.</p> |
| 294 <hr /> |
| 295 |
| 296 <h2 id="msg_polymer_6">Script tags with experimental bootstrap <a href="#msg_pol
ymer_6">#6</a></h2> |
| 297 <p>This experimental feature is no longer supported.</p> |
| 298 <hr /> |
| 299 |
| 300 <h2 id="msg_polymer_7">Multiple Dart script tags per document <a href="#msg_poly
mer_7">#7</a></h2> |
| 301 <p>Dartium currently allows only one script tag per document. Any |
| 302 additional script tags might be ignored or result in an error. This will |
| 303 likely change in the future, but for now, combine the script tags together into |
| 304 a single Dart library.</p> |
| 305 <hr /> |
| 306 |
| 307 <h2 id="msg_polymer_8">Imports before script tags <a href="#msg_polymer_8">#8</a
></h2> |
| 308 <p>It is good practice to put all your HTML imports at the beginning of the |
| 309 document, above any Dart script tags. Today, the execution of Dart script tags |
| 310 is not synchronous in Dartium, so the difference is not noticeable. However, |
| 311 Dartium that will eventually change and make the timing of script tags execution |
| 312 match how they are in JavaScript. At that point the order of your imports with |
| 313 respect to script tags will be important. Following the practice of putting |
| 314 imports first protects your app from a future breaking change in this respect.</
p> |
| 315 <hr /> |
| 316 |
| 317 <h2 id="msg_polymer_9">Missing href on a <code><link></code> tag <a href="
#msg_polymer_9">#9</a></h2> |
| 318 <p>All <code><link></code> tags should have a valid URL to a resource.</p> |
| 319 <hr /> |
| 320 |
| 321 <h2 id="msg_polymer_10"><code><element></code> is deprecated <a href="#msg
_polymer_10">#10</a></h2> |
| 322 <p>Long ago <code><polymer-element></code> used to be called <code><ele
ment></code>. You probably ran |
| 323 into this error if you were migrating code that was written on a very early |
| 324 version of polymer.</p> |
| 325 <hr /> |
| 326 |
| 327 <h2 id="msg_polymer_11">Definition of a custom element not found <a href="#msg_p
olymer_11">#11</a></h2> |
| 328 <p>The polymer build was not able to find the definition of a custom element. Th
is |
| 329 can happen if an element is defined with a <code><polymer-element></code>
tag, but you are |
| 330 missing an HTML import or the import link is incorrect.</p> |
| 331 <p>This warning can also be a false alarm. For instance, when an element is defi
ned |
| 332 programatically using <code>document.registerElement</code>. In that case the po
lymer build |
| 333 will not be able to see the definition and will produce this warning.</p> |
| 334 <hr /> |
| 335 |
| 336 <h2 id="msg_polymer_12">Empty script tag <a href="#msg_polymer_12">#12</a></h2> |
| 337 <p>Script tags should either have a <code>src</code> attribute or a non-empty bo
dy.</p> |
| 338 <hr /> |
| 339 |
| 340 <h2 id="msg_polymer_13">Expected Dart mime-type <a href="#msg_polymer_13">#13</a
></h2> |
| 341 <p>You seem to have a <code>.dart</code> extension on a script tag, but the mime
-type |
| 342 doesn't match <code>application/dart</code>.</p> |
| 343 <hr /> |
| 344 |
| 345 <h2 id="msg_polymer_14">Expected Dart file extension <a href="#msg_polymer_14">#
14</a></h2> |
| 346 <p>You are using the <code>application/dart</code> mime-type on a script tag, so |
| 347 the URL to the script source URL should have a <code>.dart</code> extension.</p> |
| 348 <hr /> |
| 349 |
| 350 <h2 id="msg_polymer_15">Script with both src and inline text <a href="#msg_polym
er_15">#15</a></h2> |
| 351 <p>You have a script tag that includes both a <code>src</code> attribute and inl
ine script |
| 352 text. You must choose one or the other.</p> |
| 353 <hr /> |
| 354 |
| 355 <h2 id="msg_polymer_16">Incorrect instantiation: missing base tag in instantiati
on <a href="#msg_polymer_16">#16</a></h2> |
| 356 <p>When you declare that a custom element extends from a base tag, for example:<
/p> |
| 357 <pre><code><polymer-element name="my-example" extends="ul"> |
| 358 </code></pre> |
| 359 <p>or:</p> |
| 360 <pre><code><polymer-element name="my-example2" extends="ul"> |
| 361 <polymer-element name="my-example" extends="my-example2"> |
| 362 </code></pre> |
| 363 <p>You should instantiate <code>my-example</code> by using this syntax:</p> |
| 364 <pre><code><ul is="my-example"> |
| 365 </code></pre> |
| 366 <p>And not:</p> |
| 367 <pre><code><my-example> |
| 368 </code></pre> |
| 369 <p>Only elements that don't extend from existing HTML elements are created using |
| 370 the latter form.</p> |
| 371 <p>This is because browsers first create the base element, and then upgrade it t
o |
| 372 have the extra functionality of your custom element. In the example above, using |
| 373 <code><ul></code> tells the browser which base type it must create before |
| 374 doing the upgrade.</p> |
| 375 <hr /> |
| 376 |
| 377 <h2 id="msg_polymer_17">Incorrect instantiation: extra <code>is</code> attribute
or missing <code>extends</code> in declaration <a href="#msg_polymer_17">#17</a
></h2> |
| 378 <p>Creating a custom element using the syntax:</p> |
| 379 <pre><code><ul is="my-example"> |
| 380 </code></pre> |
| 381 <p>means that the declaration of <code>my-example</code> extends transitively fr
om <code>ul</code>. This |
| 382 error message is shown if the definition of <code>my-example</code> doesn't decl
are this |
| 383 extension. It might be that you no longer extend from the base element, in which |
| 384 case the fix is to change the instantiation to:</p> |
| 385 <pre><code><my-example> |
| 386 </code></pre> |
| 387 <p>Another possibility is that the declaration needs to be fixed to include the |
| 388 <code>extends</code> attribute, for example:</p> |
| 389 <pre><code><polymer-element name="my-example" extends="ul"> |
| 390 </code></pre> |
| 391 <hr /> |
| 392 |
| 393 <h2 id="msg_polymer_18">Incorrect instantiation: base tag seems wrong <a href="#
msg_polymer_18">#18</a></h2> |
| 394 <p>It seems you have a declaration like:</p> |
| 395 <pre><code><polymer-element name="my-example" extends="div"> |
| 396 </code></pre> |
| 397 <p>but an instantiation like:</p> |
| 398 <pre><code><span is="my-example"> |
| 399 </code></pre> |
| 400 <p>Both the declaration and the instantiation need to match on the base type. So |
| 401 either the instantiation needs to be fixed to be more like:</p> |
| 402 <pre><code><span is="my-example"> |
| 403 </code></pre> |
| 404 <p>or the declaration should be fixed to be like:</p> |
| 405 <pre><code><polymer-element name="my-example" extends="span"> |
| 406 </code></pre> |
| 407 <hr /> |
| 408 |
| 409 <h2 id="msg_polymer_19">No dashes allowed in custom attributes <a href="#msg_pol
ymer_19">#19</a></h2> |
| 410 <p>Polymer used to recognize attributes with dashes like <code>my-name</code> an
d convert them |
| 411 to match properties where dashes were removed, and words follow the camelCase |
| 412 style (for example <code>myName</code>). This feature is no longer available. No
w simply |
| 413 use the same name as the property.</p> |
| 414 <p>Because HTML attributes are case-insensitive, you can also write the name of |
| 415 your property entirely in lowercase. Just be sure that your custom-elements |
| 416 don't declare two properties with the same name but different capitalization.</p
> |
| 417 <hr /> |
| 418 |
| 419 <h2 id="msg_polymer_20">Event handlers not supported here <a href="#msg_polymer_
20">#20</a></h2> |
| 420 <p>Bindings of the form <code>{{ }}</code> are supported inside <code><templa
te></code> nodes, even outside |
| 421 of <code><polymer-element></code> declarations. However, those bindings on
ly support binding |
| 422 values into the content of a node or an attribute.</p> |
| 423 <p>Inline event handlers of the form <code>on-click="{{method}}"</code> are a sp
ecial feature |
| 424 of polymer elements, so they are only supported inside <code><polymer-element
></code> |
| 425 definitions.</p> |
| 426 <hr /> |
| 427 |
| 428 <h2 id="msg_polymer_21">No expressions allowed in event handler bindings <a href
="#msg_polymer_21">#21</a></h2> |
| 429 <p>Unlike data bindings, event handler bindings of the form <code>on-click="{{me
thod}}"</code> |
| 430 are not evaluated as expressions. They are meant to just contain a simple name |
| 431 that resolves to a method in your polymer element's class definition.</p> |
| 432 <hr /> |
| 433 |
| 434 <h2 id="msg_polymer_22">Nested polymer element definitions not allowed <a href="
#msg_polymer_22">#22</a></h2> |
| 435 <p>Because custom element names are global, there is no need to have a |
| 436 <code><polymer-element></code> definition nested within a <code><polyme
r-element></code>. If you have |
| 437 a definition inside another, move the second definition out.</p> |
| 438 <p>You might see this error if you have an HTML import within a polymer element. |
| 439 You should be able to move the import out of the element definition.</p> |
| 440 <hr /> |
| 441 |
| 442 <h2 id="msg_polymer_23">Polymer element definitions without a name <a href="#msg
_polymer_23">#23</a></h2> |
| 443 <p>Polymer element definitions must have a name. You can include a name by using |
| 444 the <code>name</code> attribute in <code><polymer-element></code> for exam
ple:</p> |
| 445 <pre><code><polymer-element name="my-example"> |
| 446 </code></pre> |
| 447 <hr /> |
| 448 |
| 449 <h2 id="msg_polymer_24">Custom element name missing a dash <a href="#msg_polymer
_24">#24</a></h2> |
| 450 <p>Custom element names must have a dash (<code>-</code>) and can't be any of th
e following |
| 451 reserved names:</p><ul><li><code>annotation-xml</code></li><li><code>color-profi
le</code></li><li><code>font-face</code></li><li><code>font-face-src</code></li>
<li><code>font-face-uri</code></li><li><code>font-face-format</code></li><li><co
de>font-face-name</code></li><li><code>missing-glyph</code></li></ul> |
| 452 <hr /> |
| 453 |
| 454 <h2 id="msg_polymer_25">Error while inlining an import <a href="#msg_polymer_25"
>#25</a></h2> |
| 455 <p>An error occurred while inlining an import in the polymer build. This is ofte
n |
| 456 the result of a broken HTML import.</p> |
| 457 <hr /> |
| 458 |
| 459 <h2 id="msg_polymer_26">Error while inlining a stylesheet <a href="#msg_polymer_
26">#26</a></h2> |
| 460 <p>An error occurred while inlining a stylesheet in the polymer build. This is |
| 461 often the result of a broken URL in a <code><link rel="stylesheet" href="..."
></code>.</p> |
| 462 <hr /> |
| 463 |
| 464 <h2 id="msg_polymer_27">URL to a script file might be incorrect <a href="#msg_po
lymer_27">#27</a></h2> |
| 465 <p>An error occurred trying to read a script tag on a given URL. This is often t
he |
| 466 result of a broken URL in a <code><script src="..."></code>.</p> |
| 467 <hr /> |
| 468 |
| 469 <h2 id="msg_polymer_28">Attribute missing "_" prefix <a href="#msg_polymer_28">#
28</a></h2> |
| 470 <p>Not all browsers support bindings to certain attributes, especially URL |
| 471 attributes. Some browsers might sanitize attributes and result in an |
| 472 incorrect value. For this reason polymer provides a special set of attributes |
| 473 that let you bypass any browser internal attribute validation. The name of the |
| 474 attribute is the same as the original attribute, but with a leading underscore. |
| 475 For example, instead of writing:</p> |
| 476 <pre><code><img src="{{binding}}"> |
| 477 </code></pre> |
| 478 <p>you can write:</p> |
| 479 <pre><code><img _src="{{binding}}"> |
| 480 </code></pre> |
| 481 <p>For more information, see <a href="http://goo.gl/5av8cU">http://goo.gl/5av8cU
</a>.</p> |
| 482 <hr /> |
| 483 |
| 484 <h2 id="msg_polymer_29">Attribute with extra "_" prefix <a href="#msg_polymer_29
">#29</a></h2> |
| 485 <p>A special attribute exists to support bindings on URL attributes. For example
, |
| 486 this correctly binds the <code>src</code> attribute in an image:</p> |
| 487 <pre><code><img _src="{{binding}}"> |
| 488 </code></pre> |
| 489 <p>However, this special <code>_src</code> attribute is only available for bindi
ngs. If you |
| 490 just have a URL, use the normal <code>src</code> attribute instead.</p> |
| 491 <hr /> |
| 492 |
| 493 <h2 id="msg_polymer_30">Internal error: don't know how to include a URL <a href=
"#msg_polymer_30">#30</a></h2> |
| 494 <p>Sorry, you just ran into a bug in the polymer transformer code. Please file a |
| 495 bug at <a href="http://dartbug.com/new">http://dartbug.com/new</a> including, if
possible, some example code that |
| 496 can help the team reproduce the issue.</p> |
| 497 <hr /> |
| 498 |
| 499 <h2 id="msg_polymer_31">Internal error: phases run out of order <a href="#msg_po
lymer_31">#31</a></h2> |
| 500 <p>Sorry, you just ran into a bug in the polymer transformer code. Please file a |
| 501 bug at <a href="http://dartbug.com/new">http://dartbug.com/new</a> including, if
possible, some example code that |
| 502 can help the team reproduce the issue.</p> |
| 503 <hr /> |
| 504 |
| 505 <h2 id="msg_polymer_32"><code>@CustomTag</code> used on a private class <a href=
"#msg_polymer_32">#32</a></h2> |
| 506 <p>The <code>@CustomTag</code> annotation is currently only supported on public
classes. If |
| 507 you need to register a custom element whose implementation is a private class |
| 508 (that is, a class whose name starts with <code>_</code>), you can still do so by
invoking |
| 509 <code>Polymer.register</code> within a public method marked with <code>@initMeth
od</code>.</p> |
| 510 <hr /> |
| 511 |
| 512 <h2 id="msg_polymer_33"><code>@initMethod</code> is on a private function <a hre
f="#msg_polymer_33">#33</a></h2> |
| 513 <p>The <code>@initMethod</code> annotation is currently only supported on public
top-level |
| 514 functions.</p> |
| 515 <hr /> |
| 516 |
| 517 <h2 id="msg_polymer_34">Missing argument in annotation <a href="#msg_polymer_34"
>#34</a></h2> |
| 518 <p>The annotation expects one argument, but the argument was not provided.</p> |
| 519 <hr /> |
| 520 |
| 521 <h2 id="msg_polymer_35">Invalid argument in annotation <a href="#msg_polymer_35"
>#35</a></h2> |
| 522 <p>The polymer transformer was not able to extract a constant value for the |
| 523 annotation argument. This can happen if your code is currently in a state that |
| 524 can't be analyzed (for example, it has parse errors) or if the expression passed |
| 525 as an argument is invalid (for example, it is not a compile-time constant).</p> |
| 526 <hr /> |
| 527 |
| 528 <h2 id="msg_polymer_36">No polymer initializers found <a href="#msg_polymer_36">
#36</a></h2> |
| 529 <p>No polymer initializers were found. Make sure to either |
| 530 annotate your polymer elements with @CustomTag or include a |
| 531 top level method annotated with @initMethod that registers your |
| 532 elements. Both annotations are defined in the polymer library ( |
| 533 package:polymer/polymer.dart).</p> |
| 534 <hr /> |
| 535 |
| 536 <h2 id="msg_polymer_37">Event bindings with @ are no longer supported <a href="#
msg_polymer_37">#37</a></h2> |
| 537 <p>For a while there was an undocumented feature that allowed users to include |
| 538 expressions in event bindings using the <code>@</code> prefix, for example:</p> |
| 539 <pre><code><div on-click="{{@a.b.c}}"> |
| 540 |
| 541 </code></pre> |
| 542 <p>This feature is no longer supported.</p> |
| 543 <hr /> |
| 544 |
| 545 <h2 id="msg_polymer_38">Private symbol in event handler <a href="#msg_polymer_38
">#38</a></h2> |
| 546 <p>Currently private members can't be used in event handler bindings. So you can
't |
| 547 write:</p> |
| 548 <pre><code><div on-click="{{_method}}"> |
| 549 </code></pre> |
| 550 <p>This restriction might be removed in the future, but for now, you need to mak
e |
| 551 your event handlers public.</p> |
| 552 <hr /> |
| 553 |
| 554 <h2 id="msg_polymer_39">Private symbol in binding expression <a href="#msg_polym
er_39">#39</a></h2> |
| 555 <p>Private members can't be used in binding expressions. For example, you can't |
| 556 write:</p> |
| 557 <pre><code><div>{{a.b._c}}</div> |
| 558 </code></pre> |
| 559 <hr /> |
| 560 |
| 561 <h2 id="msg_polymer_40">A warning was found while parsing the HTML document <a h
ref="#msg_polymer_40">#40</a></h2> |
| 562 <p>The polymer transformer uses a parser that implements the HTML5 spec |
| 563 (<code>html5lib</code>). This message reports a |
| 564 warning that the parser detected.</p> |
| 565 <hr /></body> |
| 566 </html> |
| OLD | NEW |
|---|
Chromium Code Reviews
Issue 513023002:
Step one towards stable error messages with details: (Closed)
Base URL: https://dart.googlecode.com/svn/branches/bleeding_edge/dart