mvcss.github.com/components/index.html at master · mvcss/mvcss.github.com · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
<!DOCTYPE html> <html lang=en> <head> <meta charset=utf-8> <meta content='IE=edge,chrome=1' http-equiv=X-UA-Compatible> <meta content='width=device-width, initial-scale=1.0' name=viewport> <title>Components / MVCSS</title> <meta content='MVCSS - A Sass-based CSS architecture for creating predictable and maintainable application style.' name=description> <link href="../assets/stylesheets/application.css" rel=stylesheet /> <script>
      var _gaq = _gaq || [];
      _gaq.push(['_setAccount', 'UA-32794837-1']);
      _gaq.push(['_trackPageview']);

      (function() {
        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
      })();
    </script> </head> <body class='components components_index' data-id=13> <a class=toggle href="#"><div class=toggle-icn> <div class=toggle-icn-stack> <b class=srt>Toggle</b> </div> </div> </a> <aside class=sidebar> <header class=header> <div class='bucket bucket--flag'> <div class=bucket-media> <img alt=MVCSS class=header-logo width=100 height=110 src="../assets/images/logo.svg"/> </div> <div class=bucket-content> <p class='h1 header-title'><a href="../">MVCSS</a></p> <p class=header-version>Version 4.1.1</p> </div> </div> </header> <a class=sidebar-btn href="http://github.com/mvcss/mvcss">View on GitHub</a> <nav class=sidebar-nav> <a class=sidebar-link href="../">Overview</a> <a class=sidebar-link href="../styleguide/">Styleguide</a> <div class=sidebar-nav-sub> <a class="sidebar-link sidebar-link--sub" href="../styleguide/basics/">Basics</a> <a class="sidebar-link sidebar-link--sub" href="../styleguide/numbers-game/">The Numbers Game</a> <a class="sidebar-link sidebar-link--sub" href="../styleguide/comments/">Comments</a> <a class="sidebar-link sidebar-link--sub" href="../styleguide/naming/">Naming Conventions</a> </div> <a class=sidebar-link href="../manifest/">Manifest</a> <a class=sidebar-link href="../foundation/">Foundation</a> <div class=sidebar-nav-sub> <a class="sidebar-link sidebar-link--sub" href="../foundation/reset/">Reset</a> <a class="sidebar-link sidebar-link--sub" href="../foundation/helpers/">Helpers</a> <a class="sidebar-link sidebar-link--sub" href="../foundation/config/">Config</a> <a class="sidebar-link sidebar-link--sub" href="../foundation/base/">Base</a> <a class="sidebar-link sidebar-link--sub" href="../foundation/tools/">Tools</a> </div> <a class="sidebar-link is-active" href="./">Components</a> <a class=sidebar-link href="../structures/">Structures</a> <a class=sidebar-link href="../vendor/">Vendor</a> <div class=sidebar-nav-secondary> <h3 class='sidebar-label mtl'>Meta</h3> <a class=sidebar-link href="../about/">About</a> <a class=sidebar-link href="../resources/">Resources</a> </div> </nav> </aside> <div class=row> <div class='cell well'> <main class=content> <article> <h1>Components</h1> <p>The beginnings of a recognizable user interface live in the Components directory. These are abstract, reasonably portable modules that can be swapped in and out of different projects with relative ease.</p> <p>Some Components, like <code>g</code> (grid) and <code>card</code>, are used for layout and containers, and can encompass many other modules.</p> <pre class="highlight html"><code><span class="nt">&lt;div</span> <span class="na">class=</span><span class="s">"g"</span><span class="nt">&gt;</span>&#x000A;  <span class="nt">&lt;div</span> <span class="na">class=</span><span class="s">"g-box g-b--1of2"</span><span class="nt">&gt;</span>&#x000A;    <span class="nt">&lt;div</span> <span class="na">class=</span><span class="s">"card"</span><span class="nt">&gt;</span>&#x000A;      <span class="c">&lt;!-- Content --&gt;</span>&#x000A;    <span class="nt">&lt;/div&gt;</span>&#x000A;  <span class="nt">&lt;/div&gt;</span>&#x000A;  <span class="nt">&lt;div</span> <span class="na">class=</span><span class="s">"g-b g-b--1of2"</span><span class="nt">&gt;</span>&#x000A;    <span class="nt">&lt;div</span> <span class="na">class=</span><span class="s">"card"</span><span class="nt">&gt;</span>&#x000A;      <span class="c">&lt;!-- Content --&gt;</span>&#x000A;    <span class="nt">&lt;/div&gt;</span>&#x000A;  <span class="nt">&lt;/div&gt;</span>&#x000A;<span class="nt">&lt;/div&gt;</span>&#x000A;</code></pre> <p><strong>Note</strong>: We shorten <code>grid</code> classes to <code>g</code> and <code>grid-box</code> classes to <code>g-b</code>. Since we write these grid classes so frequently, we want them to be as concise as possible. However, feel free to use the full words, if that&rsquo;s more comfortable for you.</p> <p>Other Components, like <code>thumb</code>, affect only a single element, and can resemble Tools at first glance. In these situations, both the Component and Tool have a single responsibility. The <em>Component</em>, however, may be declared alongside its modifier classes, while the Tool applies more definitive styles.</p> <pre class="highlight html"><code><span class="nt">&lt;div</span> <span class="na">class=</span><span class="s">"bucket"</span><span class="nt">&gt;</span>&#x000A;  <span class="nt">&lt;div</span> <span class="na">class=</span><span class="s">"bucket-media"</span><span class="nt">&gt;</span>&#x000A;    <span class="nt">&lt;img</span> <span class="na">class=</span><span class="s">"thumb thumb--m"</span> <span class="na">src=</span><span class="s">"avatar-nick.jpg"</span> <span class="na">alt=</span><span class="s">"Nick Walsh"</span><span class="nt">&gt;</span>&#x000A;  <span class="nt">&lt;/div&gt;</span>&#x000A;  <span class="nt">&lt;div</span> <span class="na">class=</span><span class="s">"bucket-content"</span><span class="nt">&gt;</span>&#x000A;    <span class="nt">&lt;p&gt;</span>Nick Walsh<span class="nt">&lt;/p&gt;</span>&#x000A;  <span class="nt">&lt;/div&gt;</span>&#x000A;<span class="nt">&lt;/div&gt;</span>&#x000A;</code></pre> <h2>Characteristics</h2> <p>When determing whether a module is a Component or Structure, we find it helpful to ask ourselves the following questions:</p> <ul> <li>Does this module limit its scope as much as possible?</li> <li>Is this module independent of pre-existing Components?</li> <li>Is this module abstract enough to use in other projects without making significant changes?</li> </ul> <p>If you answer &ldquo;no&rdquo; to any of these questions, the module in question is more than likely a Structure.</p> </article> <ul class=pager> <li class=pager-item> <a href="../foundation/tools/">&larr; Previous page </a> </li> <li class=pager-item> <a href="../structures/">Next page &rarr; </a> </li> </ul> </main> </div> </div> <script>
      var _gauges = _gauges || [];
      (function() {
        var t   = document.createElement('script');
        t.type  = 'text/javascript';
        t.async = true;
        t.id    = 'gauges-tracker';
        t.setAttribute('data-site-id', '4fe1bcaa613f5d1bfe000020');
        t.src = '//secure.gaug.es/track.js';
        var s = document.getElementsByTagName('script')[0];
        s.parentNode.insertBefore(t, s);
      })();
    </script> <script src="http://code.jquery.com/jquery-1.11.1.min.js"></script> <script src="../assets/javascripts/application.js"></script> </body> </html>