Item Selection

Item Selection is a service that works with items selection. It is used in lots of gh-elements. It makes no difference where the element is displayed. Items can be selected in different elements or even in different applications. If an item is selected in one place, it remains selected everywhere.

The Item Selection has four methods.

1. selectItems

2. getSelectedItems

3. clearSelectedItems

4. isItemSelected

Different elements use different methods:

• selectItems, isItemSelected:
  • Table
  • Cards
• getSelectedItems:
  • Delete
  • Update Items
  • Clone Items
  • Export CSV
  • Print Document
  • Quote Tool
  • Send Email
  • Smart Input
  • Twilio Autodialer
• clearSelectedItems
  • Delete
  • Update Items
  • Clone Item
  • Print Document
  • Quote Tool
  • Smart Input
  • Table

The selection works only as long as the browser tab is active. When the page reloads, all selections are reset.

selectItems

This is the method of the items selection that allows to select items.

It accepts two arguments:

gudhub.utils.selectItems(appId, itemId)

getSelectedItems

This method allows to get an array of items which are selected in certain application.

It accepts only the ID of the application as an argument.

This method can be simply called:

gudhub.util.getSelectedItems(appId)

clearSelectedItems

The current method allows to clear the selection of all items which are already selected in application.

For calling this method use:

gudhub.util.clearSelectedItems(appId)

isItemSelected

This method is designed for checking whether the item is selected or not.

It accepts two arguments:

The function call is looks like this:

gudhub.util.isItemSelected(appId, itemId)

Example

Here is an illustrative example. All methods of the Item Selection service are used here one by one.

import GudHub from '@gudhub/core';
const gudhub = new GudHub();

// example app ID
const APPID = "23457";
// example array of items
let items = [{
    "item_id": 1,
    "fields": []
    },{
    "item_id": 2,
    "fields": []
    },{
    "item_id": 3,
    "fields": []
}];

// at first we select the second item
await gudhub.util.selectItems(APPID, [items[1]]);

// after that, output to the console all selected items in application
let selectedItems = gudhub.util.getSelectedItems(APPID);
console.log(selectedItems);

// then check whether the second item is selected
let isItemSelected = gudhub.util.isItemSelected(APPID, 2);
console.log(isItemSelected);

// clear the selection
gudhub.util.clearSelectedItems(APPID);

// and check the selection of the second item again
isItemSelected = gudhub.util.isItemSelected(APPID, 2);
console.log(isItemSelected);

The example code returns:

// getSelectedItems for the application
{ items: [ { item_id: 2, fields: [] } ], app: null }

// isItemSelected for the items 
true
false