Introduction

Installation

Questions fréquemment posées

Syntaxe, mots-clés et fonctions intégrées

Distribution standard

Implémentation de import

Interface avec le navigateur

Modules intégrés propres à Brython

Travailler avec Brython

Recettes

 

Attributs et méthodes des éléments

Les éléments de la page possèdent des attributs et des méthodes qui dépendent du type de l'objet ; ils sont définis dans les spécifications du W3C et on peut les trouver sur de nombreux sites Internet.

Comme le nom des attributs peut être différent d'un navigateur à l'autre, Brython définit des attributs supplémentaires qui fonctionnent dans tous les cas :

NomTypeDescriptionL = lecture seule
L/E = lecture + écriture
abs_leftentierposition de l'élément par rapport au bord gauche de l'écranL
abs_topentierposition de l'élément par rapport au bord supérieur de l'écranL
childrenlisteles éléments "descendants" de l'élémentL
class_namechainele nom de la classe de l'élément (attribut class de la balise)
L/E
clearméthodeelt.clear() supprime tous les descendants de l'élément-
closest méthode elt.closest(nom_balise)</code> renvoie le premier élément parent de elt avec la balise spécifiée. Déclenche une KeyError si aucun élément n'est trouvé. -
getméthodesélectionne des éléments (cf accéder aux éléments)-
heightentierhauteur de l'élément en pixels (2)L/E
htmlchainele code HTML contenu dans l'élémentL/E
indexméthodeelt.index([selector]) renvoie le rang (entier) de l'élément parmi les enfants de son parent. Si selector est spécifié, seuls les enfants correspondant à ce sélecteur sont retenus ; dans ce cas, si l'élément ne correspond pas au sélecteur, la méthode renvoie -1-
insideméthodeelt.inside(autre) teste si elt est contenu dans l'élément autre-
leftentierla position de l'élément par rapport au bord gauche du premier parent positionné (1)L/E
parentinstance de DOMNodel'élément parent de l'élément (None pour document)L
selectméthodeelt.select(css_selector) renvoie les éléments correspondant au sélecteur CSS spécifié-
select_one méthode elt.select_one(css_selector) renvoie l'élément correspondant au sélecteur CSS spécifié, sinon None -
textchainele texte contenu dans l'élémentL/E
topentierla position de l'élément par rapport au bord supérieur du premier parent positionné (1) L/E
widthentierlargeur de l'élément en pixels (2)L/E

(1) En remontant dans l'arbre DOM, on s'arrête au premier élément dont l'attribut style.position est défini à une valeur autre que "static". left et top ont le même mode de calcul que style.left et style.top mais sont des valeurs entières et pas des chaines de caractères se terminant par px.

(2) Même mode de calcul que style.height ou style.width mais ce sont des valeurs entières

Pour ajouter un descendant à un élément, on utilise l'opérateur <= (à visualiser comme une flèche vers la gauche, pas comme "inférieur ou égal")

from browser import document, html
document['zone'] <= html.INPUT(Id="data")

On peut itérer sur les enfants d'un élément par la syntaxe classique Python :

for child in element:
    (...)

Pour détruire un élément, utiliser le mot-clé del

zone = document['zone']
del zone

La collection options associée à un objet SELECT a l'interface d'une liste Python :

  • accès à une option par son index : option = elt.options[index]
  • insertion d'une option à la position index : elt.options.insert(index,option)
  • insertion d'une option en fin de liste : elt.options.append(option)
  • suppression d'une option : del elt.options[index]