aboutsummaryrefslogtreecommitdiffstats
path: root/guides/source/action_view_overview.md
diff options
context:
space:
mode:
authorSean Collins <sean@cllns.com>2015-09-23 13:57:52 -0600
committerSean Collins <sean@cllns.com>2015-09-23 13:57:52 -0600
commit961779997cb28750d52d6186b41c29c33677ae0f (patch)
tree53a6e5a606f92a0f8f5920823d6270c51277b7f3 /guides/source/action_view_overview.md
parent4cf449df9136117f2f0acf9730bf754f889f4dfa (diff)
downloadrails-961779997cb28750d52d6186b41c29c33677ae0f.tar.gz
rails-961779997cb28750d52d6186b41c29c33677ae0f.tar.bz2
rails-961779997cb28750d52d6186b41c29c33677ae0f.zip
Add note about Jbuilder
[skip ci]
Diffstat (limited to 'guides/source/action_view_overview.md')
-rw-r--r--guides/source/action_view_overview.md33
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.