From c7c33561011d03cbcb961082689621144289d7f1 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Sat, 20 Aug 2011 23:32:37 -0700 Subject: [PATCH] more spacing tweaks --- docs/index.html | 1104 ++++++++++++++++++++++++----------------------- 1 file changed, 554 insertions(+), 550 deletions(-) diff --git a/docs/index.html b/docs/index.html index 6cc832344d..c64710695a 100644 --- a/docs/index.html +++ b/docs/index.html @@ -233,6 +233,8 @@

Layouts Basic templates to create webpages

+ +

Fixed layout

@@ -250,7 +252,9 @@ </body>
-
+ + +

Fluid layout

@@ -274,296 +278,298 @@ </body>
-
+
-
-

Typography Headings, paragraphs, lists, and other inline type elements

-
+
+

Typography Headings, paragraphs, lists, and other inline type elements

+
-
-
-

Headings and copy

-

A standard typographic hierarchy for structuring your webpages.

+ +
+
+

Headings and copy

+

A standard typographic hierarchy for structuring your webpages.

+
+
+

h1. Heading 1

+

h2. Heading 2

+

h3. Heading 3

+

h4. Heading 4

+
h5. Heading 5
+
h6. Heading 6
+
+
+

Example paragraph

+

Nullam quis risus eget urna mollis ornare vel eu leo. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Nullam id dolor id nibh ultricies vehicula ut id elit.

+

Example heading Has sub-heading…

+
-
-

h1. Heading 1

-

h2. Heading 2

-

h3. Heading 3

-

h4. Heading 4

-
h5. Heading 5
-
h6. Heading 6
-
-
-

Example paragraph

-

Nullam quis risus eget urna mollis ornare vel eu leo. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Nullam id dolor id nibh ultricies vehicula ut id elit.

-

Example heading Has sub-heading…

-
-
-
-
-

Misc. elements

-

Using emphasis, addresses, & abbreviations

-

- <strong> - <em> - <address> - <abbr> -

-
-
-

When to use

-

Emphasis tags (<strong> and <em>) should be used to indicate additional importance or emphasis of a word or phrase relative to its surrounding copy. Use <strong> for importance and <em> for stress emphasis.

-

Emphasis in a paragraph

-

Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus. Maecenas faucibus mollis interdum. Nulla vitae elit libero, a pharetra augue.

-

Note: It's still okay to use <b> and <i> tags in HTML5, but they don't come with inherent styles anymore. <b> is meant to highlight words or phrases without conveying additional importance, while <i> is mostly for voice, technical terms, etc.

-

Addresses

-

The <address> element is used for contact information for its nearest ancestor, or the entire body of work. Here’s how it looks:

-
- Twitter, Inc.
- 795 Folsom Ave, Suite 600
- San Francisco, CA 94107
- P: (123) 456-7890 -
-

Note: Each line in an <address> must end with a line-break (<br />) or be wrapped in a block-level tag (e.g., <p>) to properly structure the content.

-

Abbreviations

-

For abbreviations and acronyms, use the <abbr> tag (<acronym> is deprecated in HTML5). Put the shorthand form within the tag and set a title for the complete name.

-
-
+ +
+
+

Misc. elements

+

Using emphasis, addresses, & abbreviations

+

+ <strong> + <em> + <address> + <abbr> +

+
+
+

When to use

+

Emphasis tags (<strong> and <em>) should be used to indicate additional importance or emphasis of a word or phrase relative to its surrounding copy. Use <strong> for importance and <em> for stress emphasis.

+

Emphasis in a paragraph

+

Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus. Maecenas faucibus mollis interdum. Nulla vitae elit libero, a pharetra augue.

+

Note: It's still okay to use <b> and <i> tags in HTML5, but they don't come with inherent styles anymore. <b> is meant to highlight words or phrases without conveying additional importance, while <i> is mostly for voice, technical terms, etc.

+

Addresses

+

The <address> element is used for contact information for its nearest ancestor, or the entire body of work. Here’s how it looks:

+
+ Twitter, Inc.
+ 795 Folsom Ave, Suite 600
+ San Francisco, CA 94107
+ P: (123) 456-7890 +
+

Note: Each line in an <address> must end with a line-break (<br />) or be wrapped in a block-level tag (e.g., <p>) to properly structure the content.

+

Abbreviations

+

For abbreviations and acronyms, use the <abbr> tag (<acronym> is deprecated in HTML5). Put the shorthand form within the tag and set a title for the complete name.

+
+
-
-
-

Blockquotes

-

- <blockquote> - <p> - <small> -

-
-
-

Be sure to wrap your <blockquote> around <p> and <small> tags. When citing a source, use the <small> element. The CSS will automatically preface a name with an em dash (&mdash;).

-
-

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua…

- Dr. Julius Hibbert -
-
-
+ +
+
+

Blockquotes

+

+ <blockquote> + <p> + <small> +

+
+
+

Be sure to wrap your <blockquote> around <p> and <small> tags. When citing a source, use the <small> element. The CSS will automatically preface a name with an em dash (&mdash;).

+
+

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua…

+ Dr. Julius Hibbert +
+
+
- -

Lists

-
-
-

Unordered <ul>

-
    -
  • Jeremy Bixby
    • -
  • Robert Dezure
    • -
  • Josh Washington
    • -
  • Anton Capresi
    • -
  • My Team Mates -
      -
    • George Castanza
      • -
    • Jerry Seinfeld
      • -
    • Cosmo Kramer
      • -
    • Elaine Bennis
      • -
    • Newman
      • -
    -
    • -
  • John Jacob
    • -
  • Paul Pierce
    • -
  • Kevin Garnett
    • -
-
-
-

Unstyled <ul.unstyled>

-
    -
  • Jeremy Bixby
    • -
  • Robert Dezure
    • -
  • Josh Washington
    • -
  • Anton Capresi
    • -
  • My Team Mates -
      -
    • George Castanza
      • -
    • Jerry Seinfeld
      • -
    • Cosmo Kramer
      • -
    • Elaine Bennis
      • -
    • Newman
      • -
    -
    • -
  • John Jacob
    • -
  • Paul Pierce
    • -
  • Kevin Garnett
    • -
-
-
-

Ordered <ol>

-
    -
  1. Jeremy Bixby
    2. -
  2. Robert Dezure
    3. -
  3. Josh Washington
    4. -
  4. Anton Capresi
    5. -
  5. My Team Mates -
      -
    1. George Castanza
      2. -
    2. Jerry Seinfeld
      3. -
    3. Cosmo Kramer
      4. -
    4. Elaine Bennis
      5. -
    5. Newman
      6. -
    -
    6. -
  6. John Jacob
    7. -
  7. Paul Pierce
    8. -
  8. Kevin Garnett
    9. -
-
-
-

Description dl

-
-
Description lists
-
A description list is perfect for defining terms.
-
Euismod
-
Vestibulum id ligula porta felis euismod semper eget lacinia odio sem nec elit.
-
Donec id elit non mi porta gravida at eget metus.
-
Malesuada porta
-
Etiam porta sem malesuada magna mollis euismod.
-
-
-
+ +

Lists

+
+
+

Unordered <ul>

+
    +
  • Jeremy Bixby
    • +
  • Robert Dezure
    • +
  • Josh Washington
    • +
  • Anton Capresi
    • +
  • My Team Mates +
      +
    • George Castanza
      • +
    • Jerry Seinfeld
      • +
    • Cosmo Kramer
      • +
    • Elaine Bennis
      • +
    • Newman
      • +
    +
    • +
  • John Jacob
    • +
  • Paul Pierce
    • +
  • Kevin Garnett
    • +
+
+
+

Unstyled <ul.unstyled>

+
    +
  • Jeremy Bixby
    • +
  • Robert Dezure
    • +
  • Josh Washington
    • +
  • Anton Capresi
    • +
  • My Team Mates +
      +
    • George Castanza
      • +
    • Jerry Seinfeld
      • +
    • Cosmo Kramer
      • +
    • Elaine Bennis
      • +
    • Newman
      • +
    +
    • +
  • John Jacob
    • +
  • Paul Pierce
    • +
  • Kevin Garnett
    • +
+
+
+

Ordered <ol>

+
    +
  1. Jeremy Bixby
    2. +
  2. Robert Dezure
    3. +
  3. Josh Washington
    4. +
  4. Anton Capresi
    5. +
  5. My Team Mates +
      +
    1. George Castanza
      2. +
    2. Jerry Seinfeld
      3. +
    3. Cosmo Kramer
      4. +
    4. Elaine Bennis
      5. +
    5. Newman
      6. +
    +
    6. +
  6. John Jacob
    7. +
  7. Paul Pierce
    8. +
  8. Kevin Garnett
    9. +
