Browse Source

Iteration on API docs

pull/1177/head
jlukic 10 years ago
parent
commit
a0e4dc930e
8 changed files with 284 additions and 145 deletions
  1. 2
      server/documents/collections/grid.html.eco
  2. 275
      server/documents/modules/api.html.eco
  3. 7
      server/files/javascript/api.js
  4. 1
      server/files/javascript/semantic.js
  5. 31
      server/files/stylesheets/semantic.css
  6. 3
      server/layouts/default.html.eco
  7. 17
      src/definitions/behaviors/api.js
  8. 93
      src/definitions/behaviors/state.js

2
server/documents/collections/grid.html.eco

@ -198,7 +198,7 @@ themes : ['Default']
<h4 class="ui header">Page Grid Breakpoints</h4> <h4 class="ui header">Page Grid Breakpoints</h4>
<p>Semantic's page grid, by default, uses percentage values for page gutters. This means your page container will <b>constantly adjust</b> as the browser width changes, giving you the largest possible space for each breakpoint.</p> <p>Semantic's page grid, by default, uses percentage values for page gutters. This means your page container will <b>constantly adjust</b> as the browser width changes, giving you the largest possible space for each breakpoint.</p>
<p>Grids, rows, and columns can receive responsive classes to make them appear only on a particular device.</p> <p>Grids, rows, and columns can receive responsive classes to make them appear only on a particular device.</p>
<table class="ui black celled table">
<table class="ui definition table">
<thead> <thead>
<tr> <tr>
<th>Name</th> <th>Name</th>

275
server/documents/modules/api.html.eco

@ -3,8 +3,8 @@ layout : 'default'
css : 'api' css : 'api'
title : 'API' title : 'API'
description : 'API allows UI elements to send events to the server'
type : 'UI Behavior'
description : 'API allows elements to trigger actions on a server'
type : 'Draft'
--- ---
<script src="/javascript/library/sinon.js"></script> <script src="/javascript/library/sinon.js"></script>
@ -17,7 +17,7 @@ type : 'UI Behavior'
<div class="ui two column stackable grid"> <div class="ui two column stackable grid">
<div class="row"> <div class="row">
<div class="sixteen wide column"> <div class="sixteen wide column">
<p>Semantic API helps attach server events to UI elements. There a few key features which make API more useful then jQuery AJAX or and simpler than MVC patterns.</p>
<p>There a few key features which make API more useful then jQuery AJAX or and simpler than MVC patterns.</p>
</div> </div>
</div> </div>
<div class="row"> <div class="row">
@ -37,8 +37,8 @@ type : 'UI Behavior'
<div class="row"> <div class="row">
<div class="column"> <div class="column">
<div class="content"> <div class="content">
<div class="ui header"><i class="green check icon"></i>URL Templating built In</div>
<p>API is made for REST. Store your API endpoints with url variables that are replaced at run-time.</p>
<div class="ui header"><i class="green check icon"></i>State Management</div>
<p>Easily tie server events like AJAX loading elements using intuitive defaults based on the context inside your interface. Set maximum <b>and minimum</b> request times, toggle between UI states, and easily sync state between multiple elements with the same API actions.</p>
</div> </div>
</div> </div>
<div class="column"> <div class="column">
@ -70,42 +70,54 @@ type : 'UI Behavior'
</div> </div>
<div class="examples"> <div class="examples">
<h2 class="ui dividing header">Creating an API</h2>
<h2 class="ui dividing header">Defining Your API</h2>
<div class="no example"> <div class="no example">
<h4 class="ui header">Define Your API</h4>
<p><b>API</b> works best by defining named API actions which can be converted to URLs for each request/</p>
<p>To do this you must define your endpoints once in your application before making requests. Usually this is done in a central configuration file included on each page.</p>
<h4 class="ui header">Creating Server Actions</h4>
<p><b>API</b> works best by defining named API actions which can be converted to URLs for each request.</p>
<p>You must define your endpoints once in your application before making requests. Usually this is done in a central configuration file included on each page.</p>
<p>URLs listed in your API can include <b>required parameters</b> and <b>optional parameters</b> which may be adjusted for each call.</p> <p>URLs listed in your API can include <b>required parameters</b> and <b>optional parameters</b> which may be adjusted for each call.</p>
<p><b>Required Parameters</b> will abort the request if they cannot be replaced when triggered.</p>
<p><b>Optional Parameters</b> will be removed from the url if are not included when triggered. In addition, any trailing slashes before an optional parameter will also be removed from the URL, allowing you to include them in resource paths.</p>
<div class="code">
$.fn.api.settings.api = {
'endpoint': 'api/{required}/{/optional}/{/optional2}'
};
<div class="ui relaxed list">
<div class="item">
<div class="header">Required Parameters</div>
<div class="list">
<div class="item">Uses format <code>{variable}</code></div>
<div class="item">Will abort the request if they cannot be found.</div>
</div>
</div>
<div class="item">
<div class="header">Optional Parameters</div>
<div class="list">
<div class="item">Uses format <code>{/variable}</code></div>
<div class="item">Will abort the request if they cannot be found.</div>
<div class="item">Will be removed from the url automatically if not available.</div>
<div class="item">Any trailing slashes before optional parameters will also be removed from the URL, allowing you to include them in resource paths.</div>
</div>
</div>
</div> </div>
<div class="code" data-type="javascript"> <div class="code" data-type="javascript">
/* Define API endpoints once globally */ /* Define API endpoints once globally */
$.fn.api.settings.api = { $.fn.api.settings.api = {
'get user' : '/user/{id}',
'get followers' : '/followers/{id}?results={count}', 'get followers' : '/followers/{id}?results={count}',
'follow user' : '/follow/{id}', 'follow user' : '/follow/{id}',
'add user' : '/add/{id}',
'search' : '/search/?query={value}'
}; };
</div> </div>
</div> </div>
<h2 class="ui dividing header">Calling API Actions</h2>
<h2 class="ui dividing header">Querying API Actions</h2>
<div class="ui info message">
<div class="ui header">Open Your Web Console</div>
The following examples work best while viewing logs in your web console. This experienced is optimized for Firebug, but will also appear in webkit browsers <a href="https://code.google.com/p/chromium/issues/detail?id=306120" target="_blank">with minor issues.</a>
</div>
<div class="ui message">
API requests for the following demos have been faked using <a href="http://sinonjs.org/">SinonJS</a> to avoid rate throttling from public APIs. No actual data is returned.
</div>
<div class="no example"> <div class="no example">
<h4 class="ui header">Automatic Events</h4>
<h4 class="ui header">Attaching API to UI</h4>
<p>Any element can have an API action attached, by default the action will occur on the most relevant event for the type of element. For example a button will use <code>onclick</code> or an input <code>oninput</code>.</p>
<div class="ui info message">
AJAX requests for the following demos have been faked using <a href="http://sinonjs.org/">SinonJS</a> to avoid rate throttling from public APIs.
</div>
<p>Any element can have an API action attached directly to it. By default the action will occur on the most appropriate event for the type of element. For example a button will assume <code>onclick</code> or an input <code>oninput</code>, or a form <code>onsubmit</code>.</p>
<div class="evaluated code"> <div class="evaluated code">
$('.follow.button') $('.follow.button')
@ -117,13 +129,13 @@ type : 'UI Behavior'
</div> </div>
<div class="no example"> <div class="no example">
<h4 class="ui header">Manual Events</h4>
<p>If you need to manually override what action an API event occurs on you can use the <code>on</code> parameter. In addition, using the special parameter <code>on: 'now'</code> will trigger the api event immediately.</p>
<h4 class="ui header">Specifying Events</h4>
<p>If you need to override what action an API event occurs on you can use the <code>on</code> parameter.</p>
<div class="code" data-demo="true"> <div class="code" data-demo="true">
$('.follow.button') $('.follow.button')
.api({ .api({
action: 'get user',
on: 'hover'
action: 'follow user',
on: 'mouseenter'
}) })
; ;
</div> </div>
@ -131,7 +143,8 @@ type : 'UI Behavior'
<div class="no example"> <div class="no example">
<h4 class="ui header">Calling Immediately</h4> <h4 class="ui header">Calling Immediately</h4>
<p>If you need to manually override what action an API event occurs on you can use the <code>on</code> parameter. In addition, using the special parameter <code>on: 'now'</code> will trigger the api event immediately.</p>
<p>If you require API action to occur immediately use <code>on: 'now'</code>. This will still trigger the same state updates to the invoked element, but will occur immediately.</p>
<p>
<div class="code" data-demo="true"> <div class="code" data-demo="true">
$('.follow.button') $('.follow.button')
.api({ .api({
@ -142,20 +155,81 @@ type : 'UI Behavior'
</div> </div>
</div> </div>
<h2 class="ui dividing header">Setting Conditions</h2>
<h2 class="ui dividing header">Providing Data</h2>
<div class="no example"> <div class="no example">
<h4 class="ui header">URL Variables For API Request</h4>
<p>Templated variables set in your API are replaced during your request in three different ways.</p>
<h4 class="ui header">URL Variables</h4>
<p>If your API urls include templated variables they will be replaced during your request by one of four possible ways (listed in order of inheritance).</p>
<div class="ui ignored warning message">
Only variables specified in your URL will be searched for in metadata. Adding metadata attributes will not be automatically included in GET or POST values.
</div>
</div>
<h5 class="ui header">...by Data Attributes</h5>
<p>If many elements trigger a similar function, it is often easiest to include data attribute for each instance with the specific url variables</p>
<div class="no example">
<h4 class="ui header">...automatically Routed Data</h4>
<p>Some useful values are automatically included in every request</p>
<table class="ui definition table">
<thead>
<tr>
<th>Variable</th>
<th>Description</th>
<th>Available for</th>
</tr>
</thead>
<tbody>
<tr>
<td>text</td>
<td>current text value of element</td>
<td>All DOM elements</td>
</tr>
<tr>
<td>value</td>
<td>current input value of element</td>
<td>All input elements</td>
</tr>
</tbody>
</table>
<div class="code" data-preview="true">
<div class="ui search icon input">
<i class="search icon"></i>
<input type="text" class="search">
</div>
</div>
<div class="evaluated code" data-type="javascript">
// replaces /search?query={value}
$('.search input')
.api({
action: 'search',
// this setting will be explained later
stateContext: '.ui.input'
})
;
</div>
</div>
<div class="no example">
<h4 class="ui header">...by Data Attributes</h4>
<p>If many elements trigger a similar function, it is often easiest to include unique url data in each triggering element. For example, many follow buttons will trigger the same endpoint, but each will have its own user id.</p>
<div class="code" data-type="html"> <div class="code" data-type="html">
<div class="ui follow button" data-id="11">Follow User1</div>
<div class="ui follow button" data-id="22">Follow User2</div>
<div class="ui follow button" data-id="11">
User 1
</div>
<div class="ui follow button" data-id="22">
User 2
</div>
</div> </div>
<h5 class="ui header">....in Javascript</h5>
<p>URL variables can be specified at run-time in the javascript object</p>
<div class="code" data-type="javascript">
$('.follow.button')
.api({
action: 'follow user'
})
;
</div>
</div>
<div class="no example">
<h4 class="ui header">....in Javascript</h4>
<p>URL variables can be specified at run-time in the javascript object </p>
<div class="code" data-type="javascript"> <div class="code" data-type="javascript">
$('.follow.button') $('.follow.button')
.api({ .api({
@ -166,7 +240,10 @@ type : 'UI Behavior'
}) })
; ;
</div> </div>
<h5 class="ui header">...returned values from beforeSend Callback</h5>
</div>
<div class="no example">
<h4 class="ui header">...returned values from beforeSend Callback</h4>
<p>In addition all parameters can be adjusted in a special callback <code>beforeSend</code> which occurs, quite intuitively, before the API request is sent.</p> <p>In addition all parameters can be adjusted in a special callback <code>beforeSend</code> which occurs, quite intuitively, before the API request is sent.</p>
<p>You can also use this callback to adjust other settings before each API call</p> <p>You can also use this callback to adjust other settings before each API call</p>
<div class="code" data-type="javascript"> <div class="code" data-type="javascript">
@ -184,22 +261,101 @@ type : 'UI Behavior'
</div> </div>
</div> </div>
<h2 class="ui dividing header">Controlling State</h2>
<div class="no example"> <div class="no example">
<h4 class="ui header">3. Defining UI State</h4>
<h4 class="ui header">UI State</h4>
<p>Many elements like <a href="/elements/button.html">button</a>, <a href="/elements/input.html">input</a>, and <a href="/collections/form.html">form</a> have loading, disabled, and active states defined.</p> <p>Many elements like <a href="/elements/button.html">button</a>, <a href="/elements/input.html">input</a>, and <a href="/collections/form.html">form</a> have loading, disabled, and active states defined.</p>
<div class="ui disabled button">Learn more about states</div>
<p>API will automatically attach a <b>Loading</b> state when an API request is triggered, additional states can be attached using state behaviors, an optional component that couples well with API behaviors.</p>
<p>API will automatically attach a <b>loading</b> state when an API request is triggered, but makes no other assumptions about states.</p>
</div>
<p>If state is initialized, it will automatically apply the class <code>active</code> on API success, and update any text nodes with new values specified.</p>
<div class="no example">
<h4 class="ui header">State Management</h4>
<p>If <code>state()</code> is invoked after an API event is attached to an element, it will automatically toggle an active state on the element after a successful API request.</p>
<p>Basic included states</p>
<table class="ui definition table">
<thead>
<tr>
<th>State</th>
<th>Description</th>
<th>API event</th>
</tr>
</thead>
<tbody>
<tr>
<td>loading</td>
<td>Indicates a user needs to wait</td>
<td>XHR has initialized</td>
</tr>
<tr>
<td>error</td>
<td>Indicates an error has occurred</td>
<td>Request returns error (does not trigger onAbort caused by page change) </td>
</tr>
</tbody>
</table>
</div>
<p>State also includes other states:</p>
<div class="no example">
<h4 class="ui header">UI State</h4>
<p>Invoking state also includes additional states which can adjust text values:</p>
<table class="ui definition table">
<thead>
<tr>
<th>State</th>
<th>Description</th>
<th>Occurs on</th>
</tr>
</thead>
<tbody>
<tr>
<td>inactive</td>
<td>User has not selected</td>
</tr>
<tr>
<td>active</td>
<td>User has selected</td>
<td>Toggled on succesful API request</td>
</tr>
<tr>
<td>activate</td>
<td>Text explaining activating action</td>
<td>On hover if inactive</td>
</tr>
<tr>
<td>deactivate</td>
<td>default state</td>
</tr>
<tr>
<td>hover</td>
<td>Text-only state explaining interaction</td>
<td>On hover if inactive or active</td>
</tr>
<tr>
<td>disabled</td>
<td>Indicates element is disabled</td>
<td>Only triggered programatically</td>
</tr>
<tr>
<td>Flash</td>
<td>Text-only state used to display a temporary message</td>
<td>Only triggered programatically</td>
</tr>
<tr>
<td>Disabled</td>
<td>Cannot receive user interaction</td>
</tr>
</tbody>
</table>
<ul class="ui list"> <ul class="ui list">
<li><b>Inactive</b> - Default state</li> <li><b>Inactive</b> - Default state</li>
<li><b>Active</b> - API request is completed succesfully</li> <li><b>Active</b> - API request is completed succesfully</li>
<li><b>Enable</b> - Text on hover if currently in inactive state</li> <li><b>Enable</b> - Text on hover if currently in inactive state</li>
<li><b>Disable</b> - Text on hover if currently in inactive state</li>
<li><b>Deactivate</b> - Text on hover if currently in active state</li> <li><b>Deactivate</b> - Text on hover if currently in active state</li>
<li><b>Hover</b> - Text appears on hover regardless of state</li> <li><b>Hover</b> - Text appears on hover regardless of state</li>
<li><b>Flash</b> - Text appears on element for time duration set by <code>flashDuration</code> <li><b>Flash</b> - Text appears on element for time duration set by <code>flashDuration</code>
@ -209,34 +365,15 @@ type : 'UI Behavior'
$('.follow.button') $('.follow.button')
.state({ .state({
text: { text: {
inactive : 'Adopt',
active : 'Adopted',
deactivate : 'Undo',
flash : 'Success'
inactive : 'Follow',
active : 'Followed',
deactivate : 'Unfollow',
flash : 'Updated!'
} }
}) })
; ;
</div> </div>
</div> </div>
<div class="no example">
<h4 class="ui header">4. Make sure metadata is set for an element before event occurs</h4>
<p>When an API action occurs, templated url data is replaced with data you specify to be sent to the server.</p>
<div class="code" data-type="html">
<div class="ui adopt button" data-id="5209"></div>
</div>
<div class="ui horizontal divider">Or</div>
<p>Alternatively you can modify the data before sending to server</p>
<div class="code">
$('.adopt.button')
.api('setting', 'beforeSend', function(settings) {
settings.urlData.id = 5209;
return settings;
})
;
</div>
</div>
</div> </div>
</div> </div>

7
server/files/javascript/api.js

@ -1,11 +1,11 @@
/* Define API endpoints once globally */ /* Define API endpoints once globally */
$.fn.api.settings.debug = true; $.fn.api.settings.debug = true;
/* Define API endpoints once globally */
$.fn.api.settings.api = { $.fn.api.settings.api = {
'get user' : '/user/{id}',
'get followers' : '/followers/{id}?results={count}', 'get followers' : '/followers/{id}?results={count}',
'follow user' : '/follow/{id}', 'follow user' : '/follow/{id}',
'add user' : '/add/{id}',
'search' : '/search/?query={value}'
}; };
semantic.api = {}; semantic.api = {};
@ -28,6 +28,9 @@ semantic.api.ready = function() {
server server
.respondWith(/\/follow\/(\d+)/, [responseCode, headers, body]) .respondWith(/\/follow\/(\d+)/, [responseCode, headers, body])
; ;
server
.respondWith(/\/search\/(.*)/, [responseCode, headers, body])
;
}; };

1
server/files/javascript/semantic.js

@ -901,7 +901,6 @@ semantic.ready = function() {
mobileTransition : 'uncover' mobileTransition : 'uncover'
}) })
.sidebar('attach events', '.launch.button, .view-ui, .launch.item') .sidebar('attach events', '.launch.button, .view-ui, .launch.item')
.sidebar('attach events', $hideMenu, 'hide')
; ;
handler.createIcon(); handler.createIcon();

31
server/files/stylesheets/semantic.css

@ -340,6 +340,13 @@ a:hover {
Fixed Columns Fixed Columns
---------------*/ ---------------*/
#example .fixed.column {
position: absolute;
right: 2em;
top: 0px;
width: 300px;
}
#example .tab.header.segment .fixed .tabular.menu { #example .tab.header.segment .fixed .tabular.menu {
position: fixed; position: fixed;
top: 50px; top: 50px;
@ -347,12 +354,8 @@ a:hover {
#example .fixed .launch { #example .fixed .launch {
display: none; display: none;
} }
#example .fixed.column {
position: relative;
}
#example .fixed.column .sticky { #example .fixed.column .sticky {
padding-top: 3em;
padding-top: 4em;
} }
@ -668,8 +671,11 @@ body#example.hide {
} }
#example .intro .example h4 ~ p,
#example .intro .example h4 ~ .ignored {
#example .intro .example > h4 {
font-size: 1.2em;
}
#example .intro .example > h4 ~ p,
#example .intro .example > h4 ~ .ignored {
margin: 1em 0em !important; margin: 1em 0em !important;
font-size: 14px; font-size: 14px;
} }
@ -706,6 +712,9 @@ body#example.hide {
clear: both; clear: both;
visibility: hidden; visibility: hidden;
} }
#example .example-group {
position: relative;
}
#example .main.container .examples > h2, #example .main.container .examples > h2,
#example .main.container > h2, #example .main.container > h2,
#example .main.container > .tab > h2{ #example .main.container > .tab > h2{
@ -1722,23 +1731,21 @@ body.progress.animated .ui.progress .bar {
} }
@media only screen and (max-width : 998px) { @media only screen and (max-width : 998px) {
#example .examples { #example .examples {
margin-right: 220px;
margin-right: 230px;
padding: 1px; padding: 1px;
} }
#example .fixed.column, #example .fixed.column,
#example .fixed.column .fixed { #example .fixed.column .fixed {
float: right;
width: 200px; width: 200px;
} }
} }
@media only screen and (min-width : 998px) { @media only screen and (min-width : 998px) {
#example .examples { #example .examples {
margin-right: 320px;
margin-right: 280px;
padding: 1px; padding: 1px;
} }
#example .fixed.column, #example .fixed.column,
#example .fixed.column .fixed { #example .fixed.column .fixed {
float: right;
width: 300px;
width: 250px;
} }
} }

3
server/layouts/default.html.eco

@ -179,9 +179,6 @@
<body id="example" class="pushable <%= @document.css %>" ontouchstart=""> <body id="example" class="pushable <%= @document.css %>" ontouchstart="">
<div class="ui vertical inverted sidebar menu" id="menu"> <div class="ui vertical inverted sidebar menu" id="menu">
<!-- <a class="hide item">
<i class="close icon"></i> Close Menu
</a> -->
<div class="item"> <div class="item">
<a class="ui logo icon image" href="/"> <a class="ui logo icon image" href="/">
<img src="/images/logo.png"> <img src="/images/logo.png">

17
src/definitions/behaviors/api.js

@ -116,10 +116,12 @@ $.api = $.fn.api = function(parameters) {
module.debug('Request cancelled previous request is still pending'); module.debug('Request cancelled previous request is still pending');
return; return;
} }
// pass element metadata to url (value, text) // pass element metadata to url (value, text)
if(settings.defaultData) { if(settings.defaultData) {
$.extend(true, settings.urlData, module.get.defaultData()); $.extend(true, settings.urlData, module.get.defaultData());
} }
console.log(settings.urlData);
// Add form content // Add form content
if(settings.serializeForm !== false || $module.is('form')) { if(settings.serializeForm !== false || $module.is('form')) {
@ -379,7 +381,7 @@ $.api = $.fn.api = function(parameters) {
errorMessage = response.error; errorMessage = response.error;
} }
} }
catch(er) {
catch(e) {
module.error(error.JSONParse); module.error(error.JSONParse);
} }
} }
@ -742,14 +744,13 @@ $.api.settings = {
// event binding // event binding
on : 'auto', on : 'auto',
filter : '.disabled, .loading',
filter : '.disabled',
context : false, context : false,
stateContext : false, stateContext : false,
// templating // templating
action : false, action : false,
base : false,
url : false,
regExp : { regExp : {
required: /\{\$*[A-z0-9]+\}/g, required: /\{\$*[A-z0-9]+\}/g,
@ -757,12 +758,12 @@ $.api.settings = {
}, },
// data // data
url : false,
urlData : false,
serializeForm : false,
urlData : {},
// ui // ui
defaultData : true, defaultData : true,
serializeForm : false,
throttle : 100, throttle : 100,
allowMultiple : false, allowMultiple : false,
@ -785,7 +786,7 @@ $.api.settings = {
onFailure : function(errorMessage, $module) {}, onFailure : function(errorMessage, $module) {},
onAbort : function(errorMessage, $module) {}, onAbort : function(errorMessage, $module) {},
successText : function(response) { return true; },
successTest : function(response) { return true; },
// errors // errors
error : { error : {

93
src/definitions/behaviors/state.js

@ -14,7 +14,6 @@
$.fn.state = function(parameters) { $.fn.state = function(parameters) {
var var
$allModules = $(this), $allModules = $(this),
settings = $.extend(true, {}, $.fn.state.settings, parameters),
moduleSelector = $allModules.selector || '', moduleSelector = $allModules.selector || '',
@ -26,27 +25,29 @@ $.fn.state = function(parameters) {
methodInvoked = (typeof query == 'string'), methodInvoked = (typeof query == 'string'),
queryArguments = [].slice.call(arguments, 1), queryArguments = [].slice.call(arguments, 1),
// shortcuts
error = settings.error,
metadata = settings.metadata,
className = settings.className,
namespace = settings.namespace,
states = settings.states,
text = settings.text,
eventNamespace = '.' + namespace,
moduleNamespace = namespace + '-module',
returnedValue returnedValue
; ;
$allModules $allModules
.each(function() { .each(function() {
var var
$module = $(this),
settings = ( $.isPlainObject(parameters) )
? $.extend(true, {}, $.fn.state.settings, parameters)
: $.extend({}, $.fn.state.settings),
error = settings.error,
metadata = settings.metadata,
className = settings.className,
namespace = settings.namespace,
states = settings.states,
text = settings.text,
eventNamespace = '.' + namespace,
moduleNamespace = namespace + '-module',
element = this,
instance = $module.data(moduleNamespace),
$module = $(this),
element = this,
instance = $module.data(moduleNamespace),
module module
; ;
@ -197,6 +198,7 @@ $.fn.state = function(parameters) {
module.refresh(); module.refresh();
if($.fn.api !== undefined) { if($.fn.api !== undefined) {
apiRequest = $module.api('get request'); apiRequest = $module.api('get request');
console.log(apiRequest, $module);
if(apiRequest) { if(apiRequest) {
module.listenTo(apiRequest); module.listenTo(apiRequest);
return; return;
@ -265,19 +267,19 @@ $.fn.state = function(parameters) {
module.verbose('Changing text to hover text', text.hover); module.verbose('Changing text to hover text', text.hover);
module.update.text(text.hover); module.update.text(text.hover);
} }
else if(text.disable) {
module.verbose('Changing text to disable text', text.disable);
module.update.text(text.disable);
else if(text.deactivate) {
module.verbose('Changing text to deactivating text', text.deactivate);
module.update.text(text.deactivate);
} }
} }
else { else {
if(text.hover) { if(text.hover) {
module.verbose('Changing text to hover text', text.disable);
module.verbose('Changing text to hover text', text.hover);
module.update.text(text.hover); module.update.text(text.hover);
} }
else if(text.enable){
module.verbose('Changing text to enable text', text.enable);
module.update.text(text.enable);
else if(text.activate){
module.verbose('Changing text to activating text', text.activate);
module.update.text(text.activate);
} }
} }
} }
@ -400,27 +402,22 @@ $.fn.state = function(parameters) {
setting: function(name, value) { setting: function(name, value) {
module.debug('Changing setting', name, value); module.debug('Changing setting', name, value);
if(value !== undefined) {
if( $.isPlainObject(name) ) {
$.extend(true, settings, name);
}
else {
settings[name] = value;
}
if( $.isPlainObject(name) ) {
$.extend(true, settings, name);
}
else if(value !== undefined) {
settings[name] = value;
} }
else { else {
return settings[name]; return settings[name];
} }
}, },
internal: function(name, value) { internal: function(name, value) {
module.debug('Changing internal', name, value);
if(value !== undefined) {
if( $.isPlainObject(name) ) {
$.extend(true, module, name);
}
else {
module[name] = value;
}
if( $.isPlainObject(name) ) {
$.extend(true, module, name);
}
else if(value !== undefined) {
module[name] = value;
} }
else { else {
return module[name]; return module[name];
@ -488,9 +485,6 @@ $.fn.state = function(parameters) {
if(moduleSelector) { if(moduleSelector) {
title += ' \'' + moduleSelector + '\''; title += ' \'' + moduleSelector + '\'';
} }
if($allModules.size() > 1) {
title += ' ' + '(' + $allModules.size() + ')';
}
if( (console.group !== undefined || console.table !== undefined) && performance.length > 0) { if( (console.group !== undefined || console.table !== undefined) && performance.length > 0) {
console.groupCollapsed(title); console.groupCollapsed(title);
if(console.table) { if(console.table) {
@ -538,6 +532,7 @@ $.fn.state = function(parameters) {
return false; return false;
} }
else { else {
module.error(error.method, query);
return false; return false;
} }
}); });
@ -560,6 +555,7 @@ $.fn.state = function(parameters) {
return found; return found;
} }
}; };
if(methodInvoked) { if(methodInvoked) {
if(instance === undefined) { if(instance === undefined) {
module.initialize(); module.initialize();
@ -572,7 +568,6 @@ $.fn.state = function(parameters) {
} }
module.initialize(); module.initialize();
} }
}) })
; ;
@ -680,13 +675,13 @@ $.fn.state.settings = {
}, },
text : { text : {
disabled : false,
flash : false,
hover : false,
active : false,
inactive : false,
enable : false,
disable : false
disabled : false,
flash : false,
hover : false,
active : false,
inactive : false,
activate : false,
deactivate : false
} }
}; };

Loading…
Cancel
Save