Selector reference

Selectors provide a powerful, friendly way to slice through maps, based on Cascading Style Sheets (CSS) selectors.

If you're familiar with CSS, you'll feel right at home. If you haven't seen or used CSS, don't worry! All the selector patterns you'll ever need are documented in this reference. To see examples of how selectors can be used, check out our general guide on selectors.

There are two reference tables on this page. The first shows you all the different kinds of selectors you can use in Kumu, and the second table gives details about logical operators that can be used inside of certain selectors.

In the first table, you'll notice that the word "slug" appears a lot. A slug is a piece of text that has had all letters converted to lowercase, all special characters removed, and all spaces and replaced with hyphens. So, when you see something like type-slug in the table below, this will be replaced in your custom selector with something like private-company or individual or another "slug" version of an element type.

Selectors

Selector What it selects
* All elements, connections, and loops
element All elements
connection All connections
loop All loops
type-slug All elements whose element type slug matches type-slug
type-slug-connection All connections whose connection type slug matches type-slug
#label-slug The item whose label slug matches label-slug.
#assigned-id-slug The item whose assigned ID slug matches assigned-id-slug.
#system-id The item whose system ID matches system-id.
.tag All items whose Tags field contains tag. Note that this selector starts with a dot .
["field name" operator "field value"] All items that have a field name and field value that meet the condition of the operator (valid operators are listed below this table)
["field name"] All items that have any value in the field whose name matches field name
[!"field name"] All items that have no value in the field whose name matches field name
:from(selector) All connections coming from an item that matches the selector
:to(selector) All connections going to an item that matches the selector
:directed All directed connections
:undirected All undirected connections
:mutual All mutual connections
:focus All items at the root of a focus setting
:orphan All elements that have zero connections (including connections that have been filtered out)
:not(selector) All items that do not match the selector
this-selector --> that-selector All items matching this-selector connected to items that match that-selector
this-selector <-- that-selector All items matching this-selector connected from items that match that-selector
this-selector <--> that-selector All items matching this-selector connected to or from items that match that-selector
this-selector <-connection-selector-> that-selector All items matching this-selector connected to or from items that match that-selector via connections that match connection-selector

Operators

Operator Description
= is equal to
!= is not equal to
^= starts with
$= ends with
*= text contains
~= list of values includes (this operator matches full values)
> is greater than
>= is greater than or equal to
< is less than
<= is less than or equal to

edit this page

results matching ""

    powered by

    No results matching ""