Skip to content

[UI] Terminology #645

@bergos

Description

@bergos

We want to fill the Terminology section in the SHACL UI spec. Below is a list of the most important terms that we compiled in the last calls.

Language Resolution

Language resolution is the process of determining and ordering the values associated with a given subject-predicate pair, prioritising the most relevant or preferred language value for display.

Label Resolution

Label Resolution is the process of determining the most appropriate display value for an RDF resource, or generating a fallback value when none is explicitly available. This process applies to both value nodes and sh:path values.

The process includes language resolution, taking into account annotations defined in the shapes graph, data graph, application environment, and user preferences to select the most suitable label for UI presentation.

Property UI Component

A combination of constraints across multiple property shapes that share the same property path, focus node, and value nodes. It represents a single field (e.g., a text input, a dropdown) in a form.

Node UI Component

The resulting UI component is generated from a single focus node, typically containing one or more property UI components. It is often derived from one or more node shapes that apply to the focus node.

SHACL Renderer

A piece of software that processes SHACL shapes and data to dynamically generate a form. A UI that represents the data is generated from one or more node UI components. The SHACL renderer may add additional UI elements, such as a submit button to save changes, a button to toggle between edit and view mode, selectors for focus node and node shape, or messages from the validation report.

Further functionality the SHACL renderer may provide:

  • State management for the mode (edit/view) and changes
  • Managing widgets and widget selection logic
  • The target selection logic
  • Communication with the persistence layer

The inputs:

  • Focus node IRI (optional, some implementations may provide a logic or UI to determine the root node)
  • Node shape IRI (optional, some implementations may provide a logic or UI to determine a matching shape)
  • Data graph
  • Shapes graph

If both the focus node and node shape are provided, the SHACL renderer operates in manual mode. Otherwise, when logic is applied to determine one or both values, it operates in automatic mode.

Metadata

Metadata

Assignees

Labels

UIFor SHACL 1.2 UI spec

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions