#578 - Added selectTerm action for TaxonomyPicker

Author: estruyf

docs/documentation/docs/controls/TaxonomyPicker.md

@@ -77,7 +77,7 @@ Since version `1.12.0`, you can apply term actions to all terms or specific ones
                         value: `${term.Name} (updated)`
                       };
                     },
-                    applyToTerm: (term: ITerm) => (term && term.Name && term.Name === "internal")
+                    applyToTerm: (term: ITerm, triggerActionCb: (updateAction: UpdateAction) => void) => (term && term.Name && term.Name === "internal")
                   },
                   {
                     title: "Hide term",
@@ -90,7 +90,7 @@ Since version `1.12.0`, you can apply term actions to all terms or specific ones
                         value: true
                       };
                     },
-                    applyToTerm: (term: ITerm) => (term && term.Name && (term.Name.toLowerCase() === "help desk" || term.Name.toLowerCase() === "multi-column valo site page"))
+                    applyToTerm: (term: ITerm, triggerActionCb: (updateAction: UpdateAction) => void) => (term && term.Name && (term.Name.toLowerCase() === "help desk" || term.Name.toLowerCase() === "multi-column valo site page"))
                   },
                   {
                     title: "Disable term",
@@ -103,7 +103,7 @@ Since version `1.12.0`, you can apply term actions to all terms or specific ones
                         value: true
                       };
                     },
-                    applyToTerm: (term: ITerm) => (term && term.Name && term.Name.toLowerCase() === "secured")
+                    applyToTerm: (term: ITerm, triggerActionCb: (updateAction: UpdateAction) => void) => (term && term.Name && term.Name.toLowerCase() === "secured")
                   },
                   {
                     title: "Disable or hide term",
@@ -122,7 +122,7 @@ Since version `1.12.0`, you can apply term actions to all terms or specific ones
                         value: true
                       };
                     },
-                    applyToTerm: (term: ITerm) => true
+                    applyToTerm: (term: ITerm, triggerActionCb: (updateAction: UpdateAction) => void) => true
                   }]
                 }} />
 ```
@@ -218,5 +218,6 @@ Enum `UpdateType`
 | updateTermsTree |
 | hideTerm |
 | disableTerm |
+| selectTerm |
 
 ![](https://telemetry.sharepointpnp.com/sp-dev-fx-controls-react/wiki/controls/Placeholder)

src/controls/taxonomyPicker/Term.tsx

@@ -87,6 +87,11 @@ export default class Term extends React.Component<ITermProps, ITermState> {
       this.setState({
         disabled: updateAction.value as boolean
       });
+    } else if (updateAction.updateActionType === UpdateType.selectTerm) {
+      this.setState({
+        selected: updateAction.value as boolean
+      });
+      this.props.changedCallback(this.props.term, updateAction.value as boolean);
     } else {
       this.props.updateTaxonomyTree();
     }

src/controls/taxonomyPicker/termActions/ITermsActions.ts

@@ -79,7 +79,11 @@ export enum UpdateType {
   /**
    * Allows you to disable the term
    */
-  disableTerm
+  disableTerm,
+  /**
+   * Allows you to select the term
+   */
+  selectTerm
 }
 /**
  * Specifies the result that will be returned to the Term after the execution of the callback.
@@ -128,7 +132,7 @@ export interface ITermAction {
   * Method checks if the current term is supported.
   * @param currentTerm
   */
-  applyToTerm: (currentTerm: ITerm) => Promise<boolean> | boolean;
+  applyToTerm: (currentTerm: ITerm, triggerActionCallback: (updateAction: UpdateAction) => void) => Promise<boolean> | boolean;
   /**
    * Method to be executed when action is fired.
    */

src/controls/taxonomyPicker/termActions/TermActionsControl.tsx

@@ -38,7 +38,7 @@ export default class TermActionsControl extends React.Component<ITermActionsCont
 
     if (termActions.actions) {
       for (const action of termActions.actions) {
-        const available = await action.applyToTerm(term);
+        const available = await action.applyToTerm(term, this.props.termActionCallback);
         if (available) {
           availableActions.push(action);
         }