| 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 web_components.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 // TODO(jmesserly): rename to webComponentsReady to match the event? | |
| 21 Future customElementsReady = () { | |
| 22 if (_isReady) return new Future.value(); | |
| 23 | |
| 24 // Not upgraded. Wait for the polyfill to fire the WebComponentsReady event. | |
| 25 // Note: we listen on document (not on document.body) to allow this polyfill | |
| 26 // to be loaded in the HEAD element. | |
| 27 return document.on['WebComponentsReady'].first; | |
| 28 }(); | |
| 29 | |
| 30 // Return true if we are using the polyfill and upgrade is complete, or if we | |
| 31 // have native document.register and therefore the browser took care of it. | |
| 32 // Otherwise return false, including the case where we can't find the polyfill. | |
| 33 bool get _isReady { | |
| 34 // If we don't have dart:js, assume things are ready | |
| 35 if (js.context == null) return true; | |
| 36 | |
| 37 var customElements = js.context['CustomElements']; | |
| 38 if (customElements == null) { | |
| 39 // Return true if native document.register, otherwise false. | |
| 40 // (Maybe the polyfill isn't loaded yet. Wait for it.) | |
| 41 return document.supportsRegister; | |
| 42 } | |
| 43 | |
| 44 return customElements['ready'] == true; | |
| 45 } | |
| 46 | |
| 47 /** | |
| 48 * *Note* this API is primarily intended for tests. In other code it is better | |
| 49 * to write it in a style that works with or without the polyfill, rather than | |
| 50 * using this method. | |
| 51 * | |
| 52 * Synchronously trigger evaluation of pending lifecycle events, which otherwise | |
| 53 * need to wait for a [MutationObserver] to signal the changes in the polyfill. | |
| 54 * This method can be used to resolve differences in timing between native and | |
| 55 * polyfilled custom elements. | |
| 56 */ | |
| 57 void customElementsTakeRecords([Node node]) { | |
| 58 var customElements = js.context['CustomElements']; | |
| 59 if (customElements == null) return; | |
| 60 customElements.callMethod('takeRecords', [node]); | |
| 61 } | |
| OLD | NEW |