How to Use the Grid

[edit] Please Note

These docs are now deprecated, we have a new Support area located here

(Difference between revisions)
m
m
 
(6 intermediate revisions by one user not shown)
Line 24: Line 24:
 
         </li>
 
         </li>
 
         </ul>     
 
         </ul>     
         </div>  
+
         </div>
 
<div class="span5">
 
<div class="span5">
 
<div style="padding:10px;
 
<div style="padding:10px;
Line 48: Line 48:
 
         </div>
 
         </div>
 
</div>
 
</div>
 +
<!--
 +
End Header & Navigation
 +
-->
 
<div class="row">
 
<div class="row">
 
<div class="span12">
 
<div class="span12">
Line 60: Line 63:
 
</h1>
 
</h1>
 
</div>
 
</div>
The Grid can be used in any post, page or section within your PageLines theme.  As long as the section you are coding grid syntax into is enabled on your page's template, it will render elegantly.<br><br>
+
The Grid can be used in any post, page or section within your PageLines theme.  As long as the section you are coding grid syntax into is enabled on your page's template, it will render elegantly.
The Grid consists of rows and columns.  The row is simply given to the div tag as a class called <span style="color:red;">"row"</span>, and it is filled with "columns".  There are 12 possible columns in a row, and they are given to the div tag as a class called <span style="color:red;">"span(1-12)"</span>.  Depending upon the number you choose immediately following the "span" class determines how much space in the row that column or "span" will take up.
+
<p>The Grid consists of rows and columns.  The row is simply given to the div tag as a class called <span style="color:red;">"row"</span>, and it is filled with "columns".  There are 12 possible columns in a row, and they are given to the div tag as a class called <span style="color:red;">"span(1-12)"</span>.  Depending upon the number you choose immediately following the "span" class determines how much space in the row that column or "span" will take up.</p>
  
 
<p>The following sections allow Grid syntax: <a href="#">Content Box</a>, <a href="#">Content</a> and <a href="#">Grid Layout</a>.  Content and Grid Layout, by default will use Wordpress's built in text editor to define the Grid, while the Content Box will use the Textarea field as the editor.</p>
 
<p>The following sections allow Grid syntax: <a href="#">Content Box</a>, <a href="#">Content</a> and <a href="#">Grid Layout</a>.  Content and Grid Layout, by default will use Wordpress's built in text editor to define the Grid, while the Content Box will use the Textarea field as the editor.</p>
Line 95: Line 98:
 
     &lt;p&gt;Content&lt;/p&gt;
 
     &lt;p&gt;Content&lt;/p&gt;
 
   &lt;/div&gt;
 
   &lt;/div&gt;
&lt;/div&gt;
+
&lt;/div&gt;</pre>
</pre>
+
</div>
 
<div class="span6">
 
<div class="span6">
 
<h4>Results</h4>
 
<h4>Results</h4>
 
<div class="alert alert-info">
 
