Merge branch 'joelfmrodrigues-select-default-items' into dev

Author: estruyf

docs/documentation/docs/controls/ListView.md

@@ -67,6 +67,7 @@ The Placeholder component can be configured with the following properties:
 | selectionMode | SelectionMode | no | Specify if the items in the list view can be selected and how. Options are: none, single, multi. |
 | selection | function | no | Selection event that passes the selected item(s) from the list view. |
 | groupByFields | IGrouping[] | no | Defines the field on which you want to group the items in the list view. |
+| defaultSelection | number[] | no | The index of the items to be select by default |
 
 The `IViewField` has the following implementation:
 

src/controls/listView/IListView.ts

@@ -1,5 +1,5 @@
 import { Selection, SelectionMode } from 'office-ui-fabric-react/lib/DetailsList';
-import { IColumn ,IGroup} from 'office-ui-fabric-react/lib/components/DetailsList';
+import { IColumn, IGroup } from 'office-ui-fabric-react/lib/components/DetailsList';
 
 export { SelectionMode };
 
@@ -40,6 +40,10 @@ export interface IListViewProps {
    * Selection event that passes the selected item(s)
    */
   selection?: (items: any[]) => void;
+  /**
+   * The index of the items to be select by default
+   */
+  defaultSelection?: number[];
 }
 
 export interface IListViewState {

src/controls/listView/ListView.tsx

@@ -46,11 +46,30 @@ export class ListView extends React.Component<IListViewProps, IListViewState> {
    * @param prevState
    */
   public componentDidUpdate(prevProps: IListViewProps, prevState: IListViewState): void {
+    // select default items
+    this._setSelectedItems();
+
     if (!isEqual(prevProps, this.props)) {
       this._processProperties();
     }
   }
 
+  /**
+   * Select all the items that should be selected by default
+   */
+  private _setSelectedItems(): void {
+    if (this.props.items &&
+        this.props.items.length > 0 &&
+        this.props.defaultSelection &&
+        this.props.defaultSelection.length > 0) {
+      for (const index of this.props.defaultSelection) {
+        if (index > -1) {
+          this._selection.setIndexSelected(index, true, false);
+        }
+      }
+    }
+  }
+
   /**
    * Specify result grouping for the list rendering
    * @param items

tslint.json

@@ -0,0 +1,3 @@
+{
+    "rulesDirectory": "./config"
+}