lining.js

<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Lining.js</title> <meta name="Keywords" content="lining.js,typography,line,javascript,css"> <meta name="Description" content="An easy to use javascript plugin offers you complete DOWN-TO-THE-LINE control for radical web typography."> <link href='http://fonts.googleapis.com/css?family=Roboto+Slab|Calligraffitti|Inconsolata|Dancing+Script|Handlee|Allerta+Stencil' rel='stylesheet' type='text/css'> <link rel="stylesheet" href="assets/normalize.css" /> <link rel="stylesheet" href="assets/index.css" /> <link rel="stylesheet" href="assets/prism.css" /> <script src="build/lining.min.js"></script> <script src="build/lining.effect.min.js"></script> </head> <body> <a href="https://github.com/zmmbreeze/lining.js" target="_blank"><img style="position:fixed;top:0;right:0;z-index:999;border:0;" src="https://camo.githubusercontent.com/38ef81f8aca64bb9a64448d0d70f1308ef5341ab/68747470733a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f6461726b626c75655f3132313632312e706e67" alt="Fork on GitHub" data-canonical-src="https://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png"></a> <div class="main"> <div class="center"> <div class="v-center"> <h1>Lining.js</h1> <p>In CSS we already have the selector <code>::first-line</code> to apply style on the first line of element. But there is no selector like <code>::nth-line()</code>, <code>::nth-last-line()</code> or even <code>::last-line</code>. Then I read an article <a href="http://css-tricks.com/a-call-for-nth-everything/" target="_blank">A Call for ::nth-everything</a> from CSS tricks. <code>::nth-line()</code> is actually really useful in some situation.</p> <p>There comes <strong><a href="https://github.com/zmmbreeze/lining.js" target="_blank">Lining.js</a></strong>. It offers you complete <strong>down-to-the-line</strong> control like this:</p> <pre><code class="language-markup"><div class="poem" data-lining>Some text...</div> <style> .poem .line[first] { /* `.poem::first-line`*/ } .poem .line[last] { /* `.poem::last-line` */ } .poem .line[index="5"] { /* `.poem::nth-line(5)` */ } .poem .line:nth-of-type(-n+2) { /* `.poem::nth-line(-n+2)` */ } .poem .line:nth-last-of-type(2n) { /* `.poem:::nth-last-line(2n)` */ } </style> <script src="YOUR_PATH/lining.min.js"></script> </code></pre> <p>Supported browsers <img src="assets/chrome_256x256.png" width="24" height="24" alt="Lastest Chrome" title="Latest Chrome"> <img src="assets/firefox_256x256.png" width="24" height="24" alt="Lastest Firefox" title="Latest Firefox"> <img src="assets/safari_256x256.png" width="24" height="24" alt="Lastest Safari" title="Latest Safari"> <img src="assets/safari-ios_256x256.png" width="24" height="24" alt="Lastest Mobile Safari" title="Lastest Mobile Safari"> <img src="assets/opera_256x256.png" width="24" height="24" alt="Lastest Opera" title="Lastest Opera"> </p> </div> <a href="#demo-1" class="tip">DEMO</a> </div> </div> <div class="demo demo-1" id="demo-1"> <div class="center"> <div class="v-center"> <div data-lining class="poem preview"> As soon as wolf began to feel that he would like a decent meal, He went and knocked on Grandma's door.<br/> When Grandma opened it, she saw<br/> The sharp white teeth, the horrid grin,<br/> And Wolfie said, 'May I come in?'<br/> Poor Grandmamma was terrified,<br/> 'He's going to eat me up!' she cried. </div> <div class="code"> <pre><code class="language-css">.poem { line-height: 40px; font-size: 32px; font-family: 'Dancing Script' serif; } .poem .line:nth-of-type(-n+2) { font-size: 42px; color: #DA4453; }</code></pre> </div> </div> <a class="switcher" data-do="toggle" data-status="0" href="###">SHOW CODE</a> <a href="#demo-2" class="tip">NEXT</a> </div> </div> <div class="demo demo-2" id="demo-2"> <div class="center"> <div class="v-center"> <div data-lining class="fadeout preview"> If you want to view paradise<br/> Simply look around and view it<br/> Anything you want to, do it<br/> Want to change the world,<br/> there's nothing to it<br/> There is no life I know<br/> To compare with<br/> pure imagination </div> <div class="code"> <pre><code class="language-css">.fadeout { font-size: 36px; line-height: 36px; color: hsla(354, 67%, 46%, 1); font-family: 'Handlee' serif; } .fadeout .line:nth-last-of-type(3) { color: hsla(354, 67%, 55%, 1); font-size: 80%; } .fadeout .line:nth-last-of-type(2) { color: hsla(354, 67%, 60%, 1); font-size: 70%; } .fadeout .line:nth-last-of-type(1) { color: hsla(354, 67%, 65%, 1); font-size: 60% }</code></pre> </div> </div> <a class="switcher" data-do="toggle" data-status="0" href="###">SHOW CODE</a> <a href="#demo-3" class="tip">NEXT</a> </div> </div> <div class="demo demo-3" id="demo-3"> <div class="center"> <div class="v-center"> <div data-lining class="linenumber preview"> <h3>What is typography</h3> <p>Typography (from the Greek words τύπος typos "form" and γράφειν graphein "to write") is the art and technique of arranging type to make written language most appealing to learning and recognition. The arrangement of type involves selecting typefaces, point size, line length, line-spacing (leading), letter-spacing (tracking), and adjusting the space within letters pairs (kerning[2]). Type design is a closely related craft, sometimes considered part of typography; most typographers do not design typefaces, and some type designers do not consider themselves typographers. In modern times, typography has been put in film, television and online broadcasts to add emotion to communication.<br/> From <a href="http://en.wikipedia.org/wiki/Typography" target="_blank">Wikipedia</a>.</P> </div> <div class="code"> <pre><code class="language-css">.linenumber .line { position: relative; margin-left: 32px; /* 16 * 2*/ } .linenumber .line:before { content: attr(index) '.'; position: absolute; right: 10px; margin-right: 100%; width: 1em; font-size: 16px; text-align: center; color: #999; }</code></pre> </div> </div> <a class="switcher" data-do="toggle" data-status="0" href="###">SHOW CODE</a> <a href="#demo-4" class="tip">NEXT</a> </div> </div> <div class="demo demo-4" id="demo-4"> <div class="center"> <div class="v-center"> <div class="vtxt preview" data-lining> 桃花庵歌 <small>唐寅</small><br/> 桃花塢裡桃花庵，桃花庵下桃花仙。<br/> 桃花仙人種桃樹，又摘桃花換酒錢。<br/> 酒醒只在花前坐，酒醉還來花下眠。<br/> 半醉半醒日復日，花落花開年復年。<br/> 但願老死花酒間，不願鞠躬車馬前。<br/> 車塵馬足顯者事，酒盞花枝隱士緣。<br/> 若將顯者比隱士，一在平地一在天。<br/> 若將花酒比車馬，彼何碌碌我何閒。<br/> 別人笑我太瘋癲，我笑他人看不穿。<br/> 不見五陵豪傑墓，無花無酒鋤作田。<br/> </div> <div class="code"> <pre class="language-css"><code class="language-css">.vtxt { font-size: 24px; color: #333; -webkit-writing-mode: vertical-rl; writing-mode: vertical-rl; } .vtxt .line:first-of-type { font-size: 1.5em; color: #D0496A; } .vtxt .line:first-of-type small { color: #333; font-size: .6666666em; } </code></pre> </div> </div> <a class="switcher" data-do="toggle" data-status="0" href="###">SHOW CODE</a> <a href="#demo-5" class="tip">NEXT</a> </div> </div> <div class="demo demo-5" id="demo-5"> <div class="center"> <div class="v-center"> <div class="effects preview"> <div id="effectText" class="effects-text"> <h3>The Furthest Distance In The World</h3> <h4>by Rabindranath Tagore</h4> <p>The furthest distance in the world<br/> Is not between life and death<br/> But when I stand in front of you<br/> Yet you don't know that I love you.</p> <p>The furthest distance in the world<br/> Is not when I stand in front of you<br/> Yet you can't see my love<br/> But when undoubtly knowing the love from both<br/> Yet cannot be together.</p> <p>The furthest distance in the world<br/> Is not being apart while being in love<br/> But when I plainly cannot resist the yearning<br/> Yet pretending you have never been in my heart.</p> <p>The furthest distance in the world<br/> Is not struggling against the tides<br/> But using one's indifferent heart<br/> To dig an uncrossable river<br/> For the one who loves you.</p> </div> <div class="effects-do"> <label> <select id="effectName"> <option value="fadeIn">fadeIn</option> <option value="slideIn">slideIn</option> <option value="slideInFromLeft">slideInFromLeft</option> <option value="slideInFromRight">slideInFromRight</option> <option value="rolling">rolling</option> </select> </label> <button data-do="run-effect">GO!</button> </div> <a class="switcher" data-do="show-code" href="###">SHOW CODE</a> </div> <div class="code"> <pre class="language-markup"><code class="language-markup"><script src="YOUR_PATH/lining.min.js"></script> <script src="YOUR_PATH/lining.effect.min.js"></script> <div data-lining data-effect="rolling"> Your text... <div></code></pre> <a class="switcher" data-do="preview" href="###">PREVIEW</a> </div> </div> <a href="#usage" class="tip">USAGE</a> </div> </div> <div class="main usage" id="usage"> <div class="center"> <h2>BASIC USAGE</h2> <p>All you need to do is adding <code>data-lining</code> attribute on your block element and including the <code>lining.min.js</code> script. Then you can write css to control it's line style. For example:</p> <pre><code class="language-markup"><div class="poem" data-lining>Some text...</div> <style> .poem { /* default style for `.poem` */ } .nolining .poem { /* style for `.poem` when browser don't support lining.js */ } .poem[data-lining] { /* style for `.poem` when browser support lining.js */ } .poem[data-lining="end"] { /* style for `.poem` when `line` tags created */ } .poem .line { /* style for lines */ } </style> <script src="YOUR_PATH/lining.min.js"></script> </code></pre> <h2>RWD</h2> <p>If you want your line style support Responsive web design. Make sure you add the <code>data-auto-resize</code> attribute. It will automatically relining when window resize event happen.</p> <pre><code class="language-markup"><div class="poem" data-lining data-auto-resize>Some text...</div></code></pre> <h2>Other attributes</h2> <p><code>data-from</code> and <code>data-to</code> help you control which line tags to be created. For example:</p> <pre><code class="language-markup"><div class="poem" data-lining data-from="2" data-to="3"> First Line.<br/> Second Line.<br/> Third Line.<br/> Fourth Line.<br/> </div> </code></pre> <p>After lining, only the second and third line tag will be created. Check out the <a href="http://jsbin.com/riweb/2/edit?output" target="_blank">demo</a>.</p> <p>And <code>data-line-class</code> help you control the class name of line tags, if you don't want to use the default class name: <code>line</code>.</p> <h2>Javascript</h2> <p>You can also create and manage line tags by javascript. And give you four events to do special things.</p> <pre><code class="language-markup"><div id="poem">Some text..</div> <script> var poem = document.getElementById('poem'); poem.addEventListener('beforelining', function (e) { // prevent lining if you want e.preventDefault(); }, false); poem.addEventListener('afterlining', function () { // do something after lining }, false); poem.addEventListener('beforeunlining', function () { // do something before unlining // can't prevent unlining }, false); poem.addEventListener('afterunlining', function () { // do something after unlining }, false); // start lining var poemLining = lining(poem, { // optional config 'autoResize': true, 'from': 2, 'to': 3, 'lineClass': 'my-class' }); // `unlining` method will remove all line tags. poemLining.unlining(); // `relining` method will call `unlining` first if needed, // then start lining again. poemLining.relining(); </script> </code></pre> <h2>lining.effect.js</h2> <p><code>lining.effect.js</code> is an extra part of <code>lining.js</code>. It gives you the power to add appearances animation on your lines. Use it like this:</p> <pre><code class="language-markup"><script src="YOUR_PATH/lining.min.js"></script> <script src="YOUR_PATH/lining.effect.min.js"></script> <div data-lining data-effect="rolling"> Your text... <div></code></pre> <a href="https://github.com/zmmbreeze/lining.js/releases" target="_blank" class="download">DOWNLOAD</a> <p class="share-info"> <a href="https://twitter.com/share" class="twitter-share-button" data-text="An easy to use javascript plugin offers you complete DOWN-TO-THE-LINE control for radical web typography." data-size="large" data-hashtags="liningjs">Tweet</a> <script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script> <a href="https://twitter.com/zhoumm" class="twitter-follow-button" data-show-count="false" data-size="large">Follow @zhoumm</a> <script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script> </p> </div> </div> <a href="###" data-do="top" class="top"></a> <script> // set style for body document.body.style.height = document.documentElement.clientHeight + 'px'; window.addEventListener('resize', function () { document.body.style.height = document.documentElement.clientHeight + 'px'; }); </script> <script src="assets/prism.js"></script> <script> var g = function (id) { return document.getElementById(id); }; // ------------------------- // actions // ------------------------- var effectLining; var actions = { 'toggle': function (target) { var status = target.getAttribute('data-status'); var prev = target.previousElementSibling; if (status === '1') { // show preview prev.removeAttribute('show-code'); target.setAttribute('data-status', '0'); target.innerHTML = 'SHOW CODE'; } else { // show code prev.setAttribute('show-code', ''); target.setAttribute('data-status', '1'); target.innerHTML = 'PREVIEW'; } }, 'preview': function (target) { target.parentNode.parentNode.removeAttribute('show-code'); }, 'show-code': function (target) { target.parentNode.parentNode.setAttribute('show-code', ''); }, 'top': function () { if (window.scrollTo) { window.scrollTo(0, 0); } }, 'run-effect': function (target) { var effectName = g('effectName').value; var effectText = g('effectText'); effectText.setAttribute('data-effect', effectName); if (!effectLining) { effectLining = lining(effectText); } else { effectLining.relining(true); } } }; window.addEventListener('load', function () { document.body.addEventListener('click', function (e) { var target = e.target; var actionName = target.getAttribute('data-do'); if (!actionName) { return; } e.preventDefault(); actions[actionName](target); }, false); }); </script> <script> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-36422454-1', 'auto'); ga('send', 'pageview'); </script> </div> </body> </html>