pkg/html_import/README.md - Issue 20414002: Create package for HTML imports

Side by Side Diff

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

Keyboard Shortcuts

	File
u :	up to issue
j / k :	jump to file after / before current file
J / K :	jump to next file with a comment after / before current file
	Side-by-side diff
i :	toggle intra-line diffs
e :	expand all comments
c :	collapse all comments
s :	toggle showing all comments
n / p :	next / previous diff chunk or comment
N / P :	next / previous comment
<Up> / <Down> :	next / previous line

	Issue
u :	up to list of issues
j / k :	jump to patch after / before current patch
o / <Enter> :	open current patch in side-by-side view
i :	open current patch in unified diff view

	Issue List
j / k :	jump to issue after / before current issue
o / <Enter> :	open current issue

Side by Side Diff: pkg/html_import/README.md

Issue 20414002: Create package for HTML imports (Closed) Base URL: https://dart.googlecode.com/svn/branches/bleeding_edge/dart

Patch Set: Created 7 years, 5 months 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 unified diff | Download patch | Annotate | Revision Log

OLD	NEW
(Empty)
	1 # HTML Imports polyfill
	Jennifer Messerly 2013/07/25 19:35:11 link the spec? https://dvcs.w3.org/hg/webcomponent link the spec? https://dvcs.w3.org/hg/webcomponents/raw-file/tip/spec/imports/index.html Siggi Cherem (dart-lang) 2013/07/25 20:48:40 Done. Show quoted text On 2013/07/25 19:35:11, John Messerly wrote: > link the spec? > https://dvcs.w3.org/hg/webcomponents/raw-file/tip/spec/imports/index.html Done.
	2

	3 HTML Imports are a way to include and reuse HTML documents in other HTML documen ts. As `<script>` tags let authors include external Javascript in their pages, i mports let authors load full HTML resources. In particular, imports let authors include [Custom Element](https://github.com/Polymer/CustomElements) definitions from external URLs.
	Jennifer Messerly 2013/07/25 19:34:27 long line :) long line :) Siggi Cherem (dart-lang) 2013/07/25 20:48:40 Done. I copied it over from their file =) Show quoted text On 2013/07/25 19:34:27, John Messerly wrote: > long line :) Done. I copied it over from their file =)
	4

	5

	6 ## Getting Started

	7

	8 Include the `html-imports.js` or `html-imports.min.js` (minified) file in your p roject.

	9

	10 <script src="packages/html_import/html-imports.js"></script>
	Jennifer Messerly 2013/07/25 19:34:27 this should be _? this should be _? Siggi Cherem (dart-lang) 2013/07/25 20:48:40 Their file is actually '-', should I rename it? I Show quoted text On 2013/07/25 19:34:27, John Messerly wrote: > this should be _? Their file is actually '-', should I rename it? If so, maybe I should match the name of the package? html_import.js (or html_import.debug.js) and html_import.min.js Thoughts? Jennifer Messerly 2013/07/25 20:51:08 yeah, I would rename it to match pkg name. After c Show quoted text On 2013/07/25 20:48:40, Siggi Cherem (dart-lang) wrote: > On 2013/07/25 19:34:27, John Messerly wrote: > > this should be _? > > Their file is actually '-', should I rename it? > > If so, maybe I should match the name of the package? html_import.js (or > html_import.debug.js) and html_import.min.js > > Thoughts? yeah, I would rename it to match pkg name. After chatting w/ some folks I changed Shadow DOM to match Dart pkg naming guidelines: shadow_dom IMHO, making changes to conform to expected pkg/asset naming conventions in Dart is totally okay...
	11

	12 `html-imports.js` is the debug loader and uses `document.write` to load addition al modules.

	13 Use the minified version (`html-imports.min.js`) if you need to load the file dy namically.

	14

	15 ## Basic usage

	16

	17 For HTML imports use the `import` relation on a standard `<link>` tag, for examp le:

	18

	19 <link rel="import" href="import-file.html">

	20

	21 ## Polyfill details

	22

	23 You can read more about how the polyfill is implemented in JavaScript here:

	24 <https://github.com/Polymer/HTMLImports/tree/master#polyfill-details>

	25

	26 ## Getting the source code

	27

	28 This package is built from:

	29 <https://github.com/Polymer/HTMLImports/tree/master>

	30

	31 You'll need [node.js](http://nodejs.org) to rebuild the JS file. Use `npm instal l` to

	32 get dependencies and `grunt` to build.

OLD	NEW

« no previous file with comments | « no previous file | pkg/html_import/lib/html-imports.js » ('j') | pkg/html_import/pubspec.yaml » ('J')