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 library metadata; | 5 library metadata; |
6 | 6 |
7 /** | 7 /** |
8 * An annotation used to mark a feature as only being supported by a subset | 8 * An annotation used to mark a feature as only being supported by a subset |
9 * of the browsers that Dart supports by default. | 9 * of the browsers that Dart supports by default. |
10 * | 10 * |
11 * If an API is not annotated with [SupportedBrowser] then it is assumed to | 11 * If an API is not annotated with [SupportedBrowser] then it is assumed to |
12 * work on all browsers Dart supports. | 12 * work on all browsers Dart supports. |
13 */ | 13 */ |
14 class SupportedBrowser { | 14 class SupportedBrowser { |
15 static const String CHROME = "Chrome"; | 15 static const String CHROME = "Chrome"; |
16 static const String FIREFOX = "Firefox"; | 16 static const String FIREFOX = "Firefox"; |
17 static const String IE = "Internet Explorer"; | 17 static const String IE = "Internet Explorer"; |
18 static const String OPERA = "Opera"; | 18 static const String OPERA = "Opera"; |
19 static const String SAFARI = "Safari"; | 19 static const String SAFARI = "Safari"; |
20 | 20 |
21 /// The name of the browser. | 21 /// The name of the browser. |
22 final String browserName; | 22 final String browserName; |
| 23 |
23 /// The minimum version of the browser that supports the feature, or null | 24 /// The minimum version of the browser that supports the feature, or null |
24 /// if supported on all versions. | 25 /// if supported on all versions. |
25 final String minimumVersion; | 26 final String minimumVersion; |
26 | 27 |
27 const SupportedBrowser(this.browserName, [this.minimumVersion]); | 28 const SupportedBrowser(this.browserName, [this.minimumVersion]); |
28 } | 29 } |
29 | 30 |
30 | |
31 /** | 31 /** |
32 * An annotation used to mark an API as being experimental. | 32 * An annotation used to mark an API as being experimental. |
33 * | 33 * |
34 * An API is considered to be experimental if it is still going through the | 34 * An API is considered to be experimental if it is still going through the |
35 * process of stabilizing and is subject to change or removal. | 35 * process of stabilizing and is subject to change or removal. |
36 * | 36 * |
37 * See also: | 37 * See also: |
38 * | 38 * |
39 * * [W3C recommendation](http://en.wikipedia.org/wiki/W3C_recommendation) | 39 * * [W3C recommendation](http://en.wikipedia.org/wiki/W3C_recommendation) |
40 */ | 40 */ |
41 class Experimental { | 41 class Experimental { |
42 const Experimental(); | 42 const Experimental(); |
43 } | 43 } |
44 | 44 |
45 | |
46 /** | 45 /** |
47 * Annotation that specifies that a member is editable through generate files. | 46 * Annotation that specifies that a member is editable through generate files. |
48 * | 47 * |
49 * This is used for API generation. | 48 * This is used for API generation. |
50 * | 49 * |
51 * [name] should be formatted as `interface.member`. | 50 * [name] should be formatted as `interface.member`. |
52 */ | 51 */ |
53 class DomName { | 52 class DomName { |
54 final String name; | 53 final String name; |
55 const DomName(this.name); | 54 const DomName(this.name); |
56 } | 55 } |
57 | 56 |
58 | |
59 /** | 57 /** |
60 * Metadata that specifies that that member is editable through generated | 58 * Metadata that specifies that that member is editable through generated |
61 * files. | 59 * files. |
62 */ | 60 */ |
63 class DocsEditable { | 61 class DocsEditable { |
64 const DocsEditable(); | 62 const DocsEditable(); |
65 } | 63 } |
66 | 64 |
67 | |
68 /** | 65 /** |
69 * Annotation that indicates that an API is not expected to change but has | 66 * Annotation that indicates that an API is not expected to change but has |
70 * not undergone enough testing to be considered stable. | 67 * not undergone enough testing to be considered stable. |
71 */ | 68 */ |
72 class Unstable { | 69 class Unstable { |
73 const Unstable(); | 70 const Unstable(); |
74 } | 71 } |
OLD | NEW |