Haml 参考大全
Haml 是一种用来描述任何 XHTML
web document 的标记语言, 它是干净, 简单的。 而且也不用内嵌代码。Haml 的职能就是替代那些内嵌代码的 page page templating systems,比如
PHP,ERB(Rails 的模板
系统),ASP。不过, haml 避 免了直接 coding XHTML 到模板,因为它实际上是一个 xhtml 的抽象描述,内部 使用一些 code 来生成动态内容。 它有什么特点呢? 它有什么特点呢? 空格标识层次嵌套关系 良好的标签格式
DRY(Don’t repeat yourself)
遵循 CSS 标准 集成了 Ruby 代码 用.haml 扩展名代替了 rails 模板(.rhtml)
Haml 的使用
Haml 的使用有两种方式:
作为 Ruby on Rails 的插件来使用。 作为一个独立的 Ruby module 来使用。 Rails 插件方式: 这是使用 Haml 最常用的方式。当然,安装 Haml 的方式,就是 Rails 里
常用的插件安 装方式了: ./script/plugin install [url]svn.hamptoncatlin/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 代码会被编译为:
Teen Wolf
Home
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}" }
[] 方括号跟在一个标签定义之后,包含一个 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! 转换为:
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 转换为:
Chicken Fried The magical fruit
La La La
注意 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 转换为: Doogie Howser Comes Out
2006-11-05
Neil Patrick Harris would like to dispel any rumors that he is straight
Elements( DIV) 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! 都会被转换为:
What a cool item!
=
等号符号用来插入 ruby 代码的值到模板中。 %p= "hello" 和下面的这种形式不太一样: %p = "hello" X
HTML Helpers No Special Character 如果没有这些特定的字符打头的话,返回的只是一个普通的文本,比如下面的 Wow this is cool! %gee %whiz Wow thi
s 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 转换为:
I am the international space station
Sign my guestbook
你也可以在!!!后面加版本号。比如: !!! 1.1 转换为: and !!! Strict 如果你不想用 UTF-8 的编码,你也可以指定你想要的编码: !!! XML iso-8859-1 转换为:
xml version="1.0" encoding="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! 转换为: This doesn't render...
Because it's commented out!
--> /[if IE] %a{ :href => 'mozilla/en-US/firefox/' } %h1 Get Firefox 转换为: <!--[if IE]>
Get Firefox
<![endif]-->
\
反斜杠符号允许字符串前面的第一个符号作为纯文本使用。 %title
= @title \- MySite 转换为:
|
管道符可以允许把输出为一行的内容写成多行。 %whoo %hoo I think this might get | pretty long so I should | probably make it | multiline so it doesn't | look awful. | %p This is short. is compiled to:
I think this might get pretty long so I should probably make it multiline so it doesn't look awful. :
冒号是指定一个过滤器。冒号后面是你要使用的那个过滤器的名字。For example, %p :markdown Textile =======
Hello, *World* 转换为:
Textile
Hello, World
Haml 支持的过滤器定义 plain ruby preserve erb sass redcloth textile markdown
evaluators( 前面说 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, 这里不推荐使用这种扩展, 里不推荐使用这 所有的逻 应该限制在 controller, helper 或 pa
-
相关文章
-
最新文件
关于网学 |
万能工具 |
在线交流 |
会员中心 |
查询论文 |
招聘说明 |
精品资源 |
专题论文 |
会员中心 |
联系方式 |
下载目录
论文目录
Copyright 2005-2018 www.myeducs.cn All Rights Reserved 版权所有·网学网 提供大量原创论文 参考论文 论文资料 源代码 管理及投稿 E_mail:3710167@qq.com
郑重声明: 本网站论文均来自互联网,由本站会员上传或下载,仅供个人交流、学习、参考之用,版权归原作者所有
请下载完后24小时之内删除,任何人不得大幅抄录、在期刊上发表或作为商业之用。如涉及版权纠纷,本网站不承担任何法律及连带责任。