Protobi

← All help posts

View post

Use the Element properties dialog to change element labels and calculate ratios.

By default, Protobi assumes each element corresponds to a data column with the same name as the element's **key** attribute, and uses that value directly.  But it's possible to override this in many ways.

Access the Advanced properties dialog by pressing on the element icon and choosing "More properties":

| Attribute | Value | Description |
| --- | --- | --- |
|
#### **key**

| String | Unique identifier for this element |
|

#### **displayKey**

#### **title**

| String | Text for longer descriptive title |
|

#### **footnote**

| String | Text for footnote |
|

#### **type**

#### **field**

| String | Name of data column to use as a data source for this element (defaults to **key**).  If specified, the value is read directly from that data column. |
|

#### **element**

|
 | Name of an element to use as a data source for this element. If specified, data is interpolated from that element, after applying its coding, transforms, etc. |
|

#### **children**

| String | List of child elements, separated by commas. |
|

#### **string**

| Choice | Choose a casing method for displaying strings: lower case, UPPER case, Sentence Case, and camelCase. |
|
This method just uses lodash methods.

identity: Hey!  Tonight, we're headed to Plough & Star for a pint.

upperFirst: Hey!  Tonight, we're headed to Plough & Star for a pint.

startCase: Hey Tonight Were Headed To Plough Star For A Pint

lowerCase: hey tonight were headed to plough star for a pint

upperCase: HEY TONIGHT WERE HEADED TO PLOUGH STAR FOR A PINT

toLower: hey!  tonight, we're headed to plough & star for a pint.

toUpper: HEY!  TONIGHT, WE'RE HEADED TO PLOUGH & STAR FOR A PINT.

camelCase: heyTonightWereHeadedToPloughStarForAPint

kebabCase: hey-tonight-were-headed-to-plough-star-for-a-pint

snakeCase: hey_tonight_were_headed_to_plough_star_for_a_pint

capitalize: Hey!  tonight, we're headed to plough & star for a pint.

#### **col**

| String | Unique identifier of crosstab banner column(s) |
|

#### **split**

| String | Delimiter to split values for this element.  For example "," will split a comma-delimited string into a multiple-response array. 
The special value "json" will parse the value as a JSON string. |
|

#### **scale**

| String or number | Numeric value or name of data column by which to multiply the value of this element.  E.g. 100 will convert fractions between \[0,1\] to percents \[0,100\] |
|

#### **denominator**

| String or number | Numeric value or name of data column by which to divide the value of this element.  This can be used to calculate on element as a ratio of another. |
|

#### **weight**

| String or number
 | Numeric value or name of data column by which to weight the frequency of this element.   |
|

#### **maxValue**

| Number | Reference value by which to scale bars for this element. Useful when compacting to means, so that bars can be drawn for means relative to a some value. |
|

#### **showMissing**

| Choice
 | Show or hide missing values.  **Yes** means always, **No** means never, and **(default)** means use current setting from \[NA\] button in toolbar |
|

#### **showPercent**

| Choice
 | Show or hide the % sign in frequencies.  |
|

#### **editorOnly**

| Choice
 | Show or hide the tab from users with "View" access only.  |
|

#### **valueFormat**

| String | Display format for this element's values using [d3 format notation](https://github.com/d3/d3-format). E.g. "0%" will display fractions like 0.24 as percentages e.g. "24%"
Use "0f" when you want to show an integer without decimals.
 |

Publishing

Date

Status

Slug edit

Content

Thumbnail

Categories Manage

Tools

AI Database

Publishing

Content

Tools

Danger zone