pkg/web_components/README.md - Issue 819653002: delete web_components

Unified Diff: pkg/web_components/README.md

Issue 819653002: delete web_components (Closed) Base URL: https://dart.googlecode.com/svn/branches/bleeding_edge/dart

Patch Set: Created 6 years ago

Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.

Jump to:

View side-by-side diff with in-line comments

Download patch

Index: pkg/web_components/README.md

diff --git a/pkg/web_components/README.md b/pkg/web_components/README.md

deleted file mode 100644

index a1ef1b7e22c82897221859e5372fa6d1a0c3dce6..0000000000000000000000000000000000000000

--- a/pkg/web_components/README.md

+++ /dev/null

@@ -1,69 +0,0 @@

-# Web Components

-This package has the polyfills for

-[Shadow DOM](http://www.polymer-project.org/platform/shadow-dom.html),

-[Custom Elements](http://www.polymer-project.org/platform/custom-elements.html),

-and [HTML Imports](http://www.polymer-project.org/platform/html-imports.html).

-These features exist in dart:html, for example

-[Element.reateShadowRoot](https://api.dartlang.org/apidocs/channels/stable/#dart-dom-html.Element@id_createShadowRoot)

-and [Document.register](https://api.dartlang.org/apidocs/channels/stable/#dart-dom-html.HtmlDocument@id_register).

-However those APIs are not supported on all browsers yet unless you

-load the polyfills, as indicated below.

-## Getting started

-Include the polyfills in your HTML `<head>` to enable Shadow DOM:

-```html

-<script src="packages/web_components/webcomponents.min.js"></script>

-<script src="packages/web_components/dart_support.js"></script>

-```

-You can also use an unminified version for development:

-```html

-<script src="packages/web_components/webcomponents.js"></script>

-<script src="packages/web_components/dart_support.js"></script>

-```

-Because the Shadow DOM polyfill does extensive DOM patching, webcomponents.js

-should be included **before** other script tags. Be sure to include

-dart_support.js too, it is required for the Shadow DOM polyfill to work with

-[dart2js](https://www.dartlang.org/docs/dart-up-and-running/contents/ch04-tools-dart2js.html).

-## Custom Elements

-Custom Elements let authors define their own elements. Authors associate

-JavaScript or Dart code with custom tag names, and then use those custom tag

-names as they would any standard tag.

-For example, after registering a special kind of button called `super-button`,

-use the super button just like this:

-```html

-<super-button></super-button>

-```

-Custom elements are still elements. We can create, use, manipulate, and compose

-them just as easily as any standard `<div>` or `<span>` today.

-See the Polymer [Custom Elements page](http://www.polymer-project.org/platform/custom-elements.html)

-for more information.

-## Shadow DOM

-Shadow DOM is designed to provide encapsulation by hiding DOM subtrees under

-shadow roots. It provides a method of establishing and maintaining functional

-boundaries between DOM trees and how these trees interact with each other within

-a document, thus enabling better functional encapsulation within the DOM.

-See the Polymer [Shadow DOM page](http://www.polymer-project.org/platform/shadow-dom.html)

-for more information.

-## Hacking on this package

-The `webcomponents.*` files in this package are developed

-[here](https://github.com/Polymer/webcomponentsjs). Follow the instructions

-there for how to build a new release and then copy the files into this package.

« no previous file with comments | « pkg/web_components/PATENTS ('k') | pkg/web_components/lib/build.log » ('j') | no next file with comments »