| OLD | NEW |
| (Empty) |
| 1 Dart JavaScript Interop | |
| 2 =================== | |
| 3 | |
| 4 The js.dart library allows Dart code running in the browser to | |
| 5 manipulate JavaScript running in the same page. It is intended to | |
| 6 allow Dart code to easily interact with third-party JavaScript libraries. | |
| 7 | |
| 8 Warning | |
| 9 ------- | |
| 10 | |
| 11 The use of this library may result in a sizable increase in code size | |
| 12 when compiled to JavaScript, because names cannot be minified. If the | |
| 13 size of the generated JavaScript is a concern, use the [dart:js][dartjs] | |
| 14 library. | |
| 15 | |
| 16 Documentation | |
| 17 ------------- | |
| 18 | |
| 19 See [API documentation][docs]. You should also watch this [video tutorial][video
]. | |
| 20 | |
| 21 Samples | |
| 22 ------- | |
| 23 | |
| 24 See [samples][samples] that demonstrate interaction with JavaScript | |
| 25 code. These include interoperation with the Google Maps JavaScript | |
| 26 library, the Google Visualization JavaScript library, and Twitter's | |
| 27 query API via JSONP. | |
| 28 | |
| 29 Usage | |
| 30 ----- | |
| 31 | |
| 32 The [Dart Editor][editor] now includes pub support. To try out this | |
| 33 library in the editor: | |
| 34 | |
| 35 1. [Update to the latest editor][editor]. | |
| 36 | |
| 37 2. From the "File" menu, open a "New Application" (and make sure "Add | |
| 38 Pub support" is checked). | |
| 39 | |
| 40 3. Add the following to your pubspec.yaml: | |
| 41 | |
| 42 dependencies: | |
| 43 js: any | |
| 44 | |
| 45 | |
| 46 4. Under the "Tools" menu, run "Pub Install". | |
| 47 | |
| 48 5. Try the following test Dart file: | |
| 49 | |
| 50 import 'package:js/js.dart' as js; | |
| 51 | |
| 52 void main() { | |
| 53 js.context.alert('Hello from Dart via JS'); | |
| 54 } | |
| 55 | |
| 56 6. Add the script to your HTML page: | |
| 57 | |
| 58 <script src="packages/browser/dart.js"></script> | |
| 59 <script src="packages/browser/interop.js"></script> | |
| 60 | |
| 61 Running Tests | |
| 62 ------------- | |
| 63 | |
| 64 First, use the [Pub Package Manager][pub] to install dependencies: | |
| 65 | |
| 66 pub install | |
| 67 | |
| 68 To run browser tests on [Dartium], simply open **test/browser_tests.html** | |
| 69 in Dartium. | |
| 70 | |
| 71 To run browser tests using JavaScript in any modern browser, first use the | |
| 72 following command to compile to JavaScript: | |
| 73 | |
| 74 dart2js -otest/browser_tests.dart.js test/browser_tests.dart | |
| 75 | |
| 76 and then open **test/browser_tests.html** in any browser. | |
| 77 | |
| 78 [d]: http://www.dartlang.org | |
| 79 [mb]: http://www.dartlang.org/support/faq.html#what-browsers-supported | |
| 80 [pub]: http://www.dartlang.org/docs/pub-package-manager/ | |
| 81 [Dartium]: http://www.dartlang.org/tools/dartium/ | |
| 82 [docs]: http://dart-lang.github.com/js-interop | |
| 83 [samples]: http://dart-lang.github.com/js-interop/example | |
| 84 [editor]: http://www.dartlang.org/docs/editor/getting-started/ | |
| 85 [video]: http://www.youtube.com/watch?v=QFuCFUd2Zsw | |
| 86 [dartjs]: http://api.dartlang.org/docs/channels/stable/latest/dart_js.html | |
| OLD | NEW |