view
view分为 builder模式和rhtml模式
builder模式例子如下,rails自带
xml.div(:class => "productlist") do
xml.timestamp(Time.now)
@products.each do |product|
xml.product do
xml.productname(product.title)
xml.price(product.price, :currency => "USD")
end
end
end
如果标记和内置方法重复,可以使用something!()来产生标记
rhtml类似于jsp, <%=...%>输出 <%...%>纯标记 <%...-%>自动删除自己的空行
h方法提供了html encoding
Helper
XXXController都会对应一个 XXXHelper(xxx_helper.rb)来写帮助方法, 这些方法在rhtml中都可见
要实现跨controller调用,可以
* 在application_helper.rb中写方法
* 在controller中通过helper :some_helper.rb导入
* 在controller中通过helper SomeHelper导入(类已经栽入的情况下)
通过helper_method 还可以把controller中的方法变为helper,但是这样作不推荐,破坏封装
rails内置了很多helper可用,比如各种单位的换算helper(对view特别有意义),详情查阅rdoc 特别的helper有
* debug 把对象以html可见的方式打印在页面,方便调试
* simeple_format 简单的格式化string,添加
段落和
* excerpt 给字符两边添加... "...Some words fo..."
* highlight(string,highword) 添加...
* truncate(sring,maxlen) 给字符右边添加... "hello this is my..."
* pluralize(num,word) 自动添加复数形式 1 person -> 2 people
* markdown 文章filter
* texttile 文章filter
处理链接
link_to "xxxx",{hash},{hash}
第一个是链接文字,第二个hash和url_for的一样,第三个hash是用户自己在<a>中添加的标签,比如
<%= link_to "Delete", { :controller => "admin",
:action => "delete",
:id => @product
},
{ :class => "redlink",
:confirm => "Are you sure?"
}
%>
button_to 的参数和link_to一样, 产生一个button来跳转(安全的POST协议),但是button_to要单独在一个form里面,html不允许嵌套form
link_to_unless_current 自动识别当前链接, 如果当前url和链接一样, 就只产生文本
image_tag嵌套进入link_to
mail_to 有一个:encode=>"javascript" 可以实现把email地址编码防spider
stylesheet_link_tag 添加css
auto_descovery_link_tag 自动申明rss
默认所有的image在/images css在/stylesheets,除非显示使用/xxx来指定根路径另外可以修改 ActionController::Base.asset_host = "http://media.my.url/assets" #共同的prefix 这样可以实现静态内容专门在一一起
分页
分页涉及到controller和view两个部分在controller中 Paginator对象, 专门负责分页 ,默认分页为10个一页
@user_pages, @users=paginate(:users,:order_by =>'name')
在页面里面使用<%=pagination_links(@user_pages)%> 会自动产生页面链接
详情查阅RDoc
表单处理
本质上rails是简单的把上行的参数设置为层次分明的hash(aaa.bbb.ccc 映射为 aaa[bbb][ccc]), 这样来和activerecord自动交换数据,但是也可以直接读取之
param[:xx][:yy] rails推荐以symbol来读取(string也可以)
大多数输入helper前两个参数分部是:variable和:attribute ,最后一个是增加的html options 例子如下 <%=xxx_field :variable,:attribute,options_hash%>
注意 update_attribute会自动调用save方法
表单处理 FormHelper中的方法(和Model绑定)
普通输入框
* text_field
* hidden_field
* password_field
*
text_area
*
radio_button 第三个参数是tag_value,当他和value相等的时候显示为selected
* check_box value必须为true/false或者转换为int的值(非0为true) 倒数两个参数为on_value和off_value 为打开/关闭时提交的值, 默认为"1","0"
列表
select(:variable, :attribute,choices,options,html_options)
choice参数为enumerable,当enumerable的元素为[a,b]这样的长度为2数组的时候,数组第一个元素为value,第二个为key
collection_select(:variable,:attribute,choices,:inner_attr_for_key,:inner_attr_for_value)专门用来列表集合
分组列表
暂时不看 @@@
日期输入框
date_select(:variable,:attribute,options) datetime_select(..)是处理和model相关的日期
select_xxx 是处理普通日期(直接通过params访问)
没有怎么看明白有什么用处
上传文件
form中需要添加:multipart=>true,本质上然后通过对应的参数获得数据(一个StringIO) 通过read即可读取全面内容到string中然后就相当于拿到文件内容处理了
错误处理
上门的helper参数都会自动读取对于field的错误信息(errors.on(field)),发现错误以后会自动产生一个class=fieldWithErrors的div,通过css可以控制显示. 如果需要直接读取某个field的错误信息, 可以使用<%= error_message_on(:bean,:field)%>,读取所有错误使用<%= error_messages_for(:bean)%>
FormTagHelper 和Model无关的方法
FormTagHelper中的方法都比Form中多一个_tag结尾
* start_form_tag和end_form_tag form开始结束
* submit_tag 提交按钮
其他FormHelper中的帮助方法都有一个对应的_tag版本,参数接受 :name,value,html_options
例子如下
<%=text_field_tag(:arg1,@params[:args],:size=>3)%>
layout技术 (sitemesh式的模板)
layout模板中可以访问所有对应页面中能访问的对象,还多有@content_for_layout参数来指向整个页面输出的内容
自动查找: 一个xxx_controller对应了一个在layout下同名的xxx.rhtml/rxml作为他的layout,
显式申明:
1. 在controller中通过layout申明一个string, 支持:except和:only参数(过滤:action名)
2. 声明为nil表示关闭layout
3. 申明为一个:symbol表示通过当前类symbol方法获取string名
string对应了 string.rhtml或者string.rxml
直接render: 直接调用render(:layout=>"layouts/xxxx")可以使用layout,或者使用:layout=>false关闭layout
partial page template 页面片断
页面片断的页面必须以_开头命名,放在和controller相同路径下,使用render(:partial=>"xxx",:object=>@newinst)访问
文件名必须ruby变量规范和文件名普通规范,通过:object注入的参数通过文件名访问,比如_myname.rhtml就得到了myname这个参数,要追加其他参数,使用:locals={...}
如果忽略:object参数表示把@xxx 自动传入 _xxx.rhtml中的xxx变量, 也就是当@instance和partial中的变量名相同时候, 可以省略:object
使用集合的partial
通过 render(:partial=>"xxx" ,:collection=>xxx) 可以指定一个集合, 集合中的元素会传给partial content作为主元素,同时还会添加一个xxx_counter来作为index, 此时使用:spacer_template=>"yyy"还可以指定两个元素之间使用的空白template
如果:partial=>"xxx/yyy" 指定的名字含有/ ,那么rails默认为这个路径从/app/views开始,通过这个方法可以做到多个controller使用一个partial conetent
components 组件
在页面中通过render_component使用 render_component(:controller=>'xxx',:action=>'fdas')
需要注意的是要注意避免循环引用,所以一般用来作component的action最好使用render(:layout=>false...)或者在class中申明 layout "xxx","except=>:xxxx
独立的component组件
* 必须方在components/xxx下面
* 使用XXX::MyController申明 必须在model xxx中
* 类开头申明uses_component_template_root
* 使用方式为<%%=render_component):controller=>'xxx/my',:action=>'yyy') %>