| OLD | NEW |
| (Empty) |
| 1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file | |
| 2 // for details. All rights reserved. Use of this source code is governed by a | |
| 3 // BSD-style license that can be found in the LICENSE file. | |
| 4 | |
| 5 /** Dart APIs for interacting with the JavaScript Custom Elements polyfill. */ | |
| 6 library custom_element.polyfill; | |
| 7 | |
| 8 import 'dart:async'; | |
| 9 import 'dart:html'; | |
| 10 import 'dart:js' as js; | |
| 11 | |
| 12 /** | |
| 13 * A future that completes once all custom elements in the initial HTML page | |
| 14 * have been upgraded. | |
| 15 * | |
| 16 * This is needed because the native implementation can update the elements | |
| 17 * while parsing the HTML document, but the custom element polyfill cannot, | |
| 18 * so it completes this future once all elements are upgraded. | |
| 19 */ | |
| 20 Future customElementsReady = () { | |
| 21 if (_isReady) return new Future.value(); | |
| 22 | |
| 23 // Not upgraded. Wait for the polyfill to fire the WebComponentsReady event. | |
| 24 // Note: we listen on document (not on document.body) to allow this polyfill | |
| 25 // to be loaded in the HEAD element. | |
| 26 return document.on['WebComponentsReady'].first; | |
| 27 }(); | |
| 28 | |
| 29 // Return true if we are using the polyfill and upgrade is complete, or if we | |
| 30 // have native document.register and therefore the browser took care of it. | |
| 31 // Otherwise return false, including the case where we can't find the polyfill. | |
| 32 bool get _isReady { | |
| 33 // If we don't have dart:js, assume things are ready | |
| 34 if (js.context == null) return true; | |
| 35 | |
| 36 var customElements = js.context['CustomElements']; | |
| 37 if (customElements == null) { | |
| 38 // Return true if native document.register, otherwise false. | |
| 39 // (Maybe the polyfill isn't loaded yet. Wait for it.) | |
| 40 return document.supportsRegister; | |
| 41 } | |
| 42 | |
| 43 return customElements['ready'] == true; | |
| 44 } | |
| 45 | |
| 46 /** | |
| 47 * Loads `custom-elements.debug.js` or `custom-elements.min.js` by adding the | |
| 48 * script tag to the page. Returns a future that completes when custom elements | |
| 49 * are ready (equivalent to [customElementsReady]). | |
| 50 * | |
| 51 * Normally you should add this to your HTML file | |
| 52 * (the Polymer package will do this automatically), but loading dynamically | |
| 53 * can be useful for scenarios such as tests. | |
| 54 */ | |
| 55 Future loadCustomElementPolyfill() { | |
| 56 if (!document.supportsRegister && !js.context.hasProperty('CustomElements')) { | |
| 57 var script = new ScriptElement() | |
| 58 ..src = '/packages/custom_element/custom-elements.debug.js'; | |
| 59 document.head.append(script); | |
| 60 return document.on['WebComponentsReady'].first; | |
| 61 } | |
| 62 return new Future.value(); | |
| 63 } | |
| OLD | NEW |