NAME
widgetz.rb
SYNOPSIS
simple widgets for rails
INSTALL
gem install widgetz
URIS
http://rubyforge.org/projects/codeforpeople/
http://codeforpeople.com/lib/ruby/widgetz/
http://drawohara.tumblr.com/post/6060120
DESCRIPTION
widgetz.rb aims to fix two problems with factoring and abstracting
html
generation in rails using the normal ''helper'' methodolgy:
1) helper methods are purely procedural and provide no state.
ruby is an
object oriented language and we like to use objects to abstract
things
where possible. widgetz lets you do just that. some people
call this
encapsulation.
2) by using the normal rendering chain in rails, widgetz makes
sure you
get a nice stack stace from the location in the widgetz template
where
you used ruby''s power blow your leg off instead of some esoteric
message
from an anonymous module you barely knew.
widgetz are essentailly bags of data that use a controller to render
themselves. all the state of the widget is made available in the
view as
local variables, while the normal @variables set in a controller
remain
visible as normal. one special local variable, ''widget'',
is set
in the view''s
local vars so you have a handle on the widget in order to use it
for some evil
purpose.
SAMPLE
#
# app/controllers/sample_controller.rb
#
def c
@var = 42
@c = widget ''c''
render :layout => ''application'', :inline =>
<<-rhtml
var: <%= @var %>
<hr>
<%= @c %>
rhtml
end
#
# lib/widgets/c.rb
#
Widget ''c'' do
attribute ''var'' => ''forty-two''
def answer
42.0
end
end
#
# app/views/widgets/c.rhtml
#
controller var : <%= @var %> <br>
widget var : <%= var %> <br>
widget method : <%= widget.answer %> <br>
#
# output
#
var: 42
----------------------
controller var : 42
widget var : forty-two
widget method : 42.0
DOCS
lib/*
sample/rails/*
AUTHOR
a @ http://drawohara.com/
enjoy.
-a
--
we can deny everything, except that we have the possibility of being
better. simply reflect on that.
h.h. the 14th dalai lama
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"Ruby on Rails: Talk" group.
To post to this group, send email to
rubyonrails-talk-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
To unsubscribe from this group, send email to
rubyonrails-talk-unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
For more options, visit this group at
http://groups.google.com/group/rubyonrails-talk?hl=en
-~----------~----~----~----~------~----~------~--~---
(sorry for formatting - fixed here)
NAME
widgetz.rb
SYNOPSIS
simple widgets for rails
INSTALL
gem install widgetz
URIS
http://rubyforge.org/projects/codeforpeople/
http://codeforpeople.com/lib/ruby/widgetz/
http://drawohara.tumblr.com/post/6060120
DESCRIPTION
widgetz.rb aims to fix two problems with factoring and abstracting
html generation in rails using the normal ''helper'' methodolgy:
1) helper methods are purely procedural and provide no state.
ruby is an object oriented language and we like to use objects to
abstract things where possible. widgetz lets you do just that. some
people call this encapsulation.
2) by using the normal rendering chain in rails, widgetz makes
sure you get a nice stack stace from the location in the widgetz
template where you used ruby''s power blow your leg off instead of some
esoteric message from an anonymous module you barely knew.
widgetz are essentailly bags of data that use a controller to render
themselves. all the state of the widget is made available in the view
as local variables, while the normal @variables set in a controller
remain visible as normal. one special local variable,
''widget'', is
set in the view''s local vars so you have a handle on the widget in
order to use it for some evil purpose.
SAMPLE
#
# app/controllers/sample_controller.rb
#
def c
@var = 42
@c = widget ''c''
render :layout => ''application'', :inline =>
<<-rhtml
var: <%= @var %>
<hr>
<%= @c %>
rhtml
end
#
# lib/widgets/c.rb
#
Widget ''c'' do
attribute ''var'' => ''forty-two''
def answer
42.0
end
end
#
# app/views/widgets/c.rhtml
#
controller var : <%= @var %> <br>
widget var : <%= var %> <br>
widget method : <%= widget.answer %> <br>
#
# output
#
var: 42
----------------------
controller var : 42
widget var : forty-two
widget method : 42.0
DOCS
lib/*
sample/rails/*
AUTHOR
a @ http://drawohara.com/
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"Ruby on Rails: Talk" group.
To post to this group, send email to
rubyonrails-talk-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
To unsubscribe from this group, send email to
rubyonrails-talk-unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
For more options, visit this group at
http://groups.google.com/group/rubyonrails-talk?hl=en
-~----------~----~----~----~------~----~------~--~---