sassy-buttons 0.0.1

data/README.mkdn

@@ -0,0 +1,122 @@
+        Compass CSS Sassy Buttons 
+====================
+
+Super sassy and super easy CSS3 buttons. 
+
+Installation
+============
+
+Install gem from the command line:
+
+    sudo gem install sassy-buttons
+
+Create a new project using Sassy Buttons
+
+    compass create project_name -r sassy-buttons --using sassy-buttons
+    
+    #import sassy buttons into your sass/scss file
+    @import "sassybuttons"
+
+    
+Adding Sassy Buttons to an exiting project:
+    
+    # Edit the project configuration file and add:
+    require 'sassy-buttons'
+    
+    # From the command line:
+    compass install sassy-buttons
+    
+    #import sassy buttons into your sass/scss file
+    @import "sassybuttons"
+
+
+Using Sassy Buttons
+===================
+
+The Sassy Button mixin
+    
+    # The simplest form of the mixin using the provided defaults (See Defaults section below)   
+    @include sassy-button
+    
+    # The Sassy Button mixin takes optional arguments that you can use to customise your buttons on the fly
+    # This will create a button with a blue matte stlye gradient, with a 15px border radius, 20px font size    
+    @include sassy-button("matte", 15px, 20px, rgba(11, 153, 194, 1))
+
+    # The complete Sassy Button mixin syntax  
+    @include sassy-button(gradient style, border radius, font size, first color, second color, text color, text style, auto hover)
+    
+
+Sassy Buttons Gradient Styles
+----------------------------
+Sassy buttons offer five gradient styles for your buttons. These gradients are generated for you base on the colors you provide. If you don't provide a second color, the mixin will create one for you.
+
+* Simple - A straight gradient from first color to the second color.
+* Matte - A gradient that adds depth but remains a more matte finish.
+* Shiny - A gradient that has a larger highlight area that gives a shinier look.
+* Glass - A gradient thats provides a glass type finish
+* Flat - No gradient, button will be given first color provided. 
+
+Sassy Buttons Text Styles
+-------------------------
+Sassy buttons has three text styles
+
+* Inset - Text shadow that makes text look inset on the button
+* Raised - Text shadow that makes text look raised on the button
+* False - no text style
+
+Sassy Buttons Defaults
+----------------------
+
+The Sassy Buttons extension provides a set of defaults sass variables that are used in the various mixins to create the buttons. These defaults can be overridden to customize your buttons to your liking and has the added benefit of having to provide less arguments when calling the sassy button mixin.
+
+	# Available defaults	
+	$sb-base-color: rgba(11,153,194,1)   // Base color of button, used to caluclate graident styles.
+	$sb-second-color: false              // Optional secondary color for gradient.
+	$sb-border-radius: 10px              // Border radius of button.
+	$sb-border-width: 1px                // Border width.
+	$sb-padding: .5em 1.5em              // Padding that gives button structure.
+	$sb-font-size: 16px                  // Font size.
+	$sb-line-height: 1.2em               // Line Height.
+	$sb-text-color: #fff                 // Button font color.
+	$sb-text-style: "inset"              // Style of button text, can be "inset" or "raised" or false.
+	$sb-gradient-style: "matte"          // Gradient style of button, can be "matte", "shiny", "glass", "simple", "flat".
+	$sb-hover: true                      // Automatically generate psuedo :hover state styles.
+	
+	# Sassy Button structure mixin that gets called everytime you create a sassy button.
+	# You can add any custom styles you want applied to all your buttons.	
+	@mixin sassy-button-default-structure
+		:display inline-block	
+		:width auto
+		:height auto
+		:cursor pointer
+		
+Additional Sassy Button Styles
+------------------------------
+
+Sassy Buttons provides two mixins that can add a little extra style to your buttons
+
+	# Mixin for adding styles to buttons
+	@include sassy-button-style(style, color)
+
+Available styles: 
+
+* Inset - box shadow that gives button an inset look.
+* Push - box shadow that gives button a "pushable" look.
+
+
+Available Sassy Buttons Mixins
+------------------------------
+
+Sassy buttons are made up a few different mixins, which all get called by the main sassy button mixin (@include sassy-button), these are all available for you to use to have more control over your buttons.  
+
+	# Mixin for the structure of your button (this mixin calls the sassy-button-default structure mixin).
+	# Example use: Creating a custom button structure to apply color and text style mixins on.
+	@include sassy-button-structure(border radius, border width, padding, font size, line height)
+    
+	# Mixin for the gradient styles
+	# Example use: You could call this mixin on a :hover or :active state to provide your own styles for those pseudo states.
+	@include sassy-button-colors(gradient style, first color, second color, auto hover)
+	
+	# Mixin for text styles
+	# Example use: Apply a "inset", "raised" text style to a button
+	@include sassy-button-text-style(first color, text color, text style )

