Conseils pour implémenter le contrôle Grille JS
Dernière modification : vendredi 24 juin 2011
S’applique à : SharePoint Foundation 2010
Dans cet article
Contrôleur
Filtrage
Persistance
Impression de la grille
Attachement aux événements
Versions de débogage de JsGrid.js et JsGrid.Gantt.js
Contrôleur
Le contrôleur du Contrôle Grille JS indique à la grille comment restituer le contenu (en d’autres termes, quels volets ou quelles colonnes afficher). Le contrôleur active la source de données. Il sait comment gérer les lignes non associées, ce qui autorise les modifications sans que toutes les données soient disponibles localement.
Vous pouvez également définir des styles dans le contrôleur. Dans le code suivant, RegisterCellStyle définit un style, « TextRightAlign », qui permet d’appliquer un alignement à droite aux colonnes.
<SharePoint:JSGrid ID="_grid" runat="server" />
<script type="text/javascript">
Type.registerNamespace("GridManager");
this.control;
GridManager = function () {
this.Init = function (jsGridControl, initialData, props) {
control = jsGridControl;
var dataSource = new SP.JsGrid.StaticDataSource(initialData);
var jsGridParams = dataSource.InitJsGridParams();
jsGridParams.styleManager.RegisterCellStyle('TextRightAlign', SP.JsGrid.Style.CreateStyle(SP.JsGrid.Style.Type.Cell, { textAlign: 'right' }));
jsGridControl.Init(jsGridParams);
}
};
</script>
Pour obtenir un exemple complet, voir Procédure : créer une grille JS de base.
Filtrage
La liste suivante répertorie les paramètres qui peuvent faciliter le filtrage du contenu :
état masqué/visible des colonnes ;
ordre des colonnes ;
largeurs des colonnes ;
filtre complexe ;
regroupement ;
tri ;
positionnement de la barre de fractionnement.
Persistance
Le terme persistance fait référence à la conservation, d’une session utilisateur à l’autre, des options sélectionnées pour les opérations de filtrage, de regroupement, de tri et d’affichage. La persistance est une fonctionnalité de chaque contrôleur.
Les paramètres qui ne doivent pas être persistants d’une session à l’autre sont les suivants :
Filtre automatique : la persistance des paramètres de filtre automatique peut être source de confusion pour les utilisateurs, car ils risquent de ne pas comprendre pourquoi leurs affichages ne contiennent pas de données. S’ils sont configurés manuellement, les filtres côté client sont persistants.
Hiérarchie : l’ensemble de données étant créé « à la volée », il est difficile de le rendre persistant. Toutefois, le paramètre « Afficher le niveau hiérarchique » étant persistant, l’affichage crée ledit ensemble de données.
La ligne ou colonne sélectionnée.
Notes
Dans Microsoft Office Project Server 2007, la plupart des paramètres demeuraient persistants d’une session à l’autre. Project Server 2010 autorise toujours un choix de persistance par page. Par défaut, il convient de conserver les paramètres au sein des paramètres utilisateur, sauf si vous avez une très bonne raison de conserver les préférences uniquement dans la session.
Impression de la grille
Lors de l’impression, le contrôleur charge les données de la grille en tant que données en lecture seule. Cette opération peut prendre beaucoup de temps dans un ensemble de données paginé ; il est préférable d’ouvrir une nouvelle fenêtre de navigateur. L’impression est confiée au navigateur. Si la page ne répond pas aux attentes de l’utilisateur, celui-ci peut fermer la fenêtre d’impression, ajouter ou supprimer des colonnes, effectuer un zoom et cliquer de nouveau sur Imprimer.
Attachement aux événements
Cet exemple montre comment attacher du code personnalisé à l’événement OnCellEditComplete.
<script type="text/javascript">
Type.registerNamespace("GridManager");
GridManager = function () {
this.Init = function (jsGridControl, initialData, props) {
control = jsGridControl;
var dataSource = new SP.JsGrid.StaticDataSource(initialData);
var jsGridParams = dataSource.InitJsGridParams();
// This event is triggered after the standard grid error checking.
jsGridControl.AttachEvent(SP.JsGrid.EventType.OnCellEditCompleted, GotHere);
jsGridControl.Init(jsGridParams);
}
};
function GotHere(obj) {
alert('Got Here, ' + obj.fieldKey);
}
</script>
Versions de débogage de JsGrid.js et JsGrid.Gantt.js
Des versions de débogage de JsGrid.js et JsGrid.Gantt.js sont installées avec le produit, généralement dans %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS. Ces fichiers fournissent des informations précieuses au sujet de la grille JS.
Voir aussi
Tâches
Procédure : créer une grille JS de base
Référence
Concepts
Widgets du contrôle de grille JS