From 8198a959f8015374fc6639efbbb729ae346d1a06 Mon Sep 17 00:00:00 2001 From: Pierre Ambroise <74421318+Fan2Shrek@users.noreply.github.com> Date: Sun, 22 Dec 2024 00:35:00 +0100 Subject: [PATCH] Translate Dom\TokenList methods (#1968) --- reference/dom/dom/tokenlist/add.xml | 96 ++++++++++++++++++ reference/dom/dom/tokenlist/contains.xml | 93 +++++++++++++++++ reference/dom/dom/tokenlist/count.xml | 52 ++++++++++ reference/dom/dom/tokenlist/getiterator.xml | 52 ++++++++++ reference/dom/dom/tokenlist/item.xml | 102 +++++++++++++++++++ reference/dom/dom/tokenlist/remove.xml | 95 +++++++++++++++++ reference/dom/dom/tokenlist/replace.xml | 104 +++++++++++++++++++ reference/dom/dom/tokenlist/supports.xml | 70 +++++++++++++ reference/dom/dom/tokenlist/toggle.xml | 107 ++++++++++++++++++++ 9 files changed, 771 insertions(+) create mode 100644 reference/dom/dom/tokenlist/add.xml create mode 100644 reference/dom/dom/tokenlist/contains.xml create mode 100644 reference/dom/dom/tokenlist/count.xml create mode 100644 reference/dom/dom/tokenlist/getiterator.xml create mode 100644 reference/dom/dom/tokenlist/item.xml create mode 100644 reference/dom/dom/tokenlist/remove.xml create mode 100644 reference/dom/dom/tokenlist/replace.xml create mode 100644 reference/dom/dom/tokenlist/supports.xml create mode 100644 reference/dom/dom/tokenlist/toggle.xml diff --git a/reference/dom/dom/tokenlist/add.xml b/reference/dom/dom/tokenlist/add.xml new file mode 100644 index 0000000000..93711c76cb --- /dev/null +++ b/reference/dom/dom/tokenlist/add.xml @@ -0,0 +1,96 @@ + + + + + + Dom\TokenList::add + Ajoute les jetons donnés à la liste + + + + &reftitle.description; + + public voidDom\TokenList::add + stringtokens + + + Ajoute les tokens donnés à la liste, mais pas ceux + qui étaient déjà présents. + + + + + &reftitle.parameters; + + + tokens + + + Les jetons à ajouter. + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + &dom.tokenlist.errors; + + + + &reftitle.examples; + + Exemple de <methodname>Dom\TokenList::add</methodname> + + Ajoute deux classes à un élément paragraphe nouvellement créé. + + +createElement('p'); + +$classList = $p->classList; +$classList->add('font-bold', 'important'); + +echo $dom->saveHtml($p); +?> +]]> + + &example.outputs; + +

+]]> + + + + + diff --git a/reference/dom/dom/tokenlist/contains.xml b/reference/dom/dom/tokenlist/contains.xml new file mode 100644 index 0000000000..370c4b7409 --- /dev/null +++ b/reference/dom/dom/tokenlist/contains.xml @@ -0,0 +1,93 @@ + + + + + + Dom\TokenList::contains + Renvoie si la liste contient un jeton donné + + + + &reftitle.description; + + public boolDom\TokenList::contains + stringtoken + + + Renvoie si la liste contient token. + + + + + &reftitle.parameters; + + + token + + + Le jeton. + + + + + + + + &reftitle.returnvalues; + + Renvoie &true; si la liste contient token, + sinon &false;. + + + + + &reftitle.examples; + + Exemple de <methodname>Dom\TokenList::contains</methodname> + + Vérifie si deux classes sont présentes sur le paragraphe. + + +

', LIBXML_NOERROR); +$p = $dom->body->firstChild; + +$classList = $p->classList; +var_dump( + $classList->contains('important'), + $classList->contains('font-small'), +); +?> +]]> + + &example.outputs; + + + + + + + diff --git a/reference/dom/dom/tokenlist/count.xml b/reference/dom/dom/tokenlist/count.xml new file mode 100644 index 0000000000..2f1f54797d --- /dev/null +++ b/reference/dom/dom/tokenlist/count.xml @@ -0,0 +1,52 @@ + + + + + + Dom\TokenList::count + Renvoie le nombre de jetons dans la liste + + + + &reftitle.description; + + public intDom\TokenList::count + + + + Renvoie le nombre de jetons dans la liste. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Le nombre de jetons dans la liste. + + + + diff --git a/reference/dom/dom/tokenlist/getiterator.xml b/reference/dom/dom/tokenlist/getiterator.xml new file mode 100644 index 0000000000..4281dfa9ca --- /dev/null +++ b/reference/dom/dom/tokenlist/getiterator.xml @@ -0,0 +1,52 @@ + + + + + + Dom\TokenList::getIterator + Renvoie un itérateur sur la liste de jetons + + + + &reftitle.description; + + public IteratorDom\TokenList::getIterator + + + + Renvoie un itérateur sur la liste de jetons. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Un itérateur sur la liste de jetons. + + + + diff --git a/reference/dom/dom/tokenlist/item.xml b/reference/dom/dom/tokenlist/item.xml new file mode 100644 index 0000000000..d6fcc9f8f0 --- /dev/null +++ b/reference/dom/dom/tokenlist/item.xml @@ -0,0 +1,102 @@ + + + + + + Dom\TokenList::item + Renvoie un jeton de la liste + + + + &reftitle.description; + + public stringnullDom\TokenList::item + intindex + + + Renvoie un jeton de la liste à l'index. + + + + + &reftitle.parameters; + + + index + + + L'index du jeton. + + + + + + + + &reftitle.returnvalues; + + Renvoie le jeton à l'index ou &null; lorsque l'index + est hors limites. + + + + + &reftitle.examples; + + Exemple de <methodname>Dom\TokenList::item</methodname> + + Accède à un index valide et un index invalide. + + +

', LIBXML_NOERROR); +$p = $dom->body->firstChild; + +$classList = $p->classList; +var_dump( + $classList->item(0), + $classList->item(100), +); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.notes; + + + Cette méthode est équivalente à l'utilisation de la syntaxe d'accès aux tableaux. + + + + + diff --git a/reference/dom/dom/tokenlist/remove.xml b/reference/dom/dom/tokenlist/remove.xml new file mode 100644 index 0000000000..1d87e9e08a --- /dev/null +++ b/reference/dom/dom/tokenlist/remove.xml @@ -0,0 +1,95 @@ + + + + + + Dom\TokenList::remove + Enlève les jetons donnés de la liste + + + + &reftitle.description; + + public voidDom\TokenList::remove + stringtokens + + + Enlève les tokens donnés de la liste, mais ignore + ceux qui n'étaient pas présents. + + + + + &reftitle.parameters; + + + tokens + + + Les jetons à enlever. + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + &dom.tokenlist.errors; + + + + &reftitle.examples; + + Exemple de <methodname>Dom\TokenList::remove</methodname> + + Enlève deux classes du paragraphe. + + +

', LIBXML_NOERROR); +$p = $dom->body->firstChild; + +$p->classList->remove('font-bold', 'important'); + +echo $dom->saveHtml($p); +?> +]]> + + &example.outputs; + +

+]]> + + + + + diff --git a/reference/dom/dom/tokenlist/replace.xml b/reference/dom/dom/tokenlist/replace.xml new file mode 100644 index 0000000000..96539443f6 --- /dev/null +++ b/reference/dom/dom/tokenlist/replace.xml @@ -0,0 +1,104 @@ + + + + + + Dom\TokenList::replace + Remplace un jeton dans la liste par un autre + + + + &reftitle.description; + + public boolDom\TokenList::replace + stringtoken + stringnewToken + + + Remplace un jeton dans la liste par un autre. + + + + + &reftitle.parameters; + + + token + + + Le jeton à remplacer. + + + + + newToken + + + Le nouveau jeton. + + + + + + + + &reftitle.returnvalues; + + Renvoie &true; si token était dans la liste, + sinon &false;. + + + + + &reftitle.errors; + &dom.tokenlist.errors; + + + + &reftitle.examples; + + Exemple de <methodname>Dom\TokenList::replace</methodname> + + Remplace un jeton dans le paragraphe par un autre. + + +

', LIBXML_NOERROR); +$p = $dom->body->firstChild; + +$p->classList->replace('font-bold', 'font-small'); + +echo $dom->saveHtml($p); +?> +]]> + + &example.outputs; + +

+]]> + + + + + diff --git a/reference/dom/dom/tokenlist/supports.xml b/reference/dom/dom/tokenlist/supports.xml new file mode 100644 index 0000000000..6d069ca265 --- /dev/null +++ b/reference/dom/dom/tokenlist/supports.xml @@ -0,0 +1,70 @@ + + + + + + Dom\TokenList::supports + Renvoie si le jeton donné est supporté + + + + &reftitle.description; + + public boolDom\TokenList::supports + stringtoken + + + Renvoie si token est dans la liste des + jetons supportés de l'attribut associé. + + + + + &reftitle.parameters; + + + token + + + Le jeton. + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.errors; + + Lève une TypeError lorsque l'attribut ne + définit pas une liste de jetons supportés. + + + + diff --git a/reference/dom/dom/tokenlist/toggle.xml b/reference/dom/dom/tokenlist/toggle.xml new file mode 100644 index 0000000000..2c6e25f6d9 --- /dev/null +++ b/reference/dom/dom/tokenlist/toggle.xml @@ -0,0 +1,107 @@ + + + + + + Dom\TokenList::toggle + Bascule la présence d'un jeton dans la liste + + + + &reftitle.description; + + public boolDom\TokenList::toggle + stringtoken + boolnullforce&null; + + + Bascule la présence du token dans la liste. + + + + + &reftitle.parameters; + + + token + + + Le jeton à basculer. + + + + + force + + + Si force est fourni, le définir à &true; ajoutera le jeton, + et le définir à &false; le retirera. + + + + + + + + &reftitle.returnvalues; + + Renvoie &true; si le jeton est dans la liste après l'appel, + sinon &false;. + + + + + &reftitle.errors; + &dom.tokenlist.errors; + + + + &reftitle.examples; + + Exemple de <methodname>Dom\TokenList::toggle</methodname> + + Bascule trois classes, deux sans force, et une avec. + + +

', LIBXML_NOERROR); +$p = $dom->body->firstChild; + +$classList = $p->classList; +$classList->toggle('font-bold', 'font-small'); +$classList->toggle('important', force: true); + +echo $dom->saveHtml($p); +?> +]]> + + &example.outputs; + +

+]]> + + + + +