nodulator-angular

Nodulator-Angular

Angular for Nodulator. Provides class for angular's directives, services, controllers and factories. Allow inheritance of angular behaviour, and automatic link between services and Resources (socket.io)

Needs Nodulator-Assets.

Usage

Node side

    Nodulator = require 'Nodulator'
    Assets = require 'Nodulator-assets'
    Angular = require 'Nodulator-angular'

    # Default config, can be erased
    Nodulator.Config
      servicesPath: '/client/services'
      directivesPath: '/client/directives'
      controllersPath: '/client/controllers'
      factoriesPath: '/client/factories'

    # Required for Angular module to work
    Nodulator.Use Assets

    Nodulator.Use Angular

    Nodulator.Run()

Client side

---

Base

Services

Services can be created easely. First Nodulator.Service() argument is the service name. Nodulator will append 'Service' at the end of this name. For a service name 'test', its real name will be 'testService' Latter arguments are for dependency injection. Each one will be added to class :

    class TestService extends Nodulator.Service 'test', '$http'

      Test: ->
        console.log 'Test'
        @$http.get(...);

    #Init only if you want to actualy create the service.
    #Omit if you only want to inherit from it.
    TestService.Init()

Directives

For the moment, every directive is {restrict: 'E'}, and cannot be manualy configurated. (Except if you want to override Directive._Body() behaviour) Again, first argument is the directive name, and the latters are for dependencies injections.

For directive test, it will look for template in config.viewPath for file of same name (test.jade for exemple)

The context of the class will be attached to angular scope. This way, the following directive...

    class TestDirective extends Nodulator.Directive 'test', 'testService'

      lol: 'mdr'

      Lol: ->
        @lol = 'lol'
        @testService.Test()

    TestDirective.Init()

... become ...

    app.directive 'test', ['testService', (testService) ->
      return {

        restrict: 'E'

        templateUrl: 'test-tpl'

        link: (scope, element, attrs) ->

          scope.testService = testService

          scope.lol = 'mdr'

          scope.Lol = ->
            scope.lol = 'lol'
            scope.testService.Test()

      }
    ]

Nice uh ? Beware, don't put to many things in your sister the injections, they will be in the scope !

You can also use compile instead of link by defining a @Pre() and/or a @Post() method.

    class TestDirective extends Nodulator.Directive 'test'

      Pre: ->
        @name = 'test'

      Post: ->
        @value = ''

        @test = ->
            @value = 'lol'

    TestDirective.Init()

Factories

Just as Services, factories are easy to declare :

    class TestFactory extends Nodulator.Factory 'test', '$http'

      Test: ->
        console.log 'Test'
        @$http.get(...);

    TestFactory.Init()

Controllers

Controllers are not implemented now (Houuuu !)

---

Extended

Socket

A socket is a Nodulator.Factory implementing Socket.io For the moment, a socket is always instanciated in each project. Future configuration will be disponible.

A socket has 2 methods : @On() and @Emit(), and apply changes to scope automaticaly.

ResourceService

A Nodulator.ResourceService inherits from Nodulator.Service and inject automatically $http and socket. Also, it binds the socket to listen to the server Resource with the same name. It provides 5 methods :

    class TestService extends Nodulator.ResourceService 'test'

        OnNew: (item) ->
          # Called when a new resource instance is created
        OnUpdate: (item) ->
          # When a resource instance is updated
        OnDelete: (item) ->
          # When a resource is deleted

        FetchAll: (done) ->
          # Put every records in @list

        Fetch: (id, done) ->
          # Fetch particular model and put it in @current