Just AngularJS
Ruby JavaScript CoffeeScript
Pull request Compare This branch is 54 commits behind ets-berkeley-edu:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
script
test
vendor/assets/javascripts
.gitignore
.travis.yml
CHANGELOG.md
Gemfile
Gemfile.lock
MAINTAINERS.md
MIT-LICENSE
README.md
Rakefile
TODO.md
angular-gem.gemspec

README.md

Angular-Gem - Just AngularJS

Gem Version Build Status Dependency Status Code Climate Coverage Status

This project lets you use AngularJS with the Rails 3.x asset pipeline. It was forked from the angular-rails gem, since the project seems to have been abandoned and there's been a need to keep angularjs up to date within our own internal projects. The version number will by default track the unstable branch, although there are plans to always have both the latest stable and unstable versions available. Looking inside the vendor folder should give you an idea of what's available.

Getting Started

Add the gem to your application Gemfile:

gem "angular-gem"

Run bundle install. To bootstrap things, run:

rails g angular:install

Specifying versions

  • By default, this gem will include the latest stable version of angular with //require angular in your application. file.
  • You can switch to using the latest unstable version by pointing to //require angular-unstable.
  • You can also force specific versions to be loaded with //require <VERSION>/angular-<VERSION>, assuming the source files exist somewhere in the gem.

Internationalization support

  • Internationalization (i18n) files are bundled in starting from gem version 1.1.5. You will need to specify the version of the gem you are using currently in your paths though, like so: //require 1.1.5/i18n/angular-locale_de

Layout and namespacing

Running rails g angular:install will create the following directory structure under app/assets/javascripts/angular:

controllers/
filters/
services/
widgets/

It will also generate a templates/ directory under app assets, where view templates can be stored. This lets you use haml, etc. for your angular views.

It will also add to the application.js file the appropriate requires.

Generators

angular-rails provides a simple generator to help get you started using angular.js with rails 3.1. The generators will only create client side code (javascript).

So far we have a controller generator which generates a controller file if you rum

rails g angular:controller MODELNAME

This file is empty except for the class declaration, but I will be adding some RESTful controller functionality shortly.