# Initiation au Lua avec Scribunto/Librairie HTML
## Présentation

mw.html est une interface fluide pour construire du code HTML complexe pour Lua. Le code est ainsi à la fois plus concis et plus clair. Un objet mw.html peut être créé en utilisant mw.html.create.
Un exemple de base pourrait ressembler à ceci :

## Fonctions de la librairie HTML

Les exemples de ce chapitre se trouveront dans le Module:Html
Nous commencerons par visualiser le contenu de la librairie HTML grâce au programme suivant :
{{#invoke:Html|visualisation}} nous donne : À la clé create, on trouve un objet de type : function
Nous voyons qu’il y a une seule fonction directement accessible, mais il y a aussi plusieurs méthodes.
Étudions en détail cette fonctions :

#### mw.html.create

mw.html.create( tagName, args )
Crée un nouvel objet mw.html contenant un élément html tagName. Vous pouvez également passer une chaîne vide au paramètre tagName afin de créer un objet mw.html vide.
args peut être une table avec les clés suivantes :
* args.selfClosing : Forcer la balise courante à se fermer, même si mw.html ne la reconnaît pas comme autofermante
* args.parent : Parent de l'instance de mw.html actuel (destiné à un usage interne)

## Méthodes de la librairie HTML
#### mw.html:node

html:node( builder )
Ajoute un nœud enfant (builder) à l'instance mw.html actuelle.

#### mw.html:wikitext

html:wikitext( ... )
Ajoute un nombre indéterminé de wikitexte à l’objet mw.html.

#### mw.html:newline

html:newline
Ajoute une nouvelle ligne à l’objet mw.html.

#### mw.html:tag

html:tag( tagName, args )
Ajoute un nouveau nœud enfant tagName, et renvoie une instance mw.html représentant le nouveau nœud. Le paramètre args est identique à celui de mw.html.create

#### mw.html:attr

html:attr( name, value ) html:attr( table )
Définie un attribut HTML name avec comme valeur value sur le nœud. Alternativement, une table contenant le couple d'attribut nom->valeur peut être passée.

#### mw.html:getAttr

html:getAttr( name )
Obtiens la valeur d'un attribut HTML précédemment définie en utilisant html:attr avec le nom (name) donné.

#### mw.html:addClass

html:addClass( class )
Ajoute un nom de classe à l'attribut de classe du nœud.

#### mw.html:css

html:css( name, value ) html:css( table )
Définie une propriété CSS name avec comme valeur value sur le nœud. Alternativement, une table contenant le couple de propriété nom->valeur peut être passée.

#### mw.html:cssText

html:cssText( css )
Ajoute du code CSS brut à l'attribut du nœud courant.

#### mw.html:done

html:done
Renvoie le nœud parent dans lequel le nœud courant a été créé. Comme jQuery.end, il s'agit d'une fonction pratique pour permettre la construction de plusieurs nœuds enfants pour être chainés en une seule déclaration.

#### mw.html:allDone

html:allDone
Comme html:done, mais traverse tout le chemin vers le nœud racine de l'arbre et le retourne.

## Étude du contenu d'un objet mw.html

Nous commencerons par visualiser le contenu d'un objet mw.html grâce au programme suivant :
{{#invoke:Html|visualise}} nous donne : À la clé nodes, on trouve un objet de type : table À la clé styles, on trouve un objet de type : table À la clé attributes, on trouve un objet de type : table À la clé selfClosing, on trouve un objet de type : boolean
Étudions ces objets :

#### html.selfClosing

| L'objet URI | Librairie Language |