TopLevel enables you to template your HTML, CSS, and Javascript at the Top Level like so:
<!doctype html>
<html>
<head>
<script src="YourBrowserCheckCode.js"></script>
<script src="toplevel.js"></script>
<!--% if ( CheckBrowser() == "broken" ) { -->
<link rel="stylesheet" href="broken.css">
<!--% } else { -->
...
<!--% } -->
...
The stylesheet above will never load unless the branch is satisfied.
- This Is Not a solution of injecting stuff after a page load.
- This Is Not a solution of downloading and then removing things from the DOM.
The HTML code including the stylesheet will never be interpreted by the browser unless the function CheckBrowser() returns the string "broken". ... seriously ...
Another example:
<!doctype html>
<html>
<head>
<script src="toplevel.js"></script>
</head>
<body>
<!--% for(var ix = 0; ix < 10; ix++) { -->
<p><!--= ix --></p>
<!--% } -->
</body>
</html>
When you load the page in the browser you will see 10 paragraph blocks with numbers inside of them.
You can put TopLevel stanzas inside of CSS, HTML blocks, even HTML attributes. Take this for example:
<div id="header">
<img src="logo_<!--= (isMobile() ? "50x50" : "200x200") -->.jpg">
</div>
Only one image will load - the right one for the browser.
There will be no broken looking "flash" --- the delivery is smooth and polished.
$(document).ready- CSS selectors
- Underscore
- AMD Loaders, CoffeeScript, Knockout, Angular, Socket.io, Backbone, D3, yes --- all of them.
TopLevel is fast, transparent, and totally rewrites the rules of how you will create webpages.
(1.2 KB minified and 4.4 KB for the development version)
It Works On:
- Chrome
- Firefox
- Safari
- IE
- Opera
- Dolphin
- Seamonkey
- Chromium
They're all in and all the features are there.
Proof? Ok, sure!
You're welcome.
TopLevel takes its templating right from underscore. The functionality is identical with a slight change of syntax.
Template functions can both interpolate variables, using
<!--= … -->, as well as execute arbitrary JavaScript code, with<!--% … -->. If you wish to interpolate a value, and have it be HTML-escaped, use<!--- … -->.
That is to say, a regular HTML comment block with the first character being either =, %, or -. Keep this in mind, and refer to the underscore documentation for further information!
Everything after the <script src="toplevel.js"></script> gets interpreted. If you want TopLevel to use a say, an MV* framework, simply include it before TopLevel, at the top of the HTML file like so:
<!doctype html>
<html>
<head>
... dependencies you want to expose to TopLevel ...
<script src="toplevel.js"></script>
...
- BSD licensed
- Send any pull request!
- File any issue!
- And hit me up on the mailing list!