# j-Calendar

> Le composant doit être appelé manuellement ou fonctionne automatiquement avec le composant textbox ou j-Input. Le composant est un singleton.

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

- prend en charge le __mode sombre__
- prend en charge les gestes __touch (balayage)__ et la taille réelle fixe sur mobile

__Configuration__ :

- `firstday` {Number} (facultatif) premier jour de la semaine
- Libellé `today` {String} (facultatif) pour le bouton `Set today`
- `days` {String} (facultatif) jours, par ex. `SU,MO,TU,WE,TH,FR,SA` (par défaut).
- `months` {String} (facultatif) mois, par ex. `January,February,...` (par défaut).
- Liste déroulante `yearselect` {Booléen} (facultatif) avec les années (par défaut `true`).
- Liste déroulante `monthselect` {Booléen} (facultatif) avec mois (par défaut `true`).
- `yearfrom` {String} (facultatif) définit la limite minimale d'année dans la liste déroulante, par ex. `-5 years` `current` (par défaut `-100 years`).
- `yearto` {String} (facultatif) définit la limite maximale d'année dans la liste déroulante `+5 years` `current` (par défaut `current`).

Le composant doit être appelé manuellement ou fonctionne automatiquement avec le composant `textbox` ou `j-Input`. Le composant est un singleton.

- fonctionne __only__ avec Bootstrap Grid System (sinon il faut corriger CSS)
- __important__ ajouter le composant calendrier sous l'élément `<body>`

## Utilisation

```javascript
var ELEMENT = $(document);
var PATH = 'some.path.to.date';
var X_OFFSET = 100;
FIND('calendar').toggle(ELEMENT, PATH, function(date) {
	console.log('SELECTED DATE:', date);
}, X_OFFSET);

// OR

FIND('calendar').toggle(ELEMENT, 'path.to.date OR date object', 'path.to.binding.date');
```

Utilisez-le avec `<ui-component name="calendar">`. 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 : Peter Širka. Source : le référentiel de composants Componentator, licence MIT.

```html example.html
<a href="#calendar">SHOW CALENDAR</a>
<ui-component name="calendar" config="today:Set today;firstday:0"></ui-component>

<script>
	var form = {};
	form.date = new Date();

	$('a[href="#calendar"]').on('click', function(e) {
		SETTER('calendar', 'toggle', $(this), form.date, function(date) {
			alert(date);
		});
	});
</script>
```