Display Property - Nextedy Documentation

Property Definition

Property	Type	Default	Description
`columns.<key>.display`	string	`id`	Specifies which property of a referenced entity to display. Accepts a property name (`title`, `titleOrName`, `id`) or a JavaScript arrow function string for custom rendering.

Display Values

Value	Description
`id`	Shows the entity’s ID (default)
`title`	Shows the entity’s title property
`titleOrName`	Shows the title if available, otherwise falls back to the entity name
Custom property	Any valid property name from the referenced entity type
JS function string	Arrow function returning custom HTML (see below)

Display Resolution Flow

Simple Property Display

Show the title property of a referenced Hazard entity:

columns:
  hazard:
    title: Hazard
    display: title

Show the titleOrName property with fallback:

columns:
  hazard:
    title: Hazard
    display: titleOrName

JavaScript Function Display

Use a JavaScript arrow function string to return custom HTML. The function has access to a context object.

Context Object

Variable	Description
`context.value`	The current cell value (the referenced entity or property value)
`context.item`	The current row item with properties like `projectId`, `id`
`context.polarionModel.polarionBaseUrl`	Base URL of the Polarion server

Example: Icon with Link

columns:
  riskControls.riskControl:
    title: Risk Control
    display: >
      () => `<img
        src='${context.polarionModel.polarionBaseUrl}/polarion/icons/default/enums/type_purple_feature.png'>
        <a
          target="_blank"
          href="${context.polarionModel.polarionBaseUrl}/polarion/#/project/${context.item.projectId}/workitem?id=${context.item.id}">
          ${context.value.objectId}
        </a>`

Use the > (folded scalar) indicator for multi-line JavaScript function strings in YAML. The function is evaluated in the browser at render time.

Display vs Render

Both display and render can accept JavaScript function strings, but they serve different purposes:

Property	Primary Use	When to Use
`display`	Property name selection for navigation columns	Use when you need to select which property of a referenced entity to show, or when using a simple JS function
`render`	Custom HTML cell rendering	Use when `display` is already used for property selection and you need additional rendering control. Can also reference predefined renderer names.

When both display and render are set on the same column, render typically takes precedence for visual output. Use display for property selection and render for custom HTML when both are needed.

Complete YAML Example

columns:
  outlineNumber:
    title: "#"
    width: 80
  title:
    title: User Need
    width: 200
    hasFocus: true
  hazard:
    title: Hazard
    display: title
    list:
      search:
        - title
        - id
  riskControls.riskControl:
    title: Risk Control
    width: 160
    multiItem: true
    display: >
      () => `<img
        src='${context.polarionModel.polarionBaseUrl}/polarion/icons/default/enums/type_purple_feature.png'>
        <a
          target="_blank"
          href="${context.polarionModel.polarionBaseUrl}/polarion/#/project/${context.item.projectId}/workitem?id=${context.item.id}">
          ${context.value.objectId}
        </a>`
    list:
      search:
        - title
        - id
      display: >
        () => `<img
          src='${context.polarionModel.polarionBaseUrl}/polarion/icons/default/enums/type_purple_feature.png'>
          ${context.value.objectId} ${context.value.title ? '- ' + context.value.title : ''}`

sources:
  - id: main
    model: rtm
    query:
      from: UserNeed
      where: "type = 'UserNeed'"
    expand:
      - name: hazards
        title: Hazards
        expand:
          - name: riskControls
            title: Risk Controls

Render Property — custom HTML rendering as an alternative to display
Columns — full column property reference
Binding Syntax — column key patterns for navigation properties
Multi-Item Columns — display for collections

​Property Definition

​Display Values

​Display Resolution Flow

​Simple Property Display

​JavaScript Function Display

​Context Object

​Example: Icon with Link

​Display vs Render

​Complete YAML Example

​Related Pages

Property Definition

Display Values

Display Resolution Flow

Simple Property Display

JavaScript Function Display

Context Object

Example: Icon with Link

Display vs Render

Complete YAML Example

Related Pages