Haml 参考大全.docx

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?/haml/tags/stable[url]/haml/tags/stable[/url]一旦安装好以后，你必须以.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代码会被编译为：div id=content?div class=title?h1Teen Wolf/h1?a href=/Home/a?/div?/div?Ruby Module方式：Haml可以完全从rails和ActionView里拿出来单独使用。下下面这样做：?gem??install??haml?然后用Haml::Engine：engine = Haml::Engine.new(%p Haml code!)engine.render #= pHaml code!/p\n?XTML Tags：下面这些字符会渲染出相应的xhtml tag?%百分号符号是一行的开始，紧接着一个元素的名字，然后后面跟一个可选的修饰语（见下例），比如一个空格，或一行文本等，就会被渲染到这个元素里成为其内容。它会创建一个这样的形式：element/element.。举个例子：?%one?%two?%three Hey there会被编译为：?one?two?threeHey there/three?/two?/one对于任何一个有效的标准元素字符，Haml都会自动的为其生成闭合标签。?{}括号内的Ruby hash是用来指名一个元素的属性。它作为一个ruby hash的字面量，局部变量也可以在其中使用。Hash放在被定义好的标签之后，基本上就和Ruby语法一样，看例子：??%head{ :name = doc_head }?%script{ type = text/ + javascript,?:src???= javascripts/script_#{2 + 7} }编译后为：?head name=doc_head?script src=javascripts/script_9 type=text/javascript?/script?/head??[]方括号跟在一个标签定义之后，包含一个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!转换为：?div class=crazy_user id=crazy_user_15?bar class=fixnum id=fixnum_581 /?Hello!?