Nate Bosch
ec160b74dc
- Remove some unnecessary details in the README. The SDK constraint duplicates the pubspec, the dependencies section duplicates automatic info on the pub site, and the contributing section duplicates generate Dart/SDK contributing information. The issue link is still useful since it fills in a template, but we should update it to include a label by default. - Use "JavaScript" consistently in docs. - Rephrase some doc comments for clarity. - Drop `new` from examples. - Use consistent single quotes in examples. - Always show the `@JS()` annotation on `library` in examples. - Move the note about factory constructors for anonymous classes to the annotation from the README. - Bump the mimimum SDK to`2.0.0` since there isn't utility in claiming support for older SDKs. There are stale docs remaining in the `varargs.dart` library that should be handled separately by deleting that library. Change-Id: Ida51d2ec3fd31210b55dc91042a0ac1cf77210b8 Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/107450 Commit-Queue: Nate Bosch <nbosch@google.com> Reviewed-by: Nicholas Shahan <nshahan@google.com>
36 lines
1.3 KiB
Dart
36 lines
1.3 KiB
Dart
// Copyright (c) 2015, the Dart project authors. Please see the AUTHORS file
|
|
// for details. All rights reserved. Use of this source code is governed by a
|
|
// BSD-style license that can be found in the LICENSE file.
|
|
|
|
/// Annotations to mark interfaces to JavaScript.
|
|
library js;
|
|
|
|
export 'dart:js' show allowInterop, allowInteropCaptureThis;
|
|
|
|
/// An annotation that indicates a library, class, or member is implemented
|
|
/// directly in JavaScript.
|
|
///
|
|
/// All external members of a class or library with this annotation implicitly
|
|
/// have it as well.
|
|
///
|
|
/// Specifying [name] customizes the JavaScript name to use. By default the
|
|
/// dart name is used. It is not valid to specify a custom [name] for class
|
|
/// instance members.
|
|
class JS {
|
|
final String name;
|
|
const JS([this.name]);
|
|
}
|
|
|
|
class _Anonymous {
|
|
const _Anonymous();
|
|
}
|
|
|
|
/// An annotation that indicates a [JS] annotated class is structural and does
|
|
/// not have a known JavaScript prototype.
|
|
///
|
|
/// A class marked with [anonymous] must have an unnamed factory constructor
|
|
/// with no positional arguments, only named arguments. Invoking the constructor
|
|
/// desugars to creating a JavaScript object literal with name-value pairs
|
|
/// corresponding to the parameter names and values.
|
|
const _Anonymous anonymous = const _Anonymous();
|