<div class="alert alert-info">
Below this box is what that funky code up there looks like when it is put into your post, page or content box!  If all goes as planned this code will produce a 3 column layout the width of your post or page content section <span style="color:red;">(It is responsive to your website's width!)</span>
+
Below is what <em>that</em> funky code in your post, page or content box will produce. In this case, a 3 column layout. <span style="color:red;">(It is responsive to your website's width!)</span>
 
</div>
 
</div>
 
<div class="row">
 
<div class="row">
Line 114: Line 117:
 
</div>
 
</div>
 
</div>
 
</div>
</div>
+
<div class="row">
<div class="row">
+
<div class="span6">
<div class="span6">
+
<h4>Nested Example</h4>
<h4>Nested Example</h4>
+
<pre class="prettyprint lang-html linenums">
<pre class="prettyprint lang-html linenums">
+
 
&lt;div class="row"&gt;
 
&lt;div class="row"&gt;
 
   &lt;div class="span4"&gt;
 
   &lt;div class="span4"&gt;
Line 124: Line 126:
 
   &lt;div class="span8"&gt;
 
   &lt;div class="span8"&gt;
 
     &lt;div class="row"&gt;
 
     &lt;div class="row"&gt;
       &gt;div class="span6"&gt;
+
       &lt;div class="span6"&gt;&lt;div&gt;
       &gt;div class="span6"&gt;
+
       &lt;div class="span6"&gt;&lt;div&gt;
 
   &lt;/div&gt;
 
   &lt;/div&gt;
&lt;/div&gt;
+
&lt;/div&gt;</pre>
</pre>
+
<div class="alert alert-info">
+
Below this box is what that funky code up there looks like when it is put into your post, page or content box!  If all goes as planned this code will produce a 3 column layout the width of your post or page content section <span style="color:red;">(It is responsive to your website's width!)</span>
+
 
</div>
 
</div>
</div>
+
<div class="span6">
<div class="row">
+
<h4>Results</h4>
<div class="span4">
+
<div class="alert alert-info">
Here is some content in the first section of our span4 column!
+
Below is what that funky code in your post, page or content box will produce. A 2 column layout with 2 nested sections in the 2nd column. <span style="color:red;">(It is responsive to your website's width!)</span>
</div>
+
</div>
<div class="span8">
+
 
<div class="row">
 
<div class="row">
<div class="span6">
+
<div class="span4" span style="background-color:#CCCCCC;">
This content is in another span4 column, and now we are at a total of 8 columns.
+
Content
 
</div>
 
</div>
<div class="span6">
+
<div class="span8" span style="background-color:#CCCCCC;">
This last bit of content is also in a column that spans 4 spaces, so that brings us to the ultimate number of 12.
+
Content section header
 +
<div class="row">
 +
<div class="span6" span style="background-color:#EEEEEE;">
 +
Content 1
 +
</div>
 +
<div class="span6" span style="background-color:#EEEEEE;">
 +
Content 2
 +
</div>
 +
</div>
 +
</div>
 
</div>
 
</div>
 
</div>
 
</div>
 
</div>
 
</div>
 
</div>
 
</div>
</div>
 
</div>
 
 
</html>
 
</html>

Latest revision as of 03:48, 18 May 2012

In PageLines Framework 2.2, we have added more functionality from bootstrap -- an adaptation of their scaffolding system, The Grid. The Grid allows you to build a highly customizable, responsive layout with simple syntax. You can view an example of the Grid in use at the PageLines 2.2 Demo Site
The Grid can be used in any post, page or section within your PageLines theme. As long as the section you are coding grid syntax into is enabled on your page's template, it will render elegantly.

The Grid consists of rows and columns. The row is simply given to the div tag as a class called "row", and it is filled with "columns". There are 12 possible columns in a row, and they are given to the div tag as a class called "span(1-12)". Depending upon the number you choose immediately following the "span" class determines how much space in the row that column or "span" will take up.

The following sections allow Grid syntax: Content Box, Content and Grid Layout. Content and Grid Layout, by default will use Wordpress's built in text editor to define the Grid, while the Content Box will use the Textarea field as the editor.

Careful! Do not use the Content and Grid Layout sections on the same page, as they both use Wordpress's editor and will, thus resulting in duplicate content. If you want to use two Grids on one page, pair the Content or Grid Layout sections with a Content Box section.
Tip:If you are going to use the Grid in a Content Box, utilize Content Box's Content Box Class field to further customize your grid.

Simple Usage

<div class="row">
  <div class="span4">
    <p>Content</p>
  </div>
  <div class="span4">
    <p>Content</p>
  </div>
  <div class="span4">
    <p>Content</p>
  </div>
</div>

Results

Below is what that funky code in your post, page or content box will produce. In this case, a 3 column layout. (It is responsive to your website's width!)
Here is some content in the first section of our span4 column!
This content is in another span4 column, and now we are at a total of 8 columns.
This last bit of content is also in a column that spans 4 spaces, so that brings us to the ultimate number of 12.

Nested Example

<div class="row">
  <div class="span4">
  </div>
  <div class="span8">
    <div class="row">
      <div class="span6"><div>
      <div class="span6"><div>
  </div>
</div>

Results

Below is what that funky code in your post, page or content box will produce. A 2 column layout with 2 nested sections in the 2nd column. (It is responsive to your website's width!)
Content
Content section header
Content 1
Content 2