| OLD | NEW |
| 1 // Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file |
| 2 // for details. All rights reserved. Use of this source code is governed by a | 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. | 3 // BSD-style license that can be found in the LICENSE file. |
| 4 | 4 |
| 5 /** | 5 /** |
| 6 * This library exports all of the commonly used functions and types for | 6 * This library exports all of the commonly used functions and types for |
| 7 * building UI's. It is equivalent to the following imports: | 7 * building UI's. It is equivalent to the following imports: |
| 8 * | 8 * |
| 9 * import 'package:web_ui/observe.dart'; | 9 * import 'package:web_ui/observe.dart'; |
| 10 * import 'package:web_ui/safe_html.dart'; | 10 * import 'package:web_ui/safe_html.dart'; |
| (...skipping 100 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 111 * Note that [root] will be a [ShadowRoot] if the browser supports Shadow DOM. | 111 * Note that [root] will be a [ShadowRoot] if the browser supports Shadow DOM. |
| 112 */ | 112 */ |
| 113 void created() {} | 113 void created() {} |
| 114 | 114 |
| 115 /** Invoked when this component gets inserted in the DOM tree. */ | 115 /** Invoked when this component gets inserted in the DOM tree. */ |
| 116 void inserted() {} | 116 void inserted() {} |
| 117 | 117 |
| 118 /** Invoked when this component is removed from the DOM tree. */ | 118 /** Invoked when this component is removed from the DOM tree. */ |
| 119 void removed() {} | 119 void removed() {} |
| 120 | 120 |
| 121 // TODO(jmesserly): how do we implement this efficiently? | |
| 122 // See https://github.com/dart-lang/web-ui/issues/37 | |
| 123 /** Invoked when any attribute of the component is modified. */ | |
| 124 void attributeChanged(String name, String oldValue) {} | |
| 125 | |
| 126 | |
| 127 /** | 121 /** |
| 128 * **Note**: This is an implementation helper and should not need to be called | 122 * **Note**: This is an implementation helper and should not need to be called |
| 129 * from your code. | 123 * from your code. |
| 130 * | 124 * |
| 131 * If [ShadowRoot.supported] or [useShadowDom] is false, this distributes | 125 * If [ShadowRoot.supported] or [useShadowDom] is false, this distributes |
| 132 * children to the insertion points of the emulated ShadowRoot. | 126 * children to the insertion points of the emulated ShadowRoot. |
| 133 * This is an implementation helper and should not need to be called from your | 127 * This is an implementation helper and should not need to be called from your |
| 134 * code. | 128 * code. |
| 135 * | 129 * |
| 136 * This is an implementation of [composition][1] and [rendering][2] from the | 130 * This is an implementation of [composition][1] and [rendering][2] from the |
| (...skipping 202 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 339 * traversal. | 333 * traversal. |
| 340 */ | 334 */ |
| 341 bool useShadowDom = false; | 335 bool useShadowDom = false; |
| 342 | 336 |
| 343 bool get _realShadowRoot => useShadowDom && ShadowRoot.supported; | 337 bool get _realShadowRoot => useShadowDom && ShadowRoot.supported; |
| 344 | 338 |
| 345 /** | 339 /** |
| 346 * Set this to the [Element] to be used as the root for the Web UI app. | 340 * Set this to the [Element] to be used as the root for the Web UI app. |
| 347 */ | 341 */ |
| 348 Element webUIRoot = document.body; | 342 Element webUIRoot = document.body; |
| OLD | NEW |