diff options
author | Sean Collins <sean@cllns.com> | 2015-09-23 13:57:52 -0600 |
---|---|---|
committer | Sean Collins <sean@cllns.com> | 2015-09-23 13:57:52 -0600 |
commit | 961779997cb28750d52d6186b41c29c33677ae0f (patch) | |
tree | 53a6e5a606f92a0f8f5920823d6270c51277b7f3 | |
parent | 4cf449df9136117f2f0acf9730bf754f889f4dfa (diff) | |
download | rails-961779997cb28750d52d6186b41c29c33677ae0f.tar.gz rails-961779997cb28750d52d6186b41c29c33677ae0f.tar.bz2 rails-961779997cb28750d52d6186b41c29c33677ae0f.zip |
Add note about Jbuilder
[skip ci]
-rw-r--r-- | guides/source/action_view_overview.md | 33 |
1 files changed, 33 insertions, 0 deletions
diff --git a/guides/source/action_view_overview.md b/guides/source/action_view_overview.md index 00c41a480e..d3c0a3666f 100644 --- a/guides/source/action_view_overview.md +++ b/guides/source/action_view_overview.md @@ -147,6 +147,39 @@ xml.rss("version" => "2.0", "xmlns:dc" => "http://purl.org/dc/elements/1.1/") do end ``` +#### Jbuilder +<a href="https://github.com/rails/jbuilder">Jbuilder</a> is a gem that's +maintained by the Rails team and included in the default Rails Gemfile. +It's similar to Builder, but is used to generate JSON, instead of XML. + +If you don't have it, you can add the following to your Gemfile: + +```ruby +gem 'jbuilder' +``` + +A Jbuilder object named `json` is automatically made available to templates with +a `.jbuilder` extension. + +Here is a basic example: + +```ruby +json.name("Alex") +json.email("alex@example.com") +``` + +would produce: + +```json +{ + "name": "Alex", + "email: "alex@example.com" +} +``` + +See the <a href="https://github.com/rails/jbuilder#jbuilder"> +Jbuilder documention</a> for more examples and information. + #### Template Caching By default, Rails will compile each template to a method in order to render it. When you alter a template, Rails will check the file's modification time and recompile it in development mode. |