data/lib/sassy-buttons.rb

@@ -0,0 +1,3 @@
+require 'compass'
+extension_path = File.expand_path(File.join(File.dirname(__FILE__), ".."))
+Compass::Frameworks.register('sassy-buttons', :path => extension_path)

data/stylesheets/_sassy-buttons.sass

@@ -0,0 +1,59 @@
+// Sassy Buttons 
+// Compass extension by Jared Hardy - http://www.jaredhardy.com
+
+@import "compass/css3/border-radius"
+@import "compass/css3/box-shadow"
+@import "compass/css3/text-shadow"
+@import "compass/css3/gradient"
+
+@import "sassy-buttons/sassy-button-colors"
+@import "sassy-buttons/sassy-button-styles"
+@import "sassy-buttons/sassy-button-text"
+@import "sassy-buttons/sassy-button-pseudo-states"
+
+
+// Sassy Button defaults
+// These are the base defaults for the buttons, if you are going to use similar buttons on an entire site changing these 
+// can save you some time by calling the sassy button mixin with less arguments. 
+
+$sb-base-color: rgba(11,153,194,1) 	// Base color of button.
+$sb-second-color: false 					// Optional secondary color for gradient.
+$sb-border-radius: 10px 						// Border radius of button.
+$sb-border-width: 1px 							// Border width.
+$sb-padding: .5em 1.5em 						// Padding that gives button structure.
+$sb-font-size: 16px									// Font size.
+$sb-line-height: 1.2em							// Line Height.
+$sb-text-color: #fff			 					// Button font color.
+$sb-text-style: "inset"							// Style of button text, can be "inset" or "raised" or false.
+$sb-gradient-style: "matte"					// Gradient style of button, can be "matte", "shiny", or "glass".
+$sb-hover: true											// Automatically generate psuedo :hover state styles.
+$sb-ieSupport: false								// TODO - Better IE support
+
+// Mixing that gets included when calling the sassy-button-structure if you need any 
+// styles applied to all your sassy buttons, add it here.
+@mixin sassy-button-default-structure
+	:display inline-block	
+	:width auto
+	:height auto
+	:cursor pointer
+	// IE support that will be coming soon
+	//@if($sb-ieSupport)
+		//:background-image image-url(ie-gradient.png)
+		//:background-repeat repeat-x
+
+// The Sassy Button kitchen sink.
+@mixin sassy-button($gradient-style: $sb-gradient-style, $border-radius: $sb-border-radius, $font-size: $sb-font-size, $first-color: $sb-base-color, $second-color: $sb-second-color, $text-color:$sb-text-color, $text-style: $sb-text-style, $auto-hover: $sb-hover)
+	@include sassy-button-structure($border-radius, $sb-border-width, $sb-padding, $font-size, $sb-line-height)
+	@include sassy-button-colors($gradient-style, $first-color, $second-color, $auto-hover)
+	@include sassy-button-text-style($first-color, $text-color, $text-style )
+	
+// Structure for a sassy button
+@mixin sassy-button-structure($border-radius: $sb-border-radius, $border-width: $sb-border-width, $padding: $sb-padding, $font-size: $sb-font-size, $line-height: $sb-line-height)
+	@include sassy-button-default-structure
+	:font-size $font-size
+	:padding $padding
+	:line-height $line-height
+	:border-style solid 
+	:border-width $border-width
+	@include border-radius($border-radius)
+	

data/stylesheets/sassy-buttons/_sassy-button-colors.sass

@@ -0,0 +1,71 @@
+// Mixin that does all the gradient magic
+
+@mixin sassy-button-colors($style: "matte", $base-color: $sb-base-color, $second-color: "false", $auto-states: true)
+	
+	$lightness : lightness($base-color)
+	$brightnessDivsor : 1
+	@if $lightness > 75
+		$brightnessDivsor : 2
+	
+	background-color: $base-color
+	
+	
+	@if $style == "matte"
+		$highlight: lighten($base-color, 30%)
+		$first-color: $base-color
+		
+		@if $second-color == false
+			$first-color: lighten($base-color,15%)
+			$second-color: $base-color	
+		
+		@include linear-gradient(color-stops($highlight, $first-color 3%, $second-color 70%))
+	
+		:border-color $second-color
+		@if $auto-states
+			@include sassy-pseudo-states("all", $first-color, $second-color, $highlight, $style)
+	
+		
+	@if $style == "shiny"
+		$highlight : lighten($base-color, 55%)
+		$first-color: lighten($base-color, 25% / $brightnessDivsor) 
+		
+		@if $second-color == false
+			$second-color: darken($base-color, 10%)
+			
+		@include linear-gradient(color-stops($highlight,$first-color 3%, $base-color 50%, $second-color))
+		
+		:border-color $second-color
+		
+		@if $auto-states
+			@include sassy-pseudo-states("all", $first-color, $second-color, $highlight, $style)
+		
+	@if $style == "glass"
+		$highlight : lighten($base-color, 55%)
+		$shine: lighten($base-color,10%)
+		$first-color: lighten($base-color, 8% / $brightnessDivsor)
+		
+		@if $second-color == false
+			$second-color: darken($base-color, 10%)
+		
+		@include linear-gradient(color-stops($highlight, $shine 2%, $first-color 50%, $base-color 51%, $second-color))
+		:border-color $second-color
+		
+		@if $auto-states
+			@include sassy-pseudo-states("all", $first-color, $second-color, $highlight, $style)
+	
+	@if $style == "simple"	
+		@if $second-color == false
+			$second-color: darken($base-color, 20%)
+		
+		@include linear-gradient(color-stops($base-color, $second-color))
+		:border-color $second-color
+		
+		@if $auto-states
+			@include sassy-pseudo-states("all", $base-color, $second-color, false, $style)
+		
+	@if $style == "flat"
+		:background-color $base-color
+		
+		@if $auto-states
+			@include sassy-pseudo-states("all", $base-color, false, false, $style)
+		

data/stylesheets/sassy-buttons/_sassy-button-pseudo-states.sass

@@ -0,0 +1,41 @@
+// Mixin that generates :hover state, will eventually add other psuedo states.
+
+@mixin sassy-pseudo-states($states, $first-color, $second-color, $highlight, $style)
+	@if $states == "all"
+		@include sassy-button-hover($first-color, $second-color, $highlight, $style)
+
+
+@mixin sassy-button-hover($first-color, $second-color, $highlight, $style)
+
+	@if $style == "matte"
+		&:hover
+			@include sb-ie-hover($first-color)
+			@include linear-gradient(color-stops($highlight, lighten($first-color, 5%) 3%, lighten($second-color, 5%) 75%))
+	@if $style == "shiny"
+		&:hover
+			@include sb-ie-hover($first-color)
+			@include linear-gradient(color-stops($highlight, lighten($first-color, 4%) 3%, lighten($second-color, 8%) 60%, lighten($second-color, 4%)))
+	@if $style == "glass"
+		&:hover
+			@include sb-ie-hover($first-color)
+			@include linear-gradient(color-stops($highlight, lighten($first-color, 15%) 2%, lighten($first-color, 10%) 50%, lighten($first-color, 3%) 51%, lighten($second-color, 10%)))
+	@if $style == "simple"
+		&:hover
+			@include sb-ie-hover($first-color)
+			@include linear-gradient(color-stops(lighten($first-color, 5%),lighten($second-color, 5%)))
+	@if $style == "flat"
+		&:hover
+			:background-color lighten($first-color, 5%)
+
+// To do add other pseudo states
+
+
+@mixin sb-ie-hover($color)
+	@if $sb-ieSupport
+		@if (lightness($color) > 75)
+			$color: darken($color, 15%)
+		:background-color $color
+
+
+
+	

data/stylesheets/sassy-buttons/_sassy-button-styles.sass

@@ -0,0 +1,13 @@
+// Mixin for some optional styles on sassy buttons
+
+@mixin sassy-button-style($style, $base-color: $sb-base-color)
+	@if $style == "push"
+		@include box-shadow(darken($base-color, 5%), 0, 0.4em, 0px)
+		:border-bottom solid 1px lighten($base-color, 3%)
+		&:active
+			:top .3em
+			@include box-shadow(darken($base-color, 8%), 0, 0.2em, 0px)
+	@if $style == "inset"
+		@include box-shadow(darken($base-color, 8%) 0 0.2em 0.4em inset)
+		:border solid 1px darken($base-color, 15%)
+

data/stylesheets/sassy-buttons/_sassy-button-text.sass

@@ -0,0 +1,15 @@
+// Mixin that controls the text style
+@mixin sassy-button-text-style($base-color, $text-color, $text-style: "inset")
+	$text-lightness: lightness($text-color)
+	
+	:color $text-color
+	@if $text-style == "inset"
+		@if $text-lightness < 50
+			@include text-shadow(lighten($base-color, 20%), 0, 1px, 0)
+		@else	
+			@include text-shadow(darken($base-color, 12%), 0, -1px, 0)
+	@if $text-style == "raised"
+		@if $text-lightness < 50
+			@include text-shadow(lighten($base-color, 20%), 0, -1px, 0)
+		@else
+			@include text-shadow(darken($base-color, 12%), 0, 1px, 0)

data/templates/project/_sassybuttons.sass

@@ -0,0 +1,28 @@
+@import "sassy-buttons"
+
+
+// Sassy Button defaults
+// These are the base defaults for the buttons, if you are going to use similar buttons on an entire site, 
+// overriding these can save you some time by calling the sassy button mixin with less arguments. 
+
+$sb-base-color: rgba(11,153,194,1) 	// Base color of button.
+$sb-second-color: false 					// Optional secondary color for gradient.
+$sb-border-radius: 10px 						// Border radius of button.
+$sb-border-width: 1px 							// Border width.
+$sb-padding: .5em 1.5em 						// Padding that gives button structure.
+$sb-font-size: 16px									// Font size.
+$sb-line-height: 1.2em							// Line Height.
+$sb-text-color: #fff			 					// Button font color.
+$sb-text-style: "inset"							// Style of button text, can be "inset" or "raised" or false.
+$sb-gradient-style: "matte"					// Gradient style of button, can be "matte", "shiny", or "glass".
+$sb-hover: true											// Automatically generate psuedo :hover state styles.
+$sb-ieSupport: false								// TODO - Better IE support
+
+// Mixing that gets included when calling the sassy-button-structure if you need any 
+// styles applied to all your sassy buttons, you can add them here.
+@mixin sassy-button-default-structure
+	:background $sb-base-color
+	:display inline-block	
+	:width auto
+	:height auto
+	:cursor pointer

data/templates/project/manifest.rb

@@ -0,0 +1,16 @@
+# Make sure you list all the project template files here in the manifest.
+stylesheet '_sassybuttons.sass', :media => 'screen, projection'
+
+description "Sassy Buttons"
+
+help %Q{
+	
+	Documentation coming shortly
+		
+}
+
+welcome_message %Q{
+	
+	Sassy Buttons
+	
+}

metadata

@@ -0,0 +1,87 @@
+--- !ruby/object:Gem::Specification 
+name: sassy-buttons
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Jared Hardy
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-03 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: compass
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 10
+        - 0
+        - rc3
+        version: 0.10.0.rc3
+  type: :runtime
+  version_requirements: *id001
+description: css only buttons extension for compass
+email: jared@jaredhardy.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.mkdn
+- lib/sassy-buttons.rb
+- stylesheets/_sassy-buttons.sass
+- stylesheets/sassy-buttons/_sassy-button-colors.sass
+- stylesheets/sassy-buttons/_sassy-button-pseudo-states.sass
+- stylesheets/sassy-buttons/_sassy-button-styles.sass
+- stylesheets/sassy-buttons/_sassy-button-text.sass
+- templates/project/_sassybuttons.sass
+- templates/project/manifest.rb
+has_rdoc: true
+homepage: http://www.jaredhardy.com
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: css only buttons extension for compass
+test_files: []
+