-
haml
鎖定
Haml是一種用來描述任何XHTML web document的標記語言，它是乾淨，簡單的。而且也不用內嵌代碼。Haml的職能就是替代那些內嵌代碼的page page templating systems，比如PHP,ERB(Rails的模板系統)，ASP。不過，haml避免了直接coding XHTML到模板，因為它實際上是一個xhtml的抽象描述，內部使用一些code來生成動態內容。Haml 是一種簡潔優美的模板語言，可以應用於Ruby on Rails、 PHP等Web開發平台，可以大大縮減模板代碼，減少冗餘，提高可讀性。並且Haml是一種完備的模板語言，沒有犧牲當前模板語言的任何特性。Haml由 Hampton Catlin發明並且開發了Ruby on Rails上的實現。
- 中文名
- Haml
- 類 型
- XHTML web document標記語言
- 發明者
- Hampton Catlin
- 實現平台
- Ruby on Rails
haml語言特點
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代碼會被編譯為：
<div id="content"> <div class="title"> <h1>Teen 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 #=＞
''Haml code!\n''
haml標籤
XTML Tags下面這些字符會渲染出相應的xhtml tag
haml百分號
百分號符號是一行的開始，緊接着一個元素的名字，然後後面跟一個可選的修飾語（見下例），比如一個空格，或一行文本等，就會被渲染到這個元素裏成為其內容。它會創建一個這樣的形式：.。舉個例子：
%one
%two
%three Hey there
會被編譯為：
Hey there
對於任何一個有效的標準元素字符，Haml都會自動的為其生成閉合標籤。
haml括號
%head{ :name =＞ "doc_head" }
%script{ 'type' =＞ "text/" + "javascript",
:src =＞ "javascripts/script_#{2 + 7}" }
編譯後為：
</p><p data-id="gnwtnbubu7">
haml方括號
方括號跟在一個標籤定義之後，包含一個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語法
haml斜線
這個斜線字符，放在一個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'}
轉換為：
haml. 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
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"
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
轉換為：
Myspace
I am the international space station
Sign my guestbook
你也可以在！！！後面加版本號。比如：
!!! 1.1
轉換為：
and
hamlStrict
如果你不想用UTF-8的編碼，你也可以指定你想要的編碼：
!!! XML iso-8859-1
轉換為：
haml註釋斜線
如果這個斜線寫在打頭的位置，則會註釋這行。
%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
轉換為：
haml反斜槓
反斜槓符號允許字符串前面的第一個符號作為純文本使用。
%title
= @title
\- MySite
轉換為：
</p><p data-id="gnwtnbuj67">MyPage</p><p data-id="gnwtnmy68n">- MySite</p><p data-id="gnwtnmy6aa">
haml管道符
管道符可以允許把輸出為一行的內容寫成多行。
%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.
haml冒號
冒號是指定一個過濾器。冒號後面是你要使用的那個過濾器的名字。For example,
%p
Textile
=======
Hello, *World*
轉換為：
Textile
Hello, World
haml過濾器定義
plain
ruby
preserve
erb
sass
redcloth
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
