BakuJS

• Date
• Math
• Number
• String
• DOM

↑ Date

Date.prototype._getMonthName([langue])

Retour le nom du mois d'une date.

1. langue (string) : 'fr' pour français.
   Si non renseigné, utilise la langue du navigateur.

new Date('2012-09-30')._getMonthName(); // septembre  

Date.prototype._getDayName([langue])

Retour le nom du jour de la semaine d'une date.

1. langue (string) : 'fr' pour français.
   Si non renseigné, utilise la langue du navigateur.

new Date('2012-09-30')._getDayName(); // dimanche

Date.prototype._getDayOfYear()

Retour le numéro du jour de l'anné d'une date.

new Date('2012-09-30')._getDayOfYear(); // 275

Date.prototype._getWeek([mode])

Retour le numéro de semaine d'une date.

1. mode (int) : 1 pour ISO (la semaine commence par le lundi), 0 pour US/UK (la semaine commande par le dimanche).
   Si non renseigné, retourne au format ISO.

new Date('2012-09-30')._getWeek();  // 39 (format ISO)
new Date('2012-09-30')._getWeek(0); // 40 (format US/UK)

Date.prototype._toStringFormat(pattern, [langue])

Retour une version formatée de la date.

1. pattern (string) : formatage de la date. (Voir les règles dans le tableau ci-dessous.)
2. langue (string) : 'fr' pour français.
   Si non renseigné, utilise la langue du navigateur.

new Date('2012-02-03T17:04:01')._toStringFormat('dd/MM/yyyy HH\\h mm\\m ss\\s SSS'; // 03/02/2012 17h 04m 01s 000

Les règles sont les suivantes (avec la date '2012-02-03T17:04:01') :

↑ Math

Math._roundDecimal(number, decimal)

Arrondir à une décimale précise.

1. number (Number) : nombre à arrondir
2. decimal (int) : nombre de décimales à concerver en arrondissant (0.5 est arrondi à 1)

Math._roundDecimal(123.5678,  2);  // 123.57
Math._roundDecimal(123.5678, -2);  // 100

↑ Number

Number.prototype._formatByPattern([pattern, [params]])

Formate un nombre avec un pattern.

1. pattern (String) : règles de formatages. (Voir les règles dans le tableau ci-dessous.)
   Si non renseigné, utilisera le pattern '#,###'.
2. params (Object) :
   － dot : forme du séparateur de décimales (défaut : rien)
   － space : sparateur de millier (ou autre) (défaut : rien)
   － language : langue de formatage (défaut : langue du navigateur)
   Si non renseigné, aucun params.

new Number(2591.5978)._formatByPattern('#,###.00', {language : 'fr'});  // 2 591,60

Les règles sont les suivantes :

Number.prototype._format([params])

Formate un nombre avec différents paramètres.

1. params (Object) :
   － groupingSize : séparateur de lisiblité (0 = aucun)
   － zeroDigitSize : nombre de chiffres minimums
   － decimalSize : nombre de décimales affichées
   － decimalZeroSize : nombre de chiffres minimums en décimal
   － dot : forme du séparateur de décimales (défaut : rien)
   － space : spérateur de millier (ou autre) (défaut : rien)
   － unit : rien ou %
   Si non renseigné, aucun params.

new Number(2591.5978)._format({groupingSize : 3, decimalSize : 2, dot : ',', space : ' '});  // 2 591,6

↑ String

String.prototype._format(var1[, var2...n])

Formateur suivant un ouplusieurs paramètres.

1. var1 (mixed) :
   － si Array : prend la liste et ignore les autres valeurs
   － si Object : prend l'object et ignore les autres valeurs
   － sinon : prend la liste des valeurs (var1, var2, var3, etc.) suivant leur position
   Si non renseigné, ne formate rien.

Pour faire simple, voilà les équivalences d'écriture :

'Le petit {0} de la {1}.'._format('chien', 'voisine');                                     // Le petit chien de la voisine.
'Le petit {0} de la {1}.'._format(['chien', 'voisine']);                                   // Le petit chien de la voisine.
'Le petit {animal} de la {personne}.'._format({ animal : 'chien', personne : 'voisine'});  // Le petit chien de la voisine.

Il est possible d'aller plus loin et d'utiliser les formateurs :

• choice : {0, choice, 1# an|1> ans}
• number : {0, number, #,##0}
• date : {0,date, dd/MM/yyyy}

"Il y a {0, number, #,##0:fr} jour{0, choice,1>=|1<s}".format(1200);                 // Il y a 1 200 jours
"Il y a {jours, number, #,##0:fr} jour{jours, choice,1>=|1<s}".format({jours : 1});  // Il y a 1 jour
"Le resultat est {0, choice, 10>{1}|10<={2}}.".format([12, 'petit', 'grand']);       // Le resultat est grand

Il n'y pas de limite dans le nombre de récursions. Ceci est possible :

{0, choice, 1# {1, number, {2} }| 2# {1, date, {2} } }

choice

Le formateur support les conditions suivantes suivant un « ou ». Dans l'ordre, la première qui sera vraie sera validée :

• # pour l'égalié
• >, >=, <, <= pour les conditions

{0, choise, 0# rien|2> peu de choses|5>= un peu plus de chose|5< beaucoup de chose}

Attention : il n'y a pas valeur si aucune condition respectée.

number

Le formateur numérique support les mêmes patterns que Number.prototype._format().

{0, number, #,##0:fr}

date

Le formateur numérique support les mêmes patterns que Date.prototype._toStringFormat().

{0, date, dd/MM/yyyy}

Attention : la date d'entrée doit être au format ISO (Ex. : 2016-10-20T17:59:59.000) ou japonais (2016/10/20 17:59:59.000). Les formats français (JJ/MM/AAAA) et US (MM/JJ/AAAA) posent des problèmes suivant le navigateur.

String.prototype._padLeft(n, str[, mode])

Étrendre une chaîne par la gauche avec un masque.

1. n (int) : taille souhaitée de la chaîne.
2. str (String) : chaine pour le masque de répétion
3. mode (String) :
   － rien (défaut) : répète la chaîne autant de fois que possible en partant de la gauche.
   － l : répète la chaîne comme un masque qui part de la droite vers la gauche.
   － r : répète la chaîne comme un masque qui part de la gauche vers la droite.
   Si non renseigné, prend le mode par défaut. Si la chaîne est de taille 1, le mode est ignoré.

'X'._padLeft(10, 'ABCD')       // DABCDABCDX
'X'._padLeft(10, 'ABCD', 'l')  // CDABCDABCX
'X'._padLeft(10, 'ABCD', 'r')  // ABCDABCDAX

String.prototype._padRight(n, str[, mode])

Étrendre une chaine par la droite avec un masque.

1. n (int) : taille souhaitée de la chaine.
2. str (String) : chaîne pour le masque de répétion
3. mode (String) :
   － rien (défaut) : répète la chaîne autant de fois que possible en partant de la droite.
   － l : répète la chaîne comme un masque qui part de la droite vers la gauche.
   － r : répète la chaîne comme un masque qui part de la gauche vers la droite.
   Si non renseigné, prend le mode par défaut. Si la chaîne est de taille 1, le mode est ignoré.

'X'._padRight(10, 'ABCD')       // XABCDABCDA
'X'._padRight(10, 'ABCD', 'l')  // XDABCDABCD
'X'._padRight(10, 'ABCD', 'r')  // XBCDABCDAB

↑ DOM

Raccourcis

• baku.dom.id = document.elementById
• baku.dom.first = document.querySelector
• baku.dom.list = document.querySelectorAll
• baku.dom.new = document.createElement

Aides

• HTMLElement._css() : ajout s'implifié de CSS sur un élement du DOM
• HTMLElement._addClass() : ajout s'implifié d'une classe sur un élement du DOM
• HTMLElement._rmClass() : ajout s'implifié d'une classe sur un élement du DOM
• NodeList._css() : ajout s'implifié de CSS sur une liste d'élements du DOM
• NodeList._addClass() : ajout s'implifié d'une classe sur une liste d'élements du DOM
• NodeList._rmClass() : suppression s'implifié d'une classe sur une liste d'élements du DOM

Exemples

baku.dom.list('h2 + div')
    ._css({'color' : 'red', 'text-decoration' : 'underline'})
    ._rmClass('ko');