When do you use it?
The focus control allows you to use focus on a specific field across all elements, meaning that the control will toggle on all elements with that field + their connections. You can indicate whether you want the connections to be "out 1" (only first-degree connections), or "out 2" (first- and second-degree connections), etc.
{% hint style="info" %} Here are some great uses of the focus control:
- Focus by the “label” field to quickly zoom in on one element and its neighboring connections
- Focus by a specific field to quickly see which elements on the map have that value in their profile field, and what their immediate connections are {% endhint %}
To create a cluster control, follow these steps:
- Click the settings icon on the right
to open the editor, then click "Add custom control".
- In the menu that opens up, change the value of the first dropdown to "Focus elements by field".
- Use the other dropdowns to customize the look and location of your controls
- Click Save at the bottom to save your changes
- To add multiple controls, repeat steps 1-4 for each control.
If you like to get into the nitty-gritty of the advanced editor, you can type out controls directly. The advanced editor also allows for more advanced controls, as explained below.
Focus by field, basic syntax:
@controls {
top {
focus {
by: "element type";
}
}
}
Focus using custom selectors:
@controls {
top {
focus {
option {
label: "Influential";
selector: ["tags"*="influential"];
}
option {
label: "Emerging Leader";
selector: ["tags"*="emerging"];
}
}
}
}Supported properties
byis the field you'd like to use for filtering wrapped in double quotes (if you don't includeby: fieldyou need to list out each option - see "supported children" guidance below)ascontrols how the control is presented. Do you want a list of labels, buttons, or a dropdown for activating filter?labelsshow options as a list of clickable labelsbuttonsshow options as a group of buttonsdropdownshow options as dropdown
multiplecontrols whether more than one value can be selected at a timefalseallows the reader to only select a single optiontrueallows the reader to select multiple optionsmatch-allallows the reader to select multiple options, and only shows items that match all of the selected options
placeholderthe text to display when nothing is selected (foras: dropdownonly)summaryoverride the summary that's shown for the current selection (foras: dropdown). The summary will be shown regardless of what's selected so there's no need to useplaceholderin this case.defaultdefines which field values should be selected by default (forby: "field"only). Useselect-allto select everything by default (orshow-allfor a similar effect without selecting everything by default).exceptallows you to remove field values from the available choices. Wrap the values you want to remove in quotes and separate multiple values by commas.onlyis similar to except but allows you to explicitly define which field values should be included as available choices.
Check out our controls reference to see the full list of properties and values recognized by the focus control.
Supported children
If you don't supply a field to focus by, each option must be listed separately. The available options are defined by option blocks nested within the control. Each option supports the following properties:
labelthe text to display for that optionselectorthe selector to use for the filterdefaulttruevalue is selected by defaultfalsevalue is unselected by default
Focus elements by one or more skills using a dropdown:
@controls {
top {
focus {
target: element;
by: "Skills";
as: dropdown;
multiple: true;
placeholder: "Select one or more skills"
}
}
}Focus by location, but only for items that have a location:
@controls {
top {
focus {
by: "Location";
target: ["Location"];
}
}
}Focus elements by type, but select all types by default:
@controls {
top {
focus {
target: element;
by: "Element type";
default: select-all;
}
}
}