lotus-view 0.4.0 → 0.4.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +4 -0
- data/README.md +40 -0
- data/lib/lotus/view/rendering/layout_scope.rb +47 -0
- data/lib/lotus/view/version.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA1:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: b321d4151a1e0e2117595364a5ced056dd1e392f
|
|
4
|
+
data.tar.gz: 3632ba288305a3e5c872bab66bef57be6bf24dd0
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 9f28b9f392d7a31f577fdd5cc8a9ee3afaedf3aef95db0525768aad3d4dd3505d4719a5ed46ba9483e267c7c57ab9f0730956c6a98ec95c7c8946c6f98d5773d
|
|
7
|
+
data.tar.gz: 5c82053e74076b8ab8e159efdd5ee51702a23f6fb37fd422ca29f7c0bb2ec4f23620af53279ea7d1cfbbb9b9b0312686286501fe7e2e2954828db35abd58b1e0
|
data/CHANGELOG.md
CHANGED
|
@@ -1,6 +1,10 @@
|
|
|
1
1
|
# Lotus::View
|
|
2
2
|
View layer for Lotus
|
|
3
3
|
|
|
4
|
+
## v0.4.1 - 2015-05-22
|
|
5
|
+
### Added
|
|
6
|
+
- [Luca Guidi] Introduced `#content` to render optional contents in a different context (eg. a view sets a page specific javascript in the application template footer).
|
|
7
|
+
|
|
4
8
|
## v0.4.0 - 2015-03-23
|
|
5
9
|
### Changed
|
|
6
10
|
- [Luca Guidi] Autoescape concrete and virtual methods from presenters
|
data/README.md
CHANGED
|
@@ -470,6 +470,46 @@ Articles::Index.render(format: :rss) # => Will use nothing
|
|
|
470
470
|
|
|
471
471
|
As per convention, layout templates are located under `Lotus::View.root` or `ApplicationLayout.root` and use the underscored name (eg. `ApplicationLayout => application.html.erb`).
|
|
472
472
|
|
|
473
|
+
### Optional Content
|
|
474
|
+
|
|
475
|
+
If we want to render optional contents such as sidebar links or page specific javascripts, we can use `#content`
|
|
476
|
+
It accepts a key that represents a method that should be available within the rendering context.
|
|
477
|
+
That context is made of the locals, and the methods that view and layout respond to.
|
|
478
|
+
If the context can't dispatch that method, it returns `nil`.
|
|
479
|
+
|
|
480
|
+
Given the following layout template.
|
|
481
|
+
|
|
482
|
+
```erb
|
|
483
|
+
<!doctype HTML>
|
|
484
|
+
<html>
|
|
485
|
+
<!-- ... -->
|
|
486
|
+
<body>
|
|
487
|
+
<!-- ... -->
|
|
488
|
+
<%= content :footer %>
|
|
489
|
+
</body>
|
|
490
|
+
</html>
|
|
491
|
+
```
|
|
492
|
+
|
|
493
|
+
We have two views, one responds to `#footer` (`Products::Show`) and the other doesn't (`Products::Index`).
|
|
494
|
+
When the first is rendered, `content` gives back the returning value of `#footer`.
|
|
495
|
+
In the other case, `content` returns `nil`.
|
|
496
|
+
|
|
497
|
+
```ruby
|
|
498
|
+
module Products
|
|
499
|
+
class Index
|
|
500
|
+
include Lotus::View
|
|
501
|
+
end
|
|
502
|
+
|
|
503
|
+
class Show
|
|
504
|
+
include Lotus::View
|
|
505
|
+
|
|
506
|
+
def footer
|
|
507
|
+
"contents for footer"
|
|
508
|
+
end
|
|
509
|
+
end
|
|
510
|
+
end
|
|
511
|
+
```
|
|
512
|
+
|
|
473
513
|
### Presenters
|
|
474
514
|
|
|
475
515
|
The goal of a presenter is to wrap and reuse presentational logic for an object.
|
|
@@ -111,6 +111,53 @@ module Lotus
|
|
|
111
111
|
@locals || @scope.locals
|
|
112
112
|
end
|
|
113
113
|
|
|
114
|
+
# Returns a content for the given key, by trying to invoke on the current
|
|
115
|
+
# scope, a method with the same name.
|
|
116
|
+
#
|
|
117
|
+
# The scope is made of locals and concrete methods from view and layout.
|
|
118
|
+
#
|
|
119
|
+
# @param key [Symbol] a method to invoke within current scope
|
|
120
|
+
# @return [String,NilClass] returning content if scope respond to the
|
|
121
|
+
# requested method
|
|
122
|
+
#
|
|
123
|
+
# @since 0.4.1
|
|
124
|
+
#
|
|
125
|
+
# @example
|
|
126
|
+
# # Given the following layout template
|
|
127
|
+
#
|
|
128
|
+
# <!doctype HTML>
|
|
129
|
+
# <html>
|
|
130
|
+
# <!-- ... -->
|
|
131
|
+
# <body>
|
|
132
|
+
# <!-- ... -->
|
|
133
|
+
# <%= content :footer %>
|
|
134
|
+
# </body>
|
|
135
|
+
# </html>
|
|
136
|
+
#
|
|
137
|
+
# # Case 1:
|
|
138
|
+
# # Products::Index doesn't respond to #footer, content will return nil
|
|
139
|
+
# #
|
|
140
|
+
# # Case 2:
|
|
141
|
+
# # Products::Show responds to #footer, content will send back
|
|
142
|
+
# # #footer returning value
|
|
143
|
+
#
|
|
144
|
+
# module Products
|
|
145
|
+
# class Index
|
|
146
|
+
# include Lotus::View
|
|
147
|
+
# end
|
|
148
|
+
#
|
|
149
|
+
# class Show
|
|
150
|
+
# include Lotus::View
|
|
151
|
+
#
|
|
152
|
+
# def footer
|
|
153
|
+
# "contents for footer"
|
|
154
|
+
# end
|
|
155
|
+
# end
|
|
156
|
+
# end
|
|
157
|
+
def content(key)
|
|
158
|
+
__send__(key) if respond_to?(key)
|
|
159
|
+
end
|
|
160
|
+
|
|
114
161
|
# Implements "respond to" logic
|
|
115
162
|
#
|
|
116
163
|
# @return [TrueClass,FalseClass]
|
data/lib/lotus/view/version.rb
CHANGED
metadata
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: lotus-view
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.4.
|
|
4
|
+
version: 0.4.1
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Luca Guidi
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: bin
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date: 2015-
|
|
11
|
+
date: 2015-05-22 00:00:00.000000000 Z
|
|
12
12
|
dependencies:
|
|
13
13
|
- !ruby/object:Gem::Dependency
|
|
14
14
|
name: tilt
|