Modification de la documentation

This commit is contained in:
2022-01-03 16:35:29 +01:00
parent 8ffc7b6278
commit 01dc3bf739
2 changed files with 124 additions and 111 deletions

View File

@@ -4,39 +4,40 @@
- [Constructor][1] - [Constructor][1]
- [Parameters][2] - [Parameters][2]
- [each][3] - [Examples][3]
- [Parameters][4] - [each][4]
- [addClass][5] - [Parameters][5]
- [Parameters][6] - [addClass][6]
- [removeClass][7] - [Parameters][7]
- [Parameters][8] - [removeClass][8]
- [replaceClass][9] - [Parameters][9]
- [Parameters][10] - [replaceClass][10]
- [setAttr][11] - [Parameters][11]
- [Parameters][12] - [setAttr][12]
- [delAttr][13] - [Parameters][13]
- [Parameters][14] - [delAttr][14]
- [setHidden][15] - [Parameters][15]
- [setReadOnly][16] - [setHidden][16]
- [setDisabled][17] - [setReadOnly][17]
- [delHidden][18] - [setDisabled][18]
- [delReadOnly][19] - [delHidden][19]
- [delDisabled][20] - [delReadOnly][20]
- [toggleHidden][21] - [delDisabled][21]
- [toggleReadOnly][22] - [toggleHidden][22]
- [toggleDisabled][23] - [toggleReadOnly][23]
- [on][24] - [toggleDisabled][24]
- [Parameters][25] - [on][25]
- [onClick][26] - [Parameters][26]
- [Parameters][27] - [onClick][27]
- [found][28] - [Parameters][28]
- [first][29] - [found][29]
- [last][30] - [first][30]
- [gsd][31] - [last][31]
- [Parameters][32] - [gsd][32]
- [version][33] - [Parameters][33]
- [gsd][34] - [version][34]
- [version][35] - [gsd][35]
- [version][36]
## Constructor ## Constructor
@@ -44,8 +45,14 @@ Création du constructeur
### Parameters ### Parameters
- `selector` **[String][36]** Sélecteur utilisé - `selector` **[String][37]** Sélecteur utilisé
- `scope` **[HTMLElement][37]** Racine de la recherche - `scope` **[HTMLElement][38]** Racine de la recherche
### Examples
```javascript
let element = $_("a.link", "div#main");
```
### each ### each
@@ -53,7 +60,7 @@ Application d'une fonction sur chacun des éléments
#### Parameters #### Parameters
- `callback` **[Function][38]** La fonction de rappel - `callback` **[Function][39]** La fonction de rappel
### addClass ### addClass
@@ -61,7 +68,7 @@ Ajout d'une classe aux éléments sélectionnés
#### Parameters #### Parameters
- `className` **[String][36]** Le nom de la classe à ajouter - `className` **[String][37]** Le nom de la classe à ajouter
Returns **this** Chainage Returns **this** Chainage
@@ -71,7 +78,7 @@ Ajout d'une classe aux éléments sélectionnés
#### Parameters #### Parameters
- `className` **[String][36]** Le nom de la classe à ajouter - `className` **[String][37]** Le nom de la classe à ajouter
Returns **this** Chainage Returns **this** Chainage
@@ -81,8 +88,8 @@ Remplace une classe par une autre dans les éléments sélectionnés
#### Parameters #### Parameters
- `oldClass` **[String][36]** Nom de la classe à remplacer - `oldClass` **[String][37]** Nom de la classe à remplacer
- `newClass` **[String][36]** Nom de la classe de remplacement - `newClass` **[String][37]** Nom de la classe de remplacement
Returns **this** Chainage Returns **this** Chainage
@@ -92,8 +99,8 @@ Définit un attribut et sa valeur
#### Parameters #### Parameters
- `attr` **[String][36]** Nom de l'attribut - `attr` **[String][37]** Nom de l'attribut
- `value` **[String][36]** Valeur de l'attribut - `value` **[String][37]** Valeur de l'attribut
Returns **this** Chainage Returns **this** Chainage
@@ -103,7 +110,7 @@ Supprime un attribut dans les éléments sélectionnés
#### Parameters #### Parameters
- `attr` **[String][36]** Nom de l'attribut à supprimer - `attr` **[String][37]** Nom de l'attribut à supprimer
Returns **this** Chainage Returns **this** Chainage
@@ -167,9 +174,9 @@ Ajout d'un gestionnaire d'événement aux éléments sélectionnés
#### Parameters #### Parameters
- `type` **[String][36]** Nom de l'événement - `type` **[String][37]** Nom de l'événement
- `callback` **[Function][38]** Gestionnaire de l'événement - `callback` **[Function][39]** Gestionnaire de l'événement
- `useCapture` **[Boolean][39]** Propagation de l'événement - `useCapture` **[Boolean][40]** Propagation de l'événement
### onClick ### onClick
@@ -177,26 +184,26 @@ Ajout d'un gestionnaire d'événement 'click' pour les éléments sélectionnés
#### Parameters #### Parameters
- `callback` **[Function][38]** Gestionnaire de l'événement - `callback` **[Function][39]** Gestionnaire de l'événement
- `useCapture` **[Boolean][39]** Propagation de l'événement - `useCapture` **[Boolean][40]** Propagation de l'événement
### found ### found
Retourne si un élément a été trouvé Retourne si un élément a été trouvé
Returns **[Boolean][39]** l'élément du DOM trouvé Returns **[Boolean][40]** l'élément du DOM trouvé
### first ### first
Retourne le premier élément trouvé Retourne le premier élément trouvé
Returns **[HTMLElement][37]** l'élément du DOM trouvé Returns **[HTMLElement][38]** l'élément du DOM trouvé
### last ### last
Retourne le dernier élément trouvé Retourne le dernier élément trouvé
Returns **[HTMLElement][37]** L'élément du DOM trouvé Returns **[HTMLElement][38]** L'élément du DOM trouvé
## gsd ## gsd
@@ -204,9 +211,9 @@ Instantiation d'un nouveau constructeur
### Parameters ### Parameters
- `selector` **[String][36]** Sélecteur utilisé - `selector` **[String][37]** Sélecteur utilisé
- `root` - `root`
- `scope` **[HTMLElement][37]** Racine de la recherche - `scope` **[HTMLElement][38]** Racine de la recherche
### version ### version
@@ -224,76 +231,78 @@ Version de la librairie
[2]: #parameters [2]: #parameters
[3]: #each [3]: #examples
[4]: #parameters-1 [4]: #each
[5]: #addclass [5]: #parameters-1
[6]: #parameters-2 [6]: #addclass
[7]: #removeclass [7]: #parameters-2
[8]: #parameters-3 [8]: #removeclass
[9]: #replaceclass [9]: #parameters-3
[10]: #parameters-4 [10]: #replaceclass
[11]: #setattr [11]: #parameters-4
[12]: #parameters-5 [12]: #setattr
[13]: #delattr [13]: #parameters-5
[14]: #parameters-6 [14]: #delattr
[15]: #sethidden [15]: #parameters-6
[16]: #setreadonly [16]: #sethidden
[17]: #setdisabled [17]: #setreadonly
[18]: #delhidden [18]: #setdisabled
[19]: #delreadonly [19]: #delhidden
[20]: #deldisabled [20]: #delreadonly
[21]: #togglehidden [21]: #deldisabled
[22]: #togglereadonly [22]: #togglehidden
[23]: #toggledisabled [23]: #togglereadonly
[24]: #on [24]: #toggledisabled
[25]: #parameters-7 [25]: #on
[26]: #onclick [26]: #parameters-7
[27]: #parameters-8 [27]: #onclick
[28]: #found [28]: #parameters-8
[29]: #first [29]: #found
[30]: #last [30]: #first
[31]: #gsd [31]: #last
[32]: #parameters-9 [32]: #gsd
[33]: #version [33]: #parameters-9
[34]: #gsd-1 [34]: #version
[35]: #version-1 [35]: #gsd-1
[36]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String [36]: #version-1
[37]: https://developer.mozilla.org/docs/Web/HTML/Element [37]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String
[38]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function [38]: https://developer.mozilla.org/docs/Web/HTML/Element
[39]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean [39]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function
[40]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean

View File

@@ -2,6 +2,10 @@ window.$_ = (() => {
'use strict'; 'use strict';
/** /**
* Création du constructeur * Création du constructeur
*
* @example
* let element = $_("a.link", "div#main");
*
* @param {String} selector Sélecteur utilisé * @param {String} selector Sélecteur utilisé
* @param {HTMLElement} scope Racine de la recherche * @param {HTMLElement} scope Racine de la recherche
*/ */