jQuery EasyUI Form Plugin -Datebox Boîte de date
jQuery EasyUI Plugin
Hérite de $.fn.combo.defaults. Surchargez les valeurs par défaut via $.fn.datebox.defaults.
La datebox combine une zone de texte modifiable avec un panneau de calendrier déroulant, à partir duquel l'utilisateur peut sélectionner une date. La chaîne saisie dans la zone de texte peut être convertie en une date valide. La date sélectionnée peut également être convertie dans le format souhaité.
Dépendances
- combo
- calendrier
Utilisation
Créer une datebox à partir du balisage.
<input id="dd" type="text" class="easyui-datebox" required="required">
Créer une datebox en JavaScript.
<input id="dd" type="text">
$('#dd').datebox({
required:true
});
Propriétés
Ces propriétés héritent de combo. Voici les propriétés ajoutées pour datebox.
| Name | Type | Description | Valeur par défaut |
|---|---|---|---|
| panelWidth | nombre | La largeur du panneau de calendrier déroulant. | 180 |
| panelHeight | nombre | La hauteur du panneau de calendrier déroulant. | auto |
| currentText | string | Le texte affiché sur le bouton du jour actuel. | Aujourd'hui |
| closeText | string | Le texte affiché sur le bouton de fermeture. | Close |
| okText | string | Le texte affiché sur le bouton OK. | OK |
| disabled | booléen | Désactive le champ lorsqu'il est défini sur true. | false |
| buttons | array | Les boutons sous le calendrier. Cette propriété est disponible depuis la version 1.3.5. Exemple de code :
var buttons = $.extend([], $.fn.datebox.defaults.buttons);
buttons.splice(1, 0, {
text: 'MyBtn',
handler: function(target){
alert('click MyBtn');
}
});
$('#dd').datebox({
buttons: buttons
});
|
|
| sharedCalendar | string,selector | Un calendrier partagé utilisé par plusieurs composants datebox. Cette propriété est disponible depuis la version 1.3.5. Exemple de code : <input class="easyui-datebox" sharedCalendar="#sc"> <input class="easyui-datebox" sharedCalendar="#sc"> <div id="sc" class="easyui-calendar"></div> |
null |
| formatter | fonction | Une fonction pour formater les dates. Cette fonction a un paramètre 'date' et renvoie une valeur de chaîne. L'exemple suivant montre comment remplacer la fonction formatter par défaut.
$.fn.datebox.defaults.formatter = function(date){
var y = date.getFullYear();
var m = date.getMonth()+1;
var d = date.getDate();
return m+'/'+d+'/'+y;
}
|
|
| parser | fonction | Une fonction pour analyser les chaînes de date. Cette fonction prend une chaîne 'date' et renvoie une valeur de date. L'exemple suivant montre comment remplacer la fonction parser par défaut.
$.fn.datebox.defaults.parser = function(s){
var t = Date.parse(s);
if (!isNaN(t)){
return new Date(t);
} else {
return new Date();
}
}
|
Événements
| Name | Parameters | Description |
|---|---|---|
| onSelect | date | Déclenché lorsque l'utilisateur sélectionne une date. Exemple de code :
$('#dd').datebox({
onSelect: function(date){
alert(date.getFullYear()+":"+(date.getMonth()+1)+":"+date.getDate());
}
});
|
Méthodes
Ces méthodes étendent de combo. Ci-dessous se trouvent les méthodes remplacées pour datebox.
| Name | Parameters | Description |
|---|---|---|
| options | none | Renvoie l'objet options. |
| calendrier | none | Obtenir l'objet calendrier. L'exemple suivant montre comment obtenir l'objet calendrier et le rendre à nouveau.
// get the calendar object
var c = $('#dd').datebox('calendar');
// set the first day of week to monday
c.calendar({
firstDay: 1
});
|
| setValue | value | Définir la valeur du datebox. Exemple de code :
$('#dd').datebox('setValue', '6/1/2012'); // set datebox value
var v = $('#dd').datebox('getValue'); // get datebox value
|
jQuery EasyUI Plugin Autres extensions