luca 0.9.4 → 0.9.6

data/src/components/fields/checkbox_field.coffee

@@ -31,7 +31,7 @@ _.def('Luca.fields.CheckboxField').extends('Luca.core.Field').with
     @label ||= @name
 
   setValue: (checked)->
-    @input.attr('checked', checked)
+    @getInputElement().attr('checked', checked)
 
   getValue:()->
-    @input.is(":checked")
+    @getInputElement().is(":checked")

data/src/components/fields/file_upload_field.coffee

@@ -2,9 +2,6 @@ _.def('Luca.fields.FileUploadField').extends('Luca.core.Field').with
 
   template: 'fields/file_upload_field'
 
-  initialize: (@options={})->
-    Luca.core.Field::initialize.apply @, arguments
-
   afterInitialize: ()->
     @input_id ||= _.uniqueId('field')
     @input_name ||= @name

data/src/components/fields/hidden_field.coffee

@@ -2,9 +2,6 @@ _.def('Luca.fields.HiddenField').extends('Luca.core.Field').with
 
   template: 'fields/hidden_field'
 
-  initialize: (@options={})->
-    Luca.core.Field::initialize.apply @, arguments
-
   afterInitialize: ()->
     @input_id ||= _.uniqueId('field')
     @input_name ||= @name

data/src/components/fields/label_field.coffee

@@ -1,14 +1,11 @@
 _.def("Luca.components.LabelField").extends("Luca.core.Field").with
   className: "luca-ui-field luca-ui-label-field"
     
-  getValue: ()->
-    @$('input').attr('value')
-
   formatter: (value)->
     value ||= @getValue()
     _.str.titleize( value )
 
   setValue: (value)->
     @trigger("change", value, @getValue())
-    @$('input').attr('value', value)
+    @getInputElement().attr('value', value)
     @$('.value').html( @formatter(value) )

data/src/components/fields/select_field.coffee

@@ -57,9 +57,10 @@ _.def('Luca.fields.SelectField').extends('Luca.core.Field').with
 
       hash
 
-  afterRender: ()->
-    @input = $('select', @el)
+  getInputElement: ()->
+    @input ||= @$('select').eq(0)
 
+  afterRender: ()->
     if @collection?.models?.length > 0
       @populateOptions()
     else
@@ -76,11 +77,10 @@ _.def('Luca.fields.SelectField').extends('Luca.core.Field').with
     @trigger "on:change", @, e
 
   resetOptions: ()->
-    @input.html('')
+    @getInputElement().html('')
 
     if @includeBlank
-      @input.append("<option value='#{ @blankValue }'>#{ @blankText }</option>")
-
+      @getInputElement().append("<option value='#{ @blankValue }'>#{ @blankText }</option>")
 
   populateOptions: ()->
     @resetOptions()
@@ -91,7 +91,7 @@ _.def('Luca.fields.SelectField').extends('Luca.core.Field').with
         display = model.get( @displayField )
         selected = "selected" if @selected and value is @selected
         option = "<option #{ selected } value='#{ value }'>#{ display }</option>"
-        @input.append( option )
+        @getInputElement().append( option )
 
     @trigger "after:populate:options", @
     @setValue( @currentValue )

data/src/components/fields/text_area_field.coffee

@@ -19,6 +19,7 @@ _.def('Luca.fields.TextAreaField').extends('Luca.core.Field').with
     @input_name ||= @name
     @label ||= @name
     @input_class ||= @class
+    @input_value ||= ""
     @inputStyles ||= "height:#{ @height };width:#{ @width }"
 
   setValue: (value)->

data/src/components/fields/text_field.coffee

@@ -21,7 +21,11 @@ _.def('Luca.fields.TextField').extends('Luca.core.Field').with
     @input_name ||= @name
     @label ||= @name
     @input_class ||= @class
+    @input_value ||= @value || "" 
 
+    # TODO
+    # Placeholder?
+    
     if @prepend
       @$el.addClass('input-prepend')
       @addOn = @prepend

data/src/components/fields/type_ahead_field.coffee

