[data-shapes] [UI] Terminology (#645)

bergos has just created a new issue for https://github.com/w3c/data-shapes:

== [UI] Terminology ==
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*.

Please view or discuss this issue at https://github.com/w3c/data-shapes/issues/645 using your GitHub account


-- 
Sent via github-notify-ml as configured in https://github.com/w3c/github-notify-ml-config

Received on Wednesday, 12 November 2025 21:23:49 UTC