+
+
+

Description dl

+
+
Description lists
+
A description list is perfect for defining terms.
+
Euismod
+
Vestibulum id ligula porta felis euismod semper eget lacinia odio sem nec elit.
+
Donec id elit non mi porta gravida at eget metus.
+
Malesuada porta
+
Etiam porta sem malesuada magna mollis euismod.
+
+
+
-
-
-

Tables For, you guessed it, tabular data

-
-
-
-

Building tables

-

- <table> - <thead> - <tbody> - <tr> - <th> - <td> - <colspan> - <caption> -

-

Tables are great—for a lot of things. Great tables, however, need a bit of markup love to be useful, scalable, and readable (at the code level). Here are a few tips to help.

-

Always wrap your column headers in a <thead> such that hierarchy is <thead> > <tr> > <th>.

-

Similar to the column headers, all your table’s body content should be wrapped in a <tbody> so your hierarchy is <tbody> > <tr> > <td>.

+
+
+

Tables For, you guessed it, tabular data

-
-

Example: Default table styles

-

All tables will be automatically styled with only the essential borders to ensure readability and maintain structure. No need to add extra classes or attributes.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
#First NameLast NameLanguage
1SomeOneEnglish
2JoeSixpackEnglish
3StuDentCode
+ +
+
+

Building tables

+

+ <table> + <thead> + <tbody> + <tr> + <th> + <td> + <colspan> + <caption> +

+

Tables are great—for a lot of things. Great tables, however, need a bit of markup love to be useful, scalable, and readable (at the code level). Here are a few tips to help.

+

Always wrap your column headers in a <thead> such that hierarchy is <thead> > <tr> > <th>.

+

Similar to the column headers, all your table’s body content should be wrapped in a <tbody> so your hierarchy is <tbody> > <tr> > <td>.

+
+
+

Example: Default table styles

+

All tables will be automatically styled with only the essential borders to ensure readability and maintain structure. No need to add extra classes or attributes.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
#First NameLast NameLanguage
1SomeOneEnglish
2JoeSixpackEnglish
3StuDentCode
 <table class="common-table">
   ...
 </table>
- -

Example: Zebra-striped

-

Get a little fancy with your tables by adding zebra-striping—just add the .zebra-striped class.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
#First NameLast NameLanguage
1SomeOneEnglish
2JoeSixpackEnglish
3StuDentCode
+

Example: Zebra-striped

+

Get a little fancy with your tables by adding zebra-striping—just add the .zebra-striped class.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
#First NameLast NameLanguage
1SomeOneEnglish
2JoeSixpackEnglish
3StuDentCode
 <table class="common-table zebra-striped">
 ...
 </table>
- -

Example: Zebra-striped w/ TableSorter.js

-

Taking the previous example, we improve the usefulness of our tables by providing sorting functionality via jQuery and the Tablesorter plugin. Click any column’s header to change the sort.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
#First NameLast NameLanguage
1YourOneEnglish
2JoeSixpackEnglish
3StuDentCode
+

Example: Zebra-striped w/ TableSorter.js

+

Taking the previous example, we improve the usefulness of our tables by providing sorting functionality via jQuery and the Tablesorter plugin. Click any column’s header to change the sort.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
#First NameLast NameLanguage
1YourOneEnglish
2JoeSixpackEnglish
3StuDentCode
 <script src="js/jquery/jquery.tablesorter.min.js"></script>
 <script >
@@ -574,299 +580,297 @@
 <table class="common-table zebra-striped">
   ...
 </table>
-
-
+
+
- -
-

Forms

-
- -
-
-

Default styles

-

All forms are given default styles to present them in a readable and scalable way. Styles are provided for text inputs, select lists, textareas, radio buttons and checkboxes, and buttons.

+
+

Forms

-
-
-
- Example form legend -
- -
- -
-
-
- -
- -
-
-
- -
- -
-
-
- -
- Some Value Here -
-
-
- -
- -
-
-
- -
- - Small snippet of help text -
-
-
-
- Example form legend -
- -
-
- @ - +
+
+

Default styles

+

All forms are given default styles to present them in a readable and scalable way. Styles are provided for text inputs, select lists, textareas, radio buttons and checkboxes, and buttons.

+
+
+ +
+ Example form legend +
+ +
+ +
+
+
+ +
+ +
+
+
+ +
+ +
+
+
+ +
+ Some Value Here +
+
+
+ +
+ +
+
+
+ +
+ + Small snippet of help text +
+
+
+
+ Example form legend +
+ +
+
+ @ + +
+
+
+
+ +
+
+ + +
+
+
+
+ +
+
+ + +
+
+
+
+ +
+ +
+
+
+
+ Example form legend +
+ +
+
    +
  • + +
    • +
  • + +
    • +
  • + +
    • +
  • + +
    • +
+ + Note: Labels surround all the options for much larger click areas and a more usable form. + +
+
+
+ +
+
+ + + to + + + All times are shown as Pacific Standard Time (GMT -08:00). +
+
+
+
+ +
+ + + Block of help text to describe the field above if need be. + +
+
+
+ +
+
    +
  • + +
    • +
  • + +
    • +
+
+
+
+ +
+
+ +
+
+ +
+ +
+
+

Stacked forms

+

Add .form-stacked to your form’s HTML and you’ll have labels on top of their fields instead of to their left. This works great if your forms are short or you have two columns of inputs for heavier forms.

+
+
+
+
+ Example form legend +
+ +
+ +
+
+
+ +
+ +
+
+
+
+ Example form legend +
+ +
+
    +
  • + +
    • +
  • + +
    • +
+ + Note: Labels surround all the options for much larger click areas and a more usable form. + +
+
+
+
+ +
-
-
- -
-
- - -
-
-
-
- -
-
- - -
-
-
-
- -
- -
-
-
-
- Example form legend -
- -
-
    -
  • - -
    • -
  • - -
    • -
  • - -
    • -
  • - -
    • -
- - Note: Labels surround all the options for much larger click areas and a more usable form. - -
-
-
- -
-
- - - to - - - All times are shown as Pacific Standard Time (GMT -08:00). -
-
-
-
- -
- - - Block of help text to describe the field above if need be. - -
-
-
- -
-
    -
  • - -
    • -
  • - -
    • -
-
-
-
- - + +
+
+ +
+
+

Buttons

+

As a convention, buttons are used for actions while links are used for objects. For instance, "Download" could be a button and "recent activity" could be a link.

+

All buttons default to a light gray style, but a blue .primary class is available. Plus, rolling your own styles is easy peasy.

+
+
+

Example buttons

+

Button styles can be applied to anything with the .btn applied. Typically you’ll want to apply these to only <a>, <button>, and select <input> elements. Here’s how it looks:

+
+ +
- - -
-
- -
- -
-
-

Stacked forms

-

Add .form-stacked to your form’s HTML and you’ll have labels on top of their fields instead of to their left. This works great if your forms are short or you have two columns of inputs for heavier forms.

-
-
-
-
- Example form legend -
- -
- -
-
-
- -
- -
-
-
-
- Example form legend -
- -
-
    -
  • - -
    • -
  • - -
    • -
- - Note: Labels surround all the options for much larger click areas and a more usable form. - -
-
-
-
- - +

Alternate sizes

+

Fancy larger or smaller buttons? Have at it!

+
+ Primary action + Action +
+
+ Primary action + Action +
+

Disabled state

+

For buttons that are not active or are disabled by the app for one reason or another, use the disabled state. That’s .disabled for links and :disabled for <button> elements.

+

Links

+
+ Primary action + Action +
+

Buttons

+
+ +
- -
-
- -
-
-

Buttons

-

As a convention, buttons are used for actions while links are used for objects. For instance, "Download" could be a button and "recent activity" could be a link.

-

All buttons default to a light gray style, but a blue .primary class is available. Plus, rolling your own styles is easy peasy.

-
-
-

Example buttons

-

Button styles can be applied to anything with the .btn applied. Typically you’ll want to apply these to only <a>, <button>, and select <input> elements. Here’s how it looks:

-
- -
-

Alternate sizes

-

Fancy larger or smaller buttons? Have at it!

-
- Primary action - Action -
-
- Primary action - Action -
-

Disabled state

-

For buttons that are not active or are disabled by the app for one reason or another, use the disabled state. That’s .disabled for links and :disabled for <button> elements.

-

Links

-
- Primary action - Action -
-

Buttons

-
- - -
-
-
+