Haml va ser concebut per tal de fer vistes amb ruby on rails que fossin el més llegibles possible.
Per generar vistes amb aquest sistema cal instal·lar un pluguin a la nostra aplicació rails:
$./script/plugin install http://svn.hamptoncatlin.com/haml/tags/stable
Aquesta ordre el que fa és descarregar els fitxers del plugin i els copia a la carpeta “vendor/plugins” de la nostra aplicacio rails.
Un cop instal·lat el pluguin, per crear plantilles hem de posar l’extensió .haml als fitxers de les vistes en comptes de .rhtml.
Per resumir una mica haml defineix els tags posant:
%nom_tagEs converteix en:
Per posar les propietats d’un tag:
%tag{ :propietat => "valor", :propietat2 => "valor2"}Es converteix en:
Si volem posar un tag del tipus %br que no es tanca li hem de posar / al final:
%br/Es converteix en:
si és un tag amb propietats posem la contrabarra al final:
%tag{...}/
Per aniuar tags un dins l’altre cal identar amb dos espais.
Per posar la propietat id d’un tag hem de posar (#) i per posar un class (.).
p#prova.hola="Hola"Es converteix en:Hola
Si senzillament volem posar un div
#id.classEs converteix en:
Quan no posem nom al (#) haml ho converteix en un div
Si per exemple volem definir una taula:
%table{:border => 1} %tr %td{:width => 20}="el que sigui" %td{:width => 50} posem el text que ens vingui de gust %tr %td{:colspan => 2}="Això és un text"Es converteix en:
el que sigui posem el text que ens vingui de gust Això és un text
Per inserir codi ruby en mig s’ha d’emprar el guió mig(-):
%html
%head
%title="Prova"
%body
- unless flash[:notice].nil?
#error="Missatge d'error"
- end
Nota: cal identar el codi ruby a dins del tag corresponent