@@ -2,21 +2,17 @@ _.def('Luca.fields.TypeAheadField').extends('Luca.fields.TextField').with
   className: 'luca-ui-field'
 
   getSource: ()->
-    return @source.call(@) if _.isFunction(@source)
-    @source || []
+    Luca.util.read(@source) || []
 
   matcher: (item)->
-    # IMPLEMENT
-    # return true where item matches @query
     true
 
   beforeRender: ()->
-    @_super("beforeRender", @, arguments)
-    @$('input').attr('data-provide','typeahead')
+    Luca.fields.TextField::beforeRender.apply(@, arguments)
+    @getInputElement().attr('data-provide','typeahead')
 
   afterRender: ()->
-    @_super("afterRender", @, arguments)
-
-    @$('input').typeahead
+    Luca.fields.TextField::afterRender.apply(@, arguments)
+    @getInputElement().typeahead
       matcher: @matcher
       source: @getSource()

data/src/components/form_view.coffee

@@ -54,6 +54,8 @@ _.def("Luca.components.FormView").extends('Luca.core.Container').with
 
     Luca.core.Container::initialize.apply @, arguments
 
+    @components ||= @fields
+
     _.bindAll @, "submitHandler", "resetHandler", "renderToolbars", "applyLoadMask"
 
     @state ||= new Backbone.Model

data/src/components/index.coffee

@@ -0,0 +1 @@
+#= require_tree .

data/src/components/multi_collection_view.coffee

@@ -0,0 +1,94 @@
+multiView = Luca.define     "Luca.components.MultiCollectionView"
+
+# The CollectionMultiView is a collection view with multiple renderings
+# of the list.  ( e.g. Icons, Table, List ).  It works by maintaining
+# a current view, and rendering that view.  It refreshes the views
+# whenever they are activated. 
+#
+# The MultiView allows you to share one collection, filter, pagination setup
+# but render multiple versions of a model.  To do this, you  are expected to
+# define one or more objects in the @views property of the component.
+
+# Example:
+#   multiView = new Luca.components.MultiCollectionView
+#     collection: "my_collection"
+#     paginatable:
+#       page: 1
+#       limit: 20
+#     views:[
+#       type:           "table"
+#       columns:[
+#         header: "Header"
+#         reader: "attribute"
+#       ]
+#     ]
+multiView.extends           "Luca.containers.CardView"
+
+multiView.behavesAs         "LoadMaskable",
+                            "Filterable",
+                            "Paginatable"
+
+multiView.triggers          "before:refresh",
+                            "after:refresh",
+                            "refresh",
+                            "empty:results"
+
+multiView.defaultsTo
+  version: 1
+
+  stateful: true
+
+  defaultState:
+    activeView: 0
+
+  viewContainerClass: "luca-ui-multi-view-container"
+
+  initialize: (@options={})->
+    @components ||= @views
+
+    validateComponent( view ) for view in @components    
+
+    @on "collection:change", @refresh, @
+    @on "after:card:switch", @refresh, @
+    @on "before:components", propagateCollectionComponents, @
+    @on "after:components", bubbleCollectionEvents, @
+
+    Luca.containers.CardView::initialize.apply(@, arguments) 
+
+  refresh: ()->
+    @activeComponent()?.trigger("refresh")
+
+  getQuery: Luca.components.CollectionView::getQuery
+  getQueryOptions: Luca.components.CollectionView::getQueryOptions
+  getCollection: Luca.components.CollectionView::getCollection
+  
+#### Private Helpers
+
+bubbleCollectionEvents = ()->
+  container = @
+  container.eachComponent (component)->
+    for eventId in ['refresh','before:refresh','after:refresh','empty:results']
+      component.on eventId, ()->
+        if component is container.activeComponent()
+          container.trigger(eventId)
+
+propagateCollectionComponents = ()->
+  container = @
+
+  # in the multi view will share the same
+  # collection, filter state, pagination options, etc
+  for component in @components
+    _.extend component, 
+      collection: container.getCollection?() || @collection 
+      getQuery: container.getQuery
+      getQueryOptions: container.getQueryOptions
+
+validateComponent = (component)->
+  type = (component.type || component.ctype)
+
+  return if  type is "collection" or 
+             type is "collection_view" or
+             type is "table" or
+             type is "table_view" 
+
+  throw "The MultiCollectionView expects to contain multiple collection views" 

data/src/components/pagination_control.coffee

@@ -0,0 +1,100 @@
+paginationControl = Luca.register   "Luca.components.PaginationControl"
+
+paginationControl.extends           "Luca.View"
+
+paginationControl.defines
+  template: "components/pagination"
+
+  stateful: true
+
+  autoBindEventHandlers: true
+
+  events: 
+    "click a[data-page-number]" : "selectPage"
+    "click a.next"              : "nextPage"
+    "click a.prev"              : "previousPage"  
+
+  afterInitialize: ()->
+    _.bindAll @, "refresh"
+
+    @state.on("change", @refresh, @)
+
+  limit: ()->
+    parseInt (@state.get('limit') || @collection?.length)
+
+  page: ()->
+    parseInt (@state.get('page') || 1)
+
+  nextPage: ()->
+    return unless @nextEnabled()
+    @state.set('page', @page() + 1 )
+
+  previousPage: ()->
+    return unless @previousEnabled()
+    @state.set('page', @page() - 1 )
+
+  selectPage: (e)->
+    me = my = @$( e.target )
+    me = my = my.closest('a.page') unless me.is('a.page') 
+
+    my.siblings().removeClass('is-selected')
+    me.addClass('is-selected')
+
+    @setPage( my.data('page-number') )
+
+  setPage: (page=1,options={})->
+    @state.set('page', page, options)
+
+  setLimit: (limit=1,options={})->
+    @state.set('limit', limit, options)
+
+  pageButtonContainer: ()->
+    @$ '.group'
+  
+  previousEnabled: ()->
+    @page() > 1  
+
+  nextEnabled: ()->
+    @page() < @totalPages()
+
+  previousButton: ()->
+    @$ 'a.page.prev'
+
+  nextButton: ()->
+    @$ 'a.page.next'
+
+  pageButtons: ()->
+    @$ 'a[data-page-number]', @pageButtonContainer()  
+
+  refresh: ()->
+    @pageButtonContainer().empty()
+
+    for page in [1..@totalPages()]
+      button = @make("a","data-page-number":page, class:"page", page )
+      @pageButtonContainer().append(button) 
+
+    @toggleNavigationButtons()
+    @selectActivePageButton()
+
+    @
+
+  toggleNavigationButtons: ()->
+    @$('a.next, a.prev').addClass('disabled')
+    @nextButton().removeClass('disabled') if @nextEnabled()
+    @previousButton().removeClass('disabled') if @previousEnabled()
+
+  selectActivePageButton: ()->
+    @activePageButton().addClass('is-selected')
+
+  activePageButton: ()->
+    @pageButtons().filter("[data-page-number='#{ @page() }']")
+
+  totalPages: ()->
+    parseInt( Math.ceil(@totalItems() / @itemsPerPage()) )
+
+  totalItems: ()->
+    parseInt @collection?.length || 0
+
+  itemsPerPage: (value, options={})-> 
+    @state.set("limit", value, options) if value?
+    parseInt @state.get("limit")

data/src/components/table_view.coffee

@@ -0,0 +1,62 @@
+# Public: TableView renders collection data into an HTML table.
+_.def("Luca.components.TableView").extends("Luca.components.CollectionView").with
+  additionalClassNames: "table"
+  tagName: "table"
+  bodyTemplate: "table_view"
+  bodyTagName: "tbody"
+  bodyClassName: "table-body"
+  itemTagName: "tr"
+  stateful: true
+  observeChanges: true
+
+  columns:[]
+
+  emptyText: "There are no results to display"
+
+  itemRenderer: (item, model)->
+    Luca.components.TableView.rowRenderer.call(@, item, model)
+
+  initialize: (@options={})->
+    Luca.components.CollectionView::initialize.apply(@, arguments)
+
+    @columns = for column in @columns
+      if _.isString(column)
+        column = reader: column
+
+      if !column.header?
+        column.header = _.str.titleize(_.str.humanize(column.reader))
+
+      column
+
+    @defer ()=> 
+      Luca.components.TableView.renderHeader.call(@, @columns, @$('thead') )
+    .until("after:render")
+
+make = Backbone.View::make
+
+Luca.components.TableView.renderHeader = (columns, targetElement)->
+  index = 0
+
+  content = for column in columns
+    "<th data-col-index='#{ index++ }'>#{ column.header }</th>"
+
+  @$( targetElement ).append("<tr>#{ content.join('') }</tr>")
+
+  index = 0
+
+  for column in columns when column.width?
+    @$("th[data-col-index='#{ index++ }']",targetElement).css('width', column.width)
+
+
+Luca.components.TableView.rowRenderer = (item, model, index)->
+  colIndex = 0
+  for columnConfig in @columns
+    Luca.components.TableView.renderColumn.call(@, columnConfig, item, model, colIndex++) 
+
+Luca.components.TableView.renderColumn = (column, item, model, index)->
+  cellValue = model.read( column.reader )
+
+  if _.isFunction( column.renderer )
+    cellValue = column.renderer.call @, cellValue, model, column 
+
+  make("td", {"data-col-index":index}, cellValue)

data/src/containers/card_view.coffee

@@ -1,5 +1,28 @@
-_.def("Luca.containers.CardView").extends("Luca.core.Container").with
-  componentType: 'card_view'
+component = Luca.define         "Luca.containers.CardView"
+component.extends               "Luca.core.Container"
+#
+# The CardView is a type of Container which has many sub-views
+# which are only going to be visible one at a time.  A CardView
+# allows you to @activate() its cards, navigate through them using
+# @next(), @previous(), @cycle()
+#
+# Example:
+#   cardView = new Luca.containers.CardView
+#     cards:[
+#       getter: "getCardOne"
+#       type: "my_component"
+#       name: "one"
+#     ,
+#       getter: "getCardTwo"
+#       type: "my_component"
+#       name: "two"
+#     ]
+#
+#   cardView.activeComponent().name # => "one"
+#   cardView.activate('two')
+#   cardView.activeComponent().name # => "two"
+#
+component.defaults
 
   className: 'luca-ui-card-view-wrapper'
 
@@ -18,15 +41,12 @@ _.def("Luca.containers.CardView").extends("Luca.core.Container").with
   initialize: (@options)->
     Luca.core.Container::initialize.apply @,arguments
     @setupHooks(@hooks)
+    @components ||= @pages ||= @cards 
 
   prepareComponents: ()->
     Luca.core.Container::prepareComponents?.apply(@, arguments)
-
-    _( @components ).each (component,index)=>
-      if index is @activeCard
-        $( component.container ).show()
-      else
-        $( component.container ).hide()
+    @componentElements().hide()
+    @activeComponentElement().show()
 
   activeComponentElement: ()->
     @componentElements().eq( @activeCard )
@@ -39,12 +59,25 @@ _.def("Luca.containers.CardView").extends("Luca.core.Container").with
 
     containerEl
 
+  atFirst: ()->
+    @activeCard is 0
+
+  atLast: ()->
+    @activeCard is @components.length - 1
+
+  next: ()->
+    return if @atLast()
+    @activate( @activeCard + 1)
+
+  previous: ()->   
+    return if @atFirst()
+    @activate( @activeCard - 1)
+
   cycle: ()->
-    nextIndex = if @activeCard < @components.length - 1 then @activeCard + 1 else 0
+    nextIndex = if @atLast() then 0 else @activeCard + 1
     @activate( nextIndex )
 
-  find: (name)->
-    @findComponentByName(name,true)
+  find: (name)-> Luca(name)
 
   firstActivation: ()->
     @activeComponent().trigger "first:activation", @, @activeComponent()