Haml 转化成 html 的网络工具 http://lab.hamptoncatlin.com/play/with/haml Haml是一种用来描述任何XHTML web document的标记语言,它是干净,简单的。而且也不用内嵌代码。Haml的职能就是替代那些内嵌代码的page page templating systems,比如PHP,ERB(Rails的模板系统),ASP。不过, haml避免了直接coding XHTML到模板,因为它实际上是一个xhtml的抽象描述,内部使用一些code来生成动态内容。 它有什么特点呢? 1. 空格标识层次嵌套关系 2. 良好的标签格式 3. DRY(Don’t repeat yourself) 4. 遵循CSS标准 5. 集成了Ruby代码 6. 用.haml扩展名代替了rails模板(.rhtml) Haml的使用 Haml的使用有两种方式:作为Ruby on Rails的插件来使用。作为一个独立的Ruby module来使用。 Rails 插件方式:这是使用Haml最常用的方式。当然,安装Haml的方式,就是Rails里常用的插件安装方式了: ./script/plugin install http://svn.hamptoncatlin.com/haml/tags/stable 一旦安装好以后,你必须以.haml为扩展名来使用。你在ERB模板里可以使用的实例变量在Haml里照样可以使用,Helper方法也不例外。比如: # file: app/controllers/movies_controller.rb class MoviesController < ApplicationController def index @title = "Teen Wolf" end end # file: app/views/movies/index.haml #content .title %h1= @title = link_to 'Home', home_url 上面的haml代码会被编译为:
Ruby Module方式: Haml可以完全从rails和ActionView里拿出来单独使用。下下面这样做: gem install haml 然后用Haml::Engine: engine = Haml::Engine.new("%p Haml code!") engine.render #=> "
Haml code!
\n" XTML Tags:下面这些字符会渲染出相应的xhtml tag % 百分号符号是一行的开始,紧接着一个元素的名字,然后后面跟一个可选的修饰语(见下例),比如一个空格,或一行文本等,就会被渲染到这个元素里成为其内容。它会创建一个这样的形式:.。举个例子: %one %two %three Hey there 会被编译为: Hey there 对于任何一个有效的标准元素字符,Haml都会自动的为其生成闭合标签。 {} 括号内的Ruby hash是用来指名一个元素的属性。它作为一个ruby hash的字面量,局部变量也可以在其中使用。Hash放在被定义好的标签之后,基本上就和Ruby语法一样,看例子: %head{ :name => "doc_head" } %script{ 'type' => "text/" + "javascript", :src => "javascripts/script_#{2 + 7}" } 编译后为: <script src="/admin/blogs/284034/javascripts/script_9" type="text/javascript"></script> [] 方括号跟在一个标签定义之后,包含一个Ruby 对象,被用来为这个标签设置class和id属性。这个class的值被设置为这个对象的类名(两个单词用下划线形式表示,而不是驼峰表示方法)并且id的值被设置为对象的类名加上这个对象的id,也是下划线连接。因为一个对象的id通常是朦胧的实现细节,这是表现model的实例最有用的元素了(这句是不是翻译的太差?)。看例子: # file: app/controllers/users_controller.rb def show @user = CrazyUser.find(15) end # file: app/views/users/show.haml %div[@user] %bar[290]/ Hello! 转换为:
这是基于RailsConf Europe 2006 大会上DHH提出的SimpleHelpful语法 / 这个斜线字符,放在一个tag定义之后,可以让这个标签自我关闭。例子: %br/ %meta{'http-equiv' => 'Content-Type', :content => 'text/html'}/ 转换为:
有一些标签(meta, img, link, script, br, and hr tags等)当没有内容的时候会自动关闭。看例子: %br %meta{'http-equiv' => 'Content-Type', :content => 'text/html'} 转换为:
. and # 这两个符号是从CSS里借鉴来的。他们被用来表示一个元素的class和id属性。看例子: %div#things %span#rice Chicken Fried %p.beans{ :food => 'true' } The magical fruit %h1.class.otherclass#id La La La 转换为:
The magical fruit
注意h1标签。两个点连用,第一个表示class属性,第二个则是用来链接那两个字符的空格。
#content .articles .article.title Doogie Howser Comes Out .article.date 2006-11-05 .article.entry Neil Patrick Harris would like to dispel any rumors that he is straight
转换为:
Implicit Div Elements(隐藏DIV)因为Div这个标签经常被用,所以你仅用.and#这两个符号来定义class和id的时候,一个div元素就会被自动的使用。例如: #collection .item .description What a cool item! 和下面的这个相似: %div{:id => collection} %div{:class => 'item'} %div{:class => 'description'} What a cool item! 都会被转换为:
= 等号符号用来插入ruby 代码的值到模板中。 %p= "hello" 和下面的这种形式不太一样: %p = "hello" XHTML Helpers No Special Character 如果没有这些特定的字符打头的话,返回的只是一个普通的文本,比如下面的Wow this is cool! %gee %whiz Wow this is cool! 转换为: Wow this is cool! !!! 当用haml来表示一个XHTML文档,你可以通过!!!这个符号来自动生成文档类型和XML prolog。比如: !!! XML !!! %html %head %title Myspace %body %h1 I am the international space station %p Sign my guestbook 转换为:
Sign my guestbook
你也可以在!!!后面加版本号。比如: !!! 1.1 转换为:
and !!! Strict
如果你不想用UTF-8的编码,你也可以指定你想要的编码: !!! XML iso-8859-1 转换为:
/ 如果这个斜线写在打头的位置,则会注释这行。 %billabong / This is the billabong element I like billabongs! 转换为:
I like billabongs! 放在代码的上方,则注释整个代码: / %p This doesn't render... %div %h1 Because it's commented out! 转换为:
/[if IE] %a{ :href => 'http://www.mozilla.com/en-US/firefox/' } %h1 Get Firefox 转换为:
Hello, World
Haml支持的过滤器定义 plain ruby preserve erb sass redcloth textile markdown Ruby evaluators(执行Ruby代码,前面说了) = 等号允许执行ruby代码并返回一个值作为显示文本。 %p = ['hi', 'there', 'reader!'].join " " = "yo" 编译为:
hi there reader! yo
你也能使用双等号来更容易的嵌入ruby代码。比如: %p == 1 + 1 = #{1 + 1} 编译为:
1 + 1 = 2
- 横杠符号,很有性格,可以使文本变为”silent script”:意思是,代码可以执行,但并不输出任何东西。 这里不推荐使用这种扩展,所有的逻辑代码都应该限制在controller,helper或partials里 For example: - foo = "hello" - foo << " there" - foo << " you!" %p= foo 转换为:
hello there you!
Blocks Ruby中的块,也不需要明显的去关闭,haml会让它自动关闭。这写都是基于缩进的。千万记住要缩进两个空格。 - (42...47).each do |i| %p= i %p See, I can count! 编译为:
42
43
44
45
46
Another example: %p - case 2 - when 1 = "1!" - when 2 = "2?" - when 3 = "3." is compiled to:
2?
< -# 相当于一个注释吧,跟在这个符号后面的文本无法输出。 For example: %p foo -# This is a comment %p bar is compiled to:
foo
bar
h2>Other Useful Things Helpers Haml offers a bunch of helpers that are useful for doing stuff like preserving whitespace, creating nicely indented output for user-defined helpers, and other useful things. The helpers are all documented in the Haml::Helpers and Haml::Helpers::ActionViewExtensions modules. Haml提供了很多有用的helper方法。比如为用户定义的helper方法保留空格创建漂亮的缩进等其他一些有用的东西。这些helpers方法都在Haml::Helpers和Haml::ActionViewExtensions这两个modules里。 Haml Options Options can be set by setting the hash Haml::Template.options from environment.rb in Rails, or by passing an options hash to Haml::Engine. Available options are: 可以在Rails的environment.rb文件中通过设置Haml::Template.options的hash来设置Options,或者通过传一个hash到Haml::Engine里来设置。也就是你可以设置如下option来自定义haml,可用的options如下所示: :suppress_eval :attr_wrapper :filename :filters :locals