Sebastien/GSDom
1
1
Fork 0
Code Issues Pull Requests Projects Releases 3 Wiki Activity

Mise à jour de la documentation

Browse Source
This commit is contained in:
Sébastien G.
2022-01-03 22:54:01 +01:00
parent 1cd690ef60
commit 4512c40a97
3 changed files with 160 additions and 93 deletions
Download Patch File Download Diff File Expand all files Collapse all files

226
DOCUMENTATION.md
View File

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

2
dist/gsdom.min.js vendored
View File

@@ -1 +1 @@
window.$_=(()=>{"use strict";let t=function(t,e){if(t)if("document"===t)this.elems=[document];else if("window"===t)this.elems=[window];else{let i=e||document;this.elems=i.querySelectorAll(t)}};t.prototype.each=function(t){if(t&&"function"==typeof t)return this.elems.forEach((e,i)=>{t(e,i)}),this},t.prototype.addClass=function(t){return this.each(e=>{e.classList.add(t)}),this},t.prototype.removeClass=function(t){return this.each(e=>{e.classList.remove(t)}),this},t.prototype.replaceClass=function(t,e){return this.each(i=>{i.classList.replace(t,e)}),this},t.prototype.setAttr=function(t,e){return this.each(i=>{i.setAttribute(t,e)}),this},t.prototype.delAttr=function(t){return this.each(e=>{e.removeAttribute(t)}),this},t.prototype.setHidden=function(){return this.setAttr("hidden",""),this},t.prototype.setReadOnly=function(){return this.setAttr("readonly",""),this},t.prototype.setDisabled=function(){return this.setAttr("disabled",""),this},t.prototype.delHidden=function(){return this.delAttr("hidden"),this},t.prototype.delReadOnly=function(){return this.delAttr("readonly"),this},t.prototype.delDisabled=function(){return this.delAttr("disabled"),this},t.prototype.toggleHidden=function(){return this.each(t=>{t.hasAttribute("hidden")?t.removeAttribute("hidden"):t.setAttribute("hidden","")}),this},t.prototype.toggleReadOnly=function(){return this.each(t=>{t.hasAttribute("readonly")?t.removeAttribute("readonly"):t.setAttribute("readonly","")}),this},t.prototype.toggleDisabled=function(){return this.each(t=>{t.hasAttribute("disabled")?t.removeAttribute("disabled"):t.setAttribute("disabled","")}),this},t.prototype.on=function(t,e,i){return this.each(r=>{r.removeEventListener(t,e,i||!1),r.addEventListener(t,(t,i)=>{e(t,i)},i||!1)}),this},t.prototype.onClick=function(t,e){return this.on("click",t,e||!1),this},t.prototype.found=function(){return this.elems.length>0},t.prototype.first=function(){return!!this.found()&&this.elems[0]},t.prototype.last=function(){return!!this.found()&&this.elems[this.elems.length-1]};let e=(e,i)=>new t(e,i);return e.version="GSD 1.1.0 by Séb",e})();
window.$_=(()=>{"use strict";let t=function(t,e){if(t)if("document"===t)this.elems=[document];else if("window"===t)this.elems=[window];else{let i=e||document;this.elems=i.querySelectorAll(t)}};t.prototype.each=function(t){if(t&&"function"==typeof t)return this.elems.forEach((e,i)=>{t(e,i)}),this},t.prototype.addClass=function(t){return this.each(e=>{e.classList.add(t)}),this},t.prototype.removeClass=function(t){return this.each(e=>{e.classList.remove(t)}),this},t.prototype.replaceClass=function(t,e){return this.each(i=>{i.classList.replace(t,e)}),this},t.prototype.setAttr=function(t,e){return this.each(i=>{i.setAttribute(t,e)}),this},t.prototype.delAttr=function(t){return this.each(e=>{e.removeAttribute(t)}),this},t.prototype.setHidden=function(){return this.setAttr("hidden",""),this},t.prototype.setReadOnly=function(){return this.setAttr("readonly",""),this},t.prototype.setDisabled=function(){return this.setAttr("disabled",""),this},t.prototype.delHidden=function(){return this.delAttr("hidden"),this},t.prototype.delReadOnly=function(){return this.delAttr("readonly"),this},t.prototype.delDisabled=function(){return this.delAttr("disabled"),this},t.prototype.toggleHidden=function(){return this.each(t=>{t.hasAttribute("hidden")?t.removeAttribute("hidden"):t.setAttribute("hidden","")}),this},t.prototype.toggleReadOnly=function(){return this.each(t=>{t.hasAttribute("readonly")?t.removeAttribute("readonly"):t.setAttribute("readonly","")}),this},t.prototype.toggleDisabled=function(){return this.each(t=>{t.hasAttribute("disabled")?t.removeAttribute("disabled"):t.setAttribute("disabled","")}),this},t.prototype.on=function(t,e,i){return this.each(r=>{r.removeEventListener(t,e,i||!1),r.addEventListener(t,(t,i)=>{e(t,i)},i||!1)}),this},t.prototype.onClick=function(t,e){return this.on("click",t,e||!1),this},t.prototype.found=function(){return this.elems.length>0},t.prototype.first=function(){return!!this.found()&&this.elems[0]},t.prototype.last=function(){return!!this.found()&&this.elems[this.elems.length-1]};let e=(e,i)=>new t(e,i);return e.version="GSD 1.1.1 by Séb",e})();

25
src/gsdom.js
View File

@@ -4,7 +4,8 @@ window.$_ = (() => {
* Création du constructeur
*
* @example
* let element = $_("a.link", "div#main");
* # Tous les a class link contenu dans un div id main
* $_("a.link", "div#main");
*
* @param {String} selector Sélecteur utilisé
* @param {HTMLElement} scope Racine de la recherche
@@ -24,6 +25,12 @@ window.$_ = (() => {
};
/**
* Application d'une fonction sur chacun des éléments
*
* @example
* $_(".class").each((item, index) => {
* // Do something with item et index
* });
*
* @param {Function} callback La fonction de rappel
*/
Constructor.prototype.each = function (callback) {
@@ -37,6 +44,10 @@ window.$_ = (() => {
};
/**
* Ajout d'une classe aux éléments sélectionnés
*
* @example
* $_("p","div#main").addClass("myClass");
*
* @param {String} className Le nom de la classe à ajouter
* @returns {this} Chainage
*/
@@ -47,7 +58,11 @@ window.$_ = (() => {
return this;
};
/**
* Ajout d'une classe aux éléments sélectionnés
* Suppression d'une classe aux éléments sélectionnés
*
* @example
* $_("p","div#main").removeClass("myClass");
*
* @param {String} className Le nom de la classe à ajouter
* @returns {this} Chainage
*/
@@ -59,6 +74,10 @@ window.$_ = (() => {
};
/**
* Remplace une classe par une autre dans les éléments sélectionnés
*
* @example
* $_("p","div#main").replaceClass("myOldClass", "myNewClass");
*
* @param {String} oldClass Nom de la classe à remplacer
* @param {String} newClass Nom de la classe de remplacement
* @returns {this} Chainage
@@ -238,7 +257,7 @@ window.$_ = (() => {
/**
* Version de la librairie
*/
gsd.version = 'GSD 1.1.0 by Séb';
gsd.version = 'GSD 1.1.1 by Séb';
/**
* @return Retour de la librairie
*/