# j-Period

> Le composant pour la sélection d'une période de temps.

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: fr
Content-SHA256: 12663a203a97fd50b858d6d8304d927b65dc3b56f4194bab11c5ae7872fabace
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: components@910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e
Review: not-recorded

Le composant pour la sélection d'une période de temps.

- singleton

__Méthodes__ :

Méthode : `component.show(options)`

- `options.element` {Element/jQuery Element} - Tous les calculs d'alligment seront relatives à cet élément
- `options.align` Alignez le composant par rapport à l'élément dans la propriété `options.element`. Propriétés disponibles: 'centre', 'à gauche' et 'à droite'.
- La fonction `options.callback`, qui sera exécutée en cliquant sur le bouton 'Application' du composant - reçoit deux paramètres: les objets de date de début et de fin
- `options.start`, `options.end` {Date} - Afin de pré-déterminer la période sélectionnée, il convient d'indiquer ** les deux** de ces propriétés.


__Configuration__ :

- `firstday` - {String} - Permet de définir le premier jour de la semaine à lundi. La valeur défaite est 'Monday' - Les jours de la journée commencent du lundi.
- `dateformat` - {String} - spécifie le format de date. la valeur par défaut - `DEF.dateformat`
- `apply` - {String} - Étiquette pour le bouton "Apply"
- `cancel` - {String} - Étiquette pour le bouton "Cancel"
- `custom` - {String} - Étiquette pour le bouton de filtre "Custom"
- `month` - {String} - Étiquette pour le bouton de filtre "Mont actuel"
- `thisY` - {String} - Étiquette pour le bouton de filtre "Cette année"
- `lastY` - {String} - Étiquette pour le bouton de filtre "L'année dernière"

Utilisez-le avec `<ui-component name="period">`. Lorsque le composant n'est pas encore chargé, jComponent le télécharge lors de la première utilisation depuis l'adresse dans `DEF.fallback` (le CDN Componentator par défaut). Auteur : Kirill Zlobine. Source : le référentiel de composants Componentator, licence MIT.

```html example.html
<ui-component name="LAZY period"></ui-component>

<button class="btn">Click</button>

<script>

    $(document).on('click', '.btn', function() {
        var opt = {};
        opt.element = $(this);
        opt.align = 'left';
        opt.callback = function(start, end) {
            console.log(start);
            console.log(end);
        };
        SETTER('period/show', opt);
    });


</script>
```