jQuery EasyUI Data Grid et Tree Plugin -Datagrid Data Grid
Plugins jQuery EasyUI
Hérite de $.fn.panel.defaults. Remplacez les valeurs par défaut par $.fn.datagrid.defaults.
Le datagrid affiche les données dans un format de tableau et offre une riche prise en charge de la sélection, du tri, du regroupement et de la modification des données. Le datagrid est conçu pour réduire le temps de développement et ne nécessite pas que les développeurs possèdent des connaissances spécifiques. Il est léger mais riche en fonctionnalités. Ses fonctionnalités incluent la fusion de cellules, les en-têtes multi-colonnes, les colonnes figées, les pieds de page, et plus encore.
Dépendances
- panel
- redimensionnable
- linkbutton
- pagination
Utilisation
Créer un datagrid à partir d'un élément table existant, en définissant les colonnes, les lignes et les données en HTML.
<table class="easyui-datagrid">
<thead>
<tr>
<th data-options="field:'code'">Code</th>
<th data-options="field:'name'">Name</th>
<th data-options="field:'price'">Price</th>
</tr>
</thead>
<tbody>
<tr>
<td>001</td><td>name1</td><td>2323</td>
</tr>
<tr>
<td>002</td><td>name2</td><td>4612</td>
</tr>
</tbody>
</table>
Créer un datagrid via le balisage <table>. Les balises <th> imbriquées définissent les colonnes du tableau.
<table class="easyui-datagrid" style="width:400px;height:250px"
data-options="url:'datagrid_data.json',fitColumns:true,singleSelect:true">
<thead>
<tr>
<th data-options="field:'code',width:100">Code</th>
<th data-options="field:'name',width:100">Name</th>
<th data-options="field:'price',width:100,align:'right'">Price</th>
</tr>
</thead>
</table>
Vous pouvez également créer un datagrid à l'aide de JavaScript.
<table id="dg"></table>
$('#dg').datagrid({
url:'datagrid_data.json',
columns:[[
{field:'code',title:'Code',width:100},
{field:'name',title:'Name',width:100},
{field:'price',title:'Price',width:100,align:'right'}
]]
});
Interroger des données via certains paramètres.
$('#dg').datagrid('load', {
name: 'easyui',
address: 'ho'
});
Après avoir envoyé les données modifiées au serveur, mettre à jour les données du frontend.
$('#dg').datagrid('reload'); // reload the current page data
Propriétés de DataGrid
Les propriétés héritent de panel. Les propriétés suivantes sont ajoutées pour le datagrid.
| Name | Type | Description | Valeur par défaut |
|---|---|---|---|
| columns | array | L'objet de configuration pour les colonnes du datagrid. Pour plus de détails, voir les propriétés de Column. | undefined |
| frozenColumns | array | Identique aux propriétés de Column, mais ces colonnes seront figées sur le côté gauche. | undefined |
| fitColumns | booléen | Si défini sur true, la taille des colonnes s'agrandira ou se réduira automatiquement pour s'adapter à la largeur de la grille et empêcher le défilement horizontal. | false |
| resizeHandle | string | Ajuste la position des colonnes. Les valeurs disponibles sont : 'left', 'right', 'both'. Lorsque la valeur est 'right', l'utilisateur peut redimensionner la colonne en faisant glisser le bord droit de l'en-tête de colonne. Cette propriété est disponible depuis la version 1.3.2. |
right |
| autoRowHeight | booléen | Définit s'il faut définir la hauteur de ligne en fonction du contenu de la ligne. Définir sur false pour améliorer les performances de chargement. | vrai |
| toolbar | tableau, sélecteur | La barre d'outils d'en-tête du panneau datagrid. Valeurs possibles : 1. Tableau, chaque option d'outil est identique à un linkbutton. 2. Sélecteur, simplement une barre d'outils. Définir la barre d'outils dans une balise <div> :
$('#dg').datagrid({
toolbar: '#tb'
});
<div id="tb">
<a href="../index.html" class="easyui-linkbutton" data-options="iconCls:'icon-edit',plain:true"></a>
<a href="../index.html" class="easyui-linkbutton" data-options="iconCls:'icon-help',plain:true"></a>
</div>
Définir la barre d'outils via un tableau :
$('#dg').datagrid({
toolbar: [{
iconCls: 'icon-edit',
handler: function(){alert('edit')}
},'-',{
iconCls: 'icon-help',
handler: function(){alert('help')}
}]
});
|
null |
| striped | booléen | Si défini sur true, les lignes seront zébrées. (c'est-à-dire que les lignes impaires et paires utilisent des couleurs d'arrière-plan différentes) | false |
| method | string | Le type de méthode pour demander des données distantes. | post |
| nowrap | booléen | Si défini sur true, les données seront affichées sur une seule ligne. Définissez sur true pour améliorer les performances de chargement. | vrai |
| idField | string | Indique quel champ est le champ identifiant. | null |
| url | string | L'URL à utiliser pour demander des données au site distant. | null |
| data | array,object | Les données à charger. Cette propriété est disponible depuis la version 1.3.2. Exemple de code :
$('#dg').datagrid({
data: [
{f1:'value11', f2:'value12'},
{f1:'value21', f2:'value22'}
]
});
|
null |
| loadMsg | string | Le message d'invite affiché pendant le chargement des données depuis le site distant. | Traitement en cours, veuillez patienter … |
| pagination | booléen | Si défini sur true, la barre d'outils de pagination sera affichée en bas du datagrid. | false |
| rownumbers | booléen | Si défini sur true, une colonne avec les numéros de ligne sera affichée. | false |
| singleSelect | booléen | Si défini sur true, une seule ligne peut être sélectionnée. | false |
| checkOnSelect | booléen | Si défini sur true, lorsque l'utilisateur clique sur une ligne, la case à cocher sera cochée/décochée. Si défini sur false, la case à cocher sera cochée/décochée uniquement lorsque l'utilisateur clique sur la case à cocher. Cette propriété est disponible depuis la version 1.3. |
vrai |
| selectOnCheck | booléen | Si défini sur true, cliquer sur la case à cocher sélectionnera la ligne. Si défini sur false, sélectionner la ligne ne cochera pas la case à cocher. Cette propriété est disponible depuis la version 1.3. |
vrai |
| pagePosition | string | Définit la position de la barre de pagination. Les valeurs disponibles sont : 'top', 'bottom', 'both'. Cette propriété est disponible depuis la version 1.3. |
bottom |
| pageNumber | nombre | Le numéro de page initial lorsque la propriété pagination est définie. | 1 |
| pageSize | nombre | La taille de page initiale lorsque la propriété pagination est définie. | 10 |
| pageList | array | La liste des tailles de page sélectionnables lorsque la propriété pagination est définie. | [10,20,30,40,50] |
| queryParams | objet | Les paramètres supplémentaires à envoyer lors de la demande de données distantes. Exemple de code :
$('#dg').datagrid({
queryParams: {
name: 'easyui',
subject: 'datagrid'
}
});
|
{} |
| sortName | string | Définit les colonnes qui peuvent être triées. | null |
| sortOrder | string | Définit l’ordre de tri de la colonne, seuls 'asc' ou 'desc' peuvent être utilisés. | asc |
| multiSort | booléen | Définit si le tri sur plusieurs colonnes doit être activé. Cette propriété est disponible depuis la version 1.3.4. | false |
| remoteSort | booléen | Définit s'il faut trier les données provenant du serveur. | vrai |
| showHeader | booléen | Définit s'il faut afficher l'en-tête. | vrai |
| showFooter | booléen | Définit s'il faut afficher le pied de page. | false |
| scrollbarSize | nombre | La largeur de la barre de défilement (lorsque la barre de défilement est verticale) ou la hauteur de la barre de défilement (lorsque la barre de défilement est horizontale). | 18 |
| rowStyler | fonction | Renvoie un style tel que 'background:red'. Cette fonction prend deux paramètres : rowIndex : L'index de la ligne, à partir de 0. rowData : L'enregistrement correspondant à cette ligne. Exemple de code :
$('#dg').datagrid({
rowStyler: function(index,row){
if (row.listprice>80){
return 'background-color:#6293BB;color:#fff;'; // return inline style
// the function can return predefined css class and inline style
// return {class:'r1', style:{'color:#fff'}};
}
}
});
|
|
| loader | fonction | Définit comment charger les données depuis le serveur distant. Renvoyer false annule l'action. Cette fonction possède les paramètres suivants : param : L'objet de paramètres à transmettre au serveur distant. success(data) : La fonction de rappel appelée lorsque les données sont récupérées avec succès. error() : La fonction de rappel appelée lorsque la récupération des données échoue. |
chargeur json |
| loadFilter | fonction | Renvoie les données filtrées à afficher. Cette fonction possède un paramètre 'data', qui représente les données brutes. Vous pouvez convertir les données brutes en un format de données standard. Cette fonction doit renvoyer un objet de données standard contenant les propriétés 'total' et 'rows'. Exemple de code :
// removing 'd' object from asp.net web service json output
$('#dg').datagrid({
loadFilter: function(data){
if (data.d){
return data.d;
} else {
return data;
}
}
});
|
|
| editors | objet | Définit l'éditeur lors de l'édition des lignes. | éditeurs prédéfinis |
| vue | objet | Définit la vue du datagrid. | vue par défaut |
Propriétés des colonnes
La colonne du DataGrid est un objet tableau, chacun de ses éléments est également un tableau. Les éléments du tableau d'éléments sont un objet de configuration qui définit les champs de chaque colonne.
Exemple de code :
columns:[[
{field:'itemid',title:'Item ID',rowspan:2,width:80,sortable:true},
{field:'productid',title:'Product ID',rowspan:2,width:80,sortable:true},
{title:'Item Details',colspan:4}
],[
{field:'listprice',title:'List Price',width:80,align:'right',sortable:true},
{field:'unitcost',title:'Unit Cost',width:80,align:'right',sortable:true},
{field:'attr1',title:'Attribute',width:100},
{field:'status',title:'Status',width:60}
]]
| Name | Type | Description | Valeur par défaut |
|---|---|---|---|
| title | string | Le texte du titre de la colonne. | undefined |
| champ | string | Le nom du champ de la colonne. | undefined |
| width | nombre | La largeur de la colonne. Si elle n'est pas définie, la largeur s'étendra automatiquement pour s'adapter à son contenu. Ne pas définir la largeur réduira les performances. | undefined |
| rowspan | nombre | Indique sur combien de lignes une cellule s'étend. | undefined |
| colspan | nombre | Indique sur combien de colonnes une cellule s'étend. | undefined |
| align | string | Indique comment aligner les données de cette colonne. Valeurs possibles : 'left', 'right', 'center'. | undefined |
| halign | string | Indique comment aligner l'en-tête de cette colonne. Valeurs possibles : 'left', 'right', 'center'. Si aucune valeur n'est attribuée, l'alignement de l'en-tête sera cohérent avec l'alignement des données défini par la propriété 'align'. Cette propriété est disponible depuis la version 1.3.2. | undefined |
| sortable | booléen | Si défini sur true, cette colonne peut être triée. | undefined |
| order | string | L'ordre de tri par défaut, seuls 'asc' ou 'desc' peuvent être utilisés. Cette propriété est disponible depuis la version 1.3.2. | undefined |
| redimensionnable | booléen | Si défini sur true, cette colonne peut être redimensionnée. | undefined |
| fixed | booléen | Si défini sur true, cela empêche l'ajustement de la largeur lorsque 'fitColumns' est défini sur true. | undefined |
| hidden | booléen | Si défini sur true, cette colonne est masquée. | undefined |
| checkbox | booléen | Si défini sur true, une case à cocher est affichée. La case à cocher a une largeur fixe. | undefined |
| formatter | fonction | La fonction de formatage pour la cellule, nécessitant trois paramètres : value : La valeur du champ. rowData : Les données d'enregistrement de la ligne. rowIndex : L'index de la ligne. Exemple de code :
$('#dg').datagrid({
columns:[[
{field:'userId',title:'User', width:80,
formatter: function(value,row,index){
if (row.user){
return row.user.name;
} else {
return value;
}
}
}
]]
});
|
undefined |
| styler | fonction | La fonction de style de la cellule, retourne une chaîne de style permettant de personnaliser le style de la cellule, par exemple 'background:red'. Cette fonction prend trois paramètres : value : La valeur du champ. rowData : Les données d'enregistrement de la ligne. rowIndex : L'index de la ligne. Exemple de code :
$('#dg').datagrid({
columns:[[
{field:'listprice',title:'List Price', width:80, align:'right',
styler: function(value,row,index){
if (value < 20){
return 'background-color:#FFEE00;color:red;';
// the function can return predefined css class and inline style
// return {class:'c1',style:'color:red'}
}
}
}
]]
});
|
undefined |
| sorter | fonction | La fonction de tri pour les champs personnalisés utilisée pour le tri local, prend deux paramètres : a : La première valeur du champ. b : La deuxième valeur du champ. Exemple de code :
$('#dg').datagrid({
remoteSort: false,
columns: [[
{field:'date',title:'Date',width:80,sortable:true,align:'center',
sorter:function(a,b){
a = a.split('/');
b = b.split('/');
if (a[2] == b[2]){
if (a[0] == b[0]){
return (a[1]>b[1]?1:-1);
} else {
return (a[0]>b[0]?1:-1);
}
} else {
return (a[2]>b[2]?1:-1);
}
}
}
]]
});
|
undefined |
| editor | string,object | Indique le type d'édition. Lorsqu'il s'agit d'une chaîne, il fait référence au type d'édition ; lorsqu'il s'agit d'un objet, il contient deux propriétés : type: string, le type d'édition. Types possibles : text, textarea, checkbox, numberbox, validatebox, datebox, combobox, combotree. options: object, les options de l'éditeur correspondant au type d'édition. |
undefined |
Éditeur
Surchargez les valeurs par défaut via $.fn.datagrid.defaults.editors.
Chaque éditeur a les comportements suivants :
| Name | Parameters | Description |
|---|---|---|
| init | container, options | Initialiser l'éditeur et renvoyer l'objet cible. |
| destroy | target | Détruire l'éditeur si nécessaire. |
| getValue | target | Obtenir la valeur à partir du texte de l'éditeur. |
| setValue | target , value | Définir la valeur dans l'éditeur. |
| resize | target , width | Redimensionner l'éditeur si nécessaire. |
Par exemple, l'éditeur de texte est défini comme suit :
$.extend($.fn.datagrid.defaults.editors, {
text: {
init: function(container, options){
var input = $('<input type="text" class="datagrid-editable-input">').appendTo(container);
return input;
},
destroy: function(target){
$(target).remove();
},
getValue: function(target){
return $(target).val();
},
setValue: function(target, value){
$(target).val(value);
},
resize: function(target, width){
$(target)._outerWidth(width);
}
}
});
Vue DataGrid
Surcharger les valeurs par défaut via $.fn.datagrid.defaults.view.
La vue est un objet qui indique au datagrid comment afficher les lignes. Cet objet doit définir les fonctions suivantes :
| Name | Parameters | Description |
|---|---|---|
| render | target, container, frozen | Appelé lorsque les données sont chargées. target : objet DOM, l'objet datagrid. container : Le conteneur des lignes. frozen : Indique s'il faut afficher le conteneur figé. |
| renderFooter | target, container, frozen | Il s'agit de la fonction d'options pour le rendu du pied de page. |
| renderRow | target, fields, frozen, rowIndex, rowData | Il s'agit de la fonction d'options qui sera appelée par la fonction render. |
| refreshRow | target, rowIndex | Définit comment actualiser les lignes spécifiées. |
| onBeforeRender | target, rows | Déclenché avant le rendu de la vue. |
| onAfterRender | target | Déclenché après le rendu de la vue. |
Événements
Ces événements héritent du panneau. Les suivants sont des événements ajoutés pour le datagrid.
| Name | Parameters | Description |
|---|---|---|
| onLoadSuccess | data | Déclenché lorsque les données sont chargées avec succès. |
| onLoadError | none | Déclenché lorsque des erreurs se produisent lors du chargement de données distantes. |
| onBeforeLoad | param | Déclenché avant l'envoi de la requête pour charger les données. Si false est renvoyé, l'action de chargement sera annulée. |
| onClickRow | rowIndex, rowData | Déclenché lorsque l'utilisateur clique sur une ligne. Les paramètres incluent : rowIndex : L'index de la ligne cliquée, à partir de 0. rowData : L'enregistrement correspondant à la ligne cliquée. |
| onDblClickRow | rowIndex, rowData | Déclenché lorsque l'utilisateur double-clique sur une ligne. Les paramètres incluent : rowIndex : L'index de la ligne double-cliquée, à partir de 0. rowData : L'enregistrement correspondant à la ligne double-cliquée. |
| onClickCell | rowIndex, field, value | Déclenché lorsque l'utilisateur clique sur une cellule. |
| onDblClickCell | rowIndex, field, value | Déclenché lorsque l'utilisateur double-clique sur une cellule. Exemple de code :
// when double click a cell, begin editing and make the editor get focus
$('#dg').datagrid({
onDblClickCell: function(index,field,value){
$(this).datagrid('beginEdit', index);
var ed = $(this).datagrid('getEditor', {index:index,field:field});
$(ed.target).focus();
}
});
|
| onSortColumn | sort, order | Déclenché lorsque l'utilisateur trie une colonne. Les paramètres incluent : sort : Le nom du champ de la colonne triée. order : L'ordre de la colonne triée. |
| onResizeColumn | field, width | Déclenché lorsque l'utilisateur redimensionne une colonne. |
| onSelect | rowIndex, rowData | Déclenché lorsque l'utilisateur sélectionne une ligne. Les paramètres incluent : rowIndex : L'index de la ligne sélectionnée, à partir de 0. rowData : L'enregistrement correspondant à la ligne sélectionnée. |
| onUnselect | rowIndex, rowData | Déclenché lorsque l'utilisateur désélectionne une ligne. Les paramètres incluent : rowIndex : L'index de la ligne désélectionnée, à partir de 0. rowData : L'enregistrement correspondant à la ligne désélectionnée. |
| onSelectAll | lignes | Déclenché lorsque l'utilisateur sélectionne toutes les lignes. |
| onUnselectAll | lignes | Déclenché lorsque l'utilisateur désélectionne toutes les lignes. |
| onCheck | rowIndex,rowData | Déclenché lorsque l'utilisateur coche une ligne. Les paramètres incluent : rowIndex : L'index de la ligne cochée, à partir de 0. rowData : L'enregistrement correspondant à la ligne cochée. Cet événement est disponible depuis la version 1.3. |
| onUncheck | rowIndex,rowData | Déclenché lorsque l'utilisateur décoche une ligne. Les paramètres incluent : rowIndex : L'index de la ligne décochée, à partir de 0. rowData : L'enregistrement correspondant à la ligne décochée. Cet événement est disponible depuis la version 1.3. |
| onCheckAll | lignes | Déclenché lorsque l'utilisateur coche toutes les lignes. Cet événement est disponible depuis la version 1.3. |
| onUncheckAll | lignes | Déclenché lorsque l'utilisateur décoche toutes les lignes. Cet événement est disponible depuis la version 1.3. |
| onBeforeEdit | rowIndex, rowData | Déclenché lorsque l'utilisateur commence à modifier une ligne. Les paramètres incluent : rowIndex : L'index de la ligne en cours de modification, à partir de 0. rowData : L'enregistrement correspondant à la ligne en cours de modification. |
| onAfterEdit | rowIndex, rowData, changes | Déclenché lorsque l'utilisateur termine la modification d'une ligne. Les paramètres incluent : rowIndex : L'index de la ligne modifiée, à partir de 0. rowData : L'enregistrement correspondant à la ligne modifiée. changes : Les paires champ/valeur modifiées. |
| onCancelEdit | rowIndex, rowData | Déclenché lorsque l'utilisateur annule la modification d'une ligne. Les paramètres incluent : rowIndex : L'index de la ligne en cours de modification, à partir de 0. rowData : L'enregistrement correspondant à la ligne en cours de modification. |
| onHeaderContextMenu | e, field | Déclenché lorsque l'en-tête du datagrid est cliqué avec le bouton droit. |
| onRowContextMenu | e, rowIndex, rowData | Déclenché lorsqu'une ligne est cliquée avec le bouton droit. |
Méthodes
| Name | Parameters | Description |
|---|---|---|
| options | none | Renvoie l'objet options. |
| getPager | none | Renvoie l'objet pager. |
| getPanel | none | Renvoie l'objet panel. |
| getColumnFields | frozen | Renvoie les champs des colonnes. Si frozen est défini sur true, les champs des colonnes figées sont renvoyés. Exemple de code :
var opts = $('#dg').datagrid('getColumnFields'); // get unfrozen columns
var opts = $('#dg').datagrid('getColumnFields', true); // get frozen columns
|
| getColumnOption | champ | Renvoie les options de la colonne spécifiée. |
| resize | param | Redimensionner et mettre en page. |
| load | param | Charge et affiche les lignes de la première page. Si le paramètre 'param' est spécifié, il remplacera la propriété queryParams. Généralement, en passant certains paramètres de requête, cette méthode est appelée pour charger de nouvelles données depuis le serveur.
$('#dg').datagrid('load',{
code: '01',
name: 'name01'
});
|
| reload | param | Recharge les lignes, tout comme la méthode load, mais reste sur la page actuelle. |
| reloadFooter | footer | Recharge les lignes de pied de page. Exemple de code :
// update footer row values and then refresh
var rows = $('#dg').datagrid('getFooterRows');
rows[0]['name'] = 'new name';
rows[0]['salary'] = 60000;
$('#dg').datagrid('reloadFooter');
// update footer rows with new data
$('#dg').datagrid('reloadFooter',[
{name: 'name1', salary: 60000},
{name: 'name2', salary: 65000}
]);
|
| loading | none | Afficher l'état de chargement. |
| loaded | none | Masquer l'état de chargement. |
| fitColumns | none | Faire en sorte que les colonnes s'étendent/se réduisent automatiquement pour s'adapter à la largeur du datagrid. |
| fixColumnSize | champ | Fixer les tailles des colonnes. Si le paramètre 'field' n'est pas défini, les tailles de toutes les colonnes seront fixées. Exemple de code :
$('#dg').datagrid('fixColumnSize', 'name'); // fix the 'name' column size
$('#dg').datagrid('fixColumnSize'); // fix all columns size
|
| fixRowHeight | index | Fixer la hauteur de la ligne spécifiée. Si le paramètre 'index' n'est pas défini, les hauteurs de toutes les lignes seront fixées. |
| freezeRow | index | Figer les lignes spécifiées afin que ces lignes figées soient toujours affichées en haut lorsque le datagrid défile vers le bas. Cette méthode est disponible depuis la version 1.3.2. |
| autoSizeColumn | champ | Ajuster la largeur de la colonne pour s'adapter au contenu. Cette méthode est disponible depuis la version 1.3. |
| loadData | data | Charger les données locales, les anciennes lignes seront supprimées. |
| getData | none | Retourne les données chargées. |
| getRows | none | Retourne les lignes de la page actuelle. |
| getFooterRows | none | Retourne les lignes de pied de page. |
| getRowIndex | row | Retourne l'index de la ligne spécifiée. Le paramètre row peut être un enregistrement de ligne ou la valeur d'un champ id. |
| getChecked | none | Retourne toutes les lignes sélectionnées par la case à cocher. Cette méthode est disponible depuis la version 1.3. |
| getSelected | none | Retourne la première ligne sélectionnée ou null. |
| getSelections | none | Retourne toutes les lignes sélectionnées. Lorsqu'il n'y a aucun enregistrement sélectionné, un tableau vide sera renvoyé. |
| clearSelections | none | Efface toutes les sélections. |
| clearChecked | none | Efface toutes les lignes cochées. Cette méthode est disponible depuis la version 1.3.2. |
| scrollTo | index | Fait défiler jusqu'à la ligne spécifiée. Cette méthode est disponible depuis la version 1.3.3. |
| highlightRow | index | Met en surbrillance une ligne. Cette méthode est disponible depuis la version 1.3.3. |
| selectAll | none | Sélectionne toutes les lignes de la page actuelle. |
| unselectAll | none | Désélectionner toutes les lignes de la page actuelle. |
| selectRow | index | Sélectionner une ligne, l'index de ligne commence à 0. |
| selectRecord | idValue | Sélectionner une ligne en passant la valeur d'id en paramètre. |
| unselectRow | index | Désélectionner une ligne. |
| checkAll | none | Cocher toutes les lignes de la page actuelle. Cette méthode est disponible depuis la version 1.3. |
| uncheckAll | none | Décocher toutes les lignes de la page actuelle. Cette méthode est disponible depuis la version 1.3. |
| checkRow | index | Cocher une ligne, l'index de ligne commence à 0. Cette méthode est disponible depuis la version 1.3. |
| uncheckRow | index | Décocher une ligne, l'index de ligne commence à 0. Cette méthode est disponible depuis la version 1.3. |
| beginEdit | index | Commencer à modifier une ligne. |
| endEdit | index | Terminer la modification d'une ligne. |
| cancelEdit | index | Annuler la modification d'une ligne. |
| getEditors | index | Récupérer l'éditeur de la ligne spécifiée. Chaque éditeur possède les propriétés suivantes : actions : Les actions que l'éditeur peut effectuer, identiques à la définition de l'éditeur. target : L'objet jQuery de l'éditeur cible. field : Le nom du champ. type : type d'éditeur, par ex. 'text', 'combobox', 'datebox', etc. |
| getEditor | options | Obtient l'éditeur spécifié, le paramètre options contient deux propriétés : index : index de ligne. field : nom du champ. Exemple de code :
// get the datebox editor and change its value
var ed = $('#dg').datagrid('getEditor', {index:1,field:'birthday'});
$(ed.target).datebox('setValue', '5/4/2012');
|
| refreshRow | index | Actualise une ligne. |
| validateRow | index | Valide la ligne spécifiée, renvoie true si elle est valide. |
| updateRow | param | Mettre à jour la ligne spécifiée, le paramètre param inclut les propriétés suivantes : index : index de la ligne à mettre à jour. row : données de la nouvelle ligne. Exemple de code :
$('#dg').datagrid('updateRow',{
index: 2,
row: {
name: 'new name',
note: 'new note message'
}
});
|
| appendRow | row | Ajouter une nouvelle ligne. La nouvelle ligne sera ajoutée à la dernière position :
$('#dg').datagrid('appendRow',{
name: 'new name',
age: 30,
note: 'some messages'
});
|
| insertRow | param | Insérer une nouvelle ligne, le paramètre param inclut les propriétés suivantes : index : index de la ligne insérée ; s'il n'est pas défini, ajouter la nouvelle ligne. row : données de ligne. Exemple de code :
// insert a new row at second row position
$('#dg').datagrid('insertRow',{
index: 1, // index start with 0
row: {
name: 'new name',
age: 30,
note: 'some messages'
}
});
|
| deleteRow | index | Supprimer une ligne. |
| getChanges | type | Récupère les lignes modifiées depuis le dernier commit, le paramètre type indique le type des lignes modifiées, valeurs possibles : inserted, deleted, updated, etc. Lorsque le paramètre type n'est pas assigné, renvoie toutes les lignes modifiées. |
| acceptChanges | none | Valider toutes les modifications effectuées depuis le chargement ou le dernier appel à acceptChanges. |
| rejectChanges | none | Annuler toutes les modifications effectuées depuis la création ou le dernier appel à acceptChanges. |
| mergeCells | options | Fusionner certaines cellules en une seule cellule, le paramètre options comprend les propriétés suivantes : index : indice de colonne. field : nom du champ. rowspan : nombre de lignes couvertes par la fusion. colspan : nombre de colonnes couvertes par la fusion. |
| showColumn | champ | Afficher la colonne spécifiée. |
| hideColumn | champ | Masquer la colonne spécifiée. |
Plugins jQuery EasyUI Autres extensions