OLD | NEW |
| (Empty) |
1 // Copyright (c) 2014, 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 /// Provides support for associating a Dart type for Javascript Custom Elements. | |
6 /// This will not work unless `dart_support.js` is loaded. | |
7 library web_components.interop; | |
8 | |
9 import 'dart:html' show document, Element; | |
10 import 'dart:js' show JsObject, JsFunction; | |
11 | |
12 final _doc = new JsObject.fromBrowserObject(document); | |
13 | |
14 /// Returns whether [registerDartType] is supported, which requires to have | |
15 /// `dart_support.js` already loaded in the page. | |
16 bool get isSupported => _doc.hasProperty('_registerDartTypeUpgrader'); | |
17 | |
18 /// Watches when Javascript custom elements named [tagName] are created and | |
19 /// associates the created element with the given [dartType]. Only one Dart type | |
20 /// can be registered for a given tag name. | |
21 void registerDartType(String tagName, Type dartType, {String extendsTag}) { | |
22 if (!isSupported) { | |
23 throw new UnsupportedError("Couldn't find " | |
24 "`document._registerDartTypeUpgrader`. Please make sure that " | |
25 "`packages/web_components/interop_support.html` is loaded and " | |
26 "available before calling this function."); | |
27 } | |
28 | |
29 var upgrader = | |
30 document.createElementUpgrader(dartType, extendsTag: extendsTag); | |
31 | |
32 // Unfortunately the dart:html upgrader will throw on an already-upgraded | |
33 // element, so we need to duplicate the type check to prevent that. | |
34 // An element can be upgraded twice if it extends another element and calls | |
35 // createdCallback on the superclass. Since that's a valid use case we must | |
36 // wrap at both levels, and guard against it here. | |
37 upgradeElement(e) { | |
38 if (e.runtimeType != dartType) upgrader.upgrade(e); | |
39 } | |
40 | |
41 _doc.callMethod('_registerDartTypeUpgrader', [tagName, upgradeElement]); | |
42 } | |
43 | |
44 /// This function is mainly used to save resources. By default, we save a log of | |
45 /// elements that are created but have no Dart type associated with them. This | |
46 /// is so we can upgrade them as soon as [registerDartType] is invoked. This | |
47 /// function can be called to indicate that we no longer are interested in | |
48 /// logging element creations and that it is sufficient to only upgrade new | |
49 /// elements as they are being created. Typically this is called after the last | |
50 /// call to [registerDartType] or as soon as you know that no element will be | |
51 /// created until the call to [registerDartType] is made. | |
52 void onlyUpgradeNewElements() => _doc.callMethod('_onlyUpgradeNewElements'); | |
OLD | NEW |