Issue 869 by robert-david · Pull Request #900 · w3c/data-shapes

robert-david · 2026-05-22T11:01:23Z

Closes #869

See this document rendered online here

Changed global configuration to a subsection Fixed html bug

bergos · 2026-05-29T05:59:38Z

+				<p>
+					A shapes graph may contain a <a>SHACL instance</a> of the class <code>shui:Configuration</code> 
+          to define global configuration properties for rendering the UI.
+          <code>shui:Configuration</code> is a <a>SHACL subclass</a> of <code>sh:Graph</code>


Suggested change

<code>shui:Configuration</code> is a <a>SHACL subclass</a> of <code>sh:Graph</code>

<code>sh:Graph</code> is a <a>SHACL subclass</a> of <code>shui:Configuration</code>

The order should be reversed. A sh:Graph should be a subtype of sh:Configuration, making it possible to attach configuration properties directly. However, making every sh:Configuration a sh:Graph would prevent nested or alternative configurations from coexisting in the same graph.

Suggesting an additional trailing dot.

Suggested change

<code>shui:Configuration</code> is a <a>SHACL subclass</a> of <code>sh:Graph</code>

<code>sh:Graph</code> is a <a>SHACL subclass</a> of <code>shui:Configuration </code>.

bergos · 2026-05-29T06:02:22Z

+								<td><code>shui:defaultNamespace</code></td>
+								<td>
+									The default namespace used to construct fresh user-added nodes. 
+                  The value of <code>shui:defaultNamespace</code> is an <a>IRI</a>.


Suggested change

The value of <code>shui:defaultNamespace</code> is an <a>IRI</a>.

The value of <code>shui:defaultNamespace</code> is a <a>Literal</a> whose value is a valid IRI.

It should be a literal whose value is an IRI. The default namespace is not itself a resource — the IRIs derived from it will be.

@bergos, so do I understand it correctly that you suggest to use rather shui:defaultNamespace "http://example.com/ns#" instead of shui:defaultNamespace <http://example.com/ns#> ;?

I see now in #869 it was also suggested as a Literal. Beware that we'll then have to update this example in the PR accordingly.

bergos · 2026-05-29T06:44:01Z

@@ -1471,13 +1552,13 @@ <h4>Property Labels</h4>
            </li>
            <li>
              If <var>P</var> is a predicate IRI and the <a>data graph</a>
-              contains one or more <code>rdfs:label</code> triples with subject <var>P</var>, select
+              contains one or more triples with properties determined by <a>label resolution</a> and with subject <var>P</var>, select
              the best matching value using <a>language resolution</a>. If a match is found, use
              that literal as the label.
            </li>
            <li>
              If <var>P</var> is a predicate IRI and the <a>shapes graph</a>
-              contains one or more <code>rdfs:label</code> triples with subject <var>P</var>, select
+              contains one or more triples with properties determined by <a>label resolution</a> and with subject <var>P</var>, select
              the best matching value using <a>language resolution</a>. If a match is found, use
              that literal as the label.
            </li>
@@ -1512,13 +1593,13 @@ <h4>Value Node Labels</h4>
            </li>
            <li>
              If the <a>data graph</a> contains one or more values for the configured property path for
-              the value node label resolution (defaulting to <code>rdfs:label</code>) for <var>V</var>,
+              the value node determined by <a>label resolution</a> for <var>V</var>,
              select the best matching value using <a>language resolution</a>. If a match is found, use
              that literal as the label.
            </li>
            <li>
              If the <a>shapes graph</a> contains one or more values for the configured property path for
-              the value node label resolution (defaulting to <code>rdfs:label</code>) for <var>V</var>,
+              the value node  determined by <a>label resolution</a> for <var>V</var>,
              select the best matching value using <a>language resolution</a>. If a match is found, use
              that literal as the label.
            </li>


Defining the logic once and referencing it is a good approach, given it's used four times — but "label resolution" doesn't work as the term here. Since "Property Labels" and "Value Node Labels" are already sub-sections of "Label Resolution" for specific cases, this creates a circular reference. A better approach would be to introduce a new sub-section, as was done for "Local Name Resolution". Additionally, the default should not be defined at the config level but rather within each sub-section: rdfs:label as the default for "Value Node Labels" and sh:name as the default for "Property Labels".

smessie · 2026-06-02T09:12:25Z

+				<p>
+					A shapes graph may contain a <a>SHACL instance</a> of the class <code>shui:Configuration</code> 
+          to define global configuration properties for rendering the UI.
+          <code>shui:Configuration</code> is a <a>SHACL subclass</a> of <code>sh:Graph</code>


Suggesting an additional trailing dot.

Suggested change

<code>shui:Configuration</code> is a <a>SHACL subclass</a> of <code>sh:Graph</code>

<code>sh:Graph</code> is a <a>SHACL subclass</a> of <code>shui:Configuration </code>.

smessie · 2026-06-02T09:18:36Z

+								<td><code>shui:defaultNamespace</code></td>
+								<td>
+									The default namespace used to construct fresh user-added nodes. 
+                  The value of <code>shui:defaultNamespace</code> is an <a>IRI</a>.


@bergos, so do I understand it correctly that you suggest to use rather shui:defaultNamespace "http://example.com/ns#" instead of shui:defaultNamespace <http://example.com/ns#> ;?

I see now in #869 it was also suggested as a Literal. Beware that we'll then have to update this example in the PR accordingly.

smessie · 2026-06-02T09:27:50Z

+								<td>
+									The language selection for displaying labels in widgets. 
+                  The value of <code>shui:hasLanguagePreference</code> is a well-formed SHACL list where all members are language tags. 
+                  The preferred language is determined according to the order of priority in the list from beginning (highest) to end (lowest ). 


I find the description of an empty Literal behavior useful to add as well. Also a redundant space.

Suggested change

The preferred language is determined according to the order of priority in the list from beginning (highest) to end (lowest ).

The preferred language is determined according to the order of priority in the list from beginning (highest) to end (lowest).

An empty literal (`""`) represents no language, i.e., a string literal with no language tag.

smessie · 2026-06-02T09:31:03Z

+								<td><code>shui:timeZone</code></td>
+								<td>
+									The time zone used to construct new terms with <a>datatype</a> <code>xsd:dateTime</code>.
+                  The value of <code>shui:timeZone</code> is <code>xsd:string</code>. 


Suggested change

The value of <code>shui:timeZone</code> is <code>xsd:string</code>.

The value of <code>shui:timeZone</code> is of datatype <code>xsd:string</code>.

smessie · 2026-06-02T09:34:04Z

+							<tr>
+								<td><code>shui:shapesLabelPreference</code></td>
+								<td>
+									The label properties used to determine labels to display in widgets. 


Suggested change

The label properties used to determine labels to display in widgets.

The properties used to determine the labels to display in widgets.

smessie · 2026-06-02T10:24:59Z

+								<td>
+									The label properties used to determine labels to display in widgets. 
+                  Properties are looked up in the <a>shapes graph</a>. 
+                  The value of <code>shui:shapesLabelPreference</code> is a well-formed SHACL list where all members are IRIs.


I guess the order is of relevance here as well?

Suggested change

The value of <code>shui:shapesLabelPreference</code> is a well-formed SHACL list where all members are IRIs.

The value of <code>shui:shapesLabelPreference</code> is a well-formed SHACL list where all members are IRIs.

A label is determined by evaluating the properties according to the order of priority in the list from beginning (highest) to end (lowest).

smessie · 2026-06-02T10:31:45Z

+									The label properties used to determine labels to display in widgets and labels to represent nodes values in the widgets. 
+                  Properties are looked up in the <a>data graph</a>. 
+                  The value of <code>shui:dataLabelPreference</code> is a well-formed SHACL list where all members are IRIs.


idem

Suggested change

The label properties used to determine labels to display in widgets and labels to represent nodes values in the widgets.

Properties are looked up in the <a>data graph</a>.

The value of <code>shui:dataLabelPreference</code> is a well-formed SHACL list where all members are IRIs.

The properties used to determine the labels to display in widgets and the labels to represent value nodes in the widgets.

Properties are looked up in the <a>data graph</a>.

The value of <code>shui:dataLabelPreference</code> is a well-formed SHACL list where all members are IRIs.

A label is determined by evaluating the properties according to the order of priority in the list from beginning (highest) to end (lowest).

smessie · 2026-06-02T10:33:17Z

+    shui:defaultNamespace &lt;http://example.com/ns#&gt; ;
+    shui:hasLanguagePreference ("" "en" "de") ;
+    shui:hasTimeZone "Europe/Vienna" ;


Suggested change

shui:defaultNamespace <http://example.com/ns#> ;

shui:hasLanguagePreference ("" "en" "de") ;

shui:hasTimeZone "Europe/Vienna" ;

shui:defaultNamespace "http://example.com/ns#" ;

shui:languagePreference ("" "en" "de") ;

shui:timeZone "Europe/Vienna" ;

smessie · 2026-06-02T10:34:05Z

            <ul>
              <li>A UI feature that allows the user to select a preferred display language or languages priorities.</li>
-              <li>A predefined language configuration in the application settings.</li>
+              <li>A <a>global configuration</a> using the property <code>shui:hasLanguagePreference</code>.</li>


Suggested change

<li>A <a>global configuration</a> using the property <code>shui:hasLanguagePreference</code>.</li>

<li>A <a>global configuration</a> using the property <code>shui:languagePreference</code>.</li>

danielbeeke · 2026-06-04T09:14:16Z

+								<td>
+									The label properties used to determine labels to display in widgets. 
+                  Properties are looked up in the <a>shapes graph</a>. 
+                  The value of <code>shui:shapesLabelPreference</code> is a well-formed SHACL list where all members are IRIs.


I remember vaguely that we also discussed using SHACL property paths here so that we would have support for skosxl:literalForm and others.

TallTed · 2026-06-09T02:52:28Z

 						<div class="turtle">
 ex:config a shui:Configuration ;
-    shui:defaultNamespace &lt;http://example.com/ns#&gt; ;
+    shui:defaultNamespace "&lt;"http://example.com/ns#" ;


I may be misreading, but it seems that this URI markup is broken. I think this fixes it.

Suggested change

shui:defaultNamespace "<"http://example.com/ns#" ;

shui:defaultNamespace "<http://example.com/ns#>" ;

robert-david added 4 commits May 20, 2026 17:54

Added global configuration

36a1b98

Changed global configuration to a subsection Fixed html bug

Added label resolution using global configuration

79019b8

Fixed global-configuration link

2e0eba3

Replaced one more rdfs:label with label resolution

5d0fc15

robert-david requested review from bergos and edmondchuc May 22, 2026 11:01

edmondchuc added the UI For SHACL 1.2 UI spec label May 26, 2026

bergos requested changes May 29, 2026

View reviewed changes

smessie reviewed Jun 2, 2026

View reviewed changes

danielbeeke reviewed Jun 4, 2026

View reviewed changes

robert-david added 3 commits June 6, 2026 15:15

Changes on label property resolution

ea14d7a

Fixes to streamline label property resolution

3c52415

Minor fix

84146fd

robert-david requested a review from bergos June 6, 2026 13:32

TallTed reviewed Jun 9, 2026

View reviewed changes

	<code>shui:Configuration</code> is a <a>SHACL subclass</a> of <code>sh:Graph</code>
	<code>sh:Graph</code> is a <a>SHACL subclass</a> of <code>shui:Configuration</code>

	The value of <code>shui:defaultNamespace</code> is an <a>IRI</a>.
	The value of <code>shui:defaultNamespace</code> is a <a>Literal</a> whose value is a valid IRI.

	The preferred language is determined according to the order of priority in the list from beginning (highest) to end (lowest ).
	The preferred language is determined according to the order of priority in the list from beginning (highest) to end (lowest).
	An empty literal (`""`) represents no language, i.e., a string literal with no language tag.

	The value of <code>shui:timeZone</code> is <code>xsd:string</code>.
	The value of <code>shui:timeZone</code> is of datatype <code>xsd:string</code>.

	The label properties used to determine labels to display in widgets.
	The properties used to determine the labels to display in widgets.

	The value of <code>shui:shapesLabelPreference</code> is a well-formed SHACL list where all members are IRIs.
	The value of <code>shui:shapesLabelPreference</code> is a well-formed SHACL list where all members are IRIs.
	A label is determined by evaluating the properties according to the order of priority in the list from beginning (highest) to end (lowest).

	<li>A <a>global configuration</a> using the property <code>shui:hasLanguagePreference</code>.</li>
	<li>A <a>global configuration</a> using the property <code>shui:languagePreference</code>.</li>

	shui:defaultNamespace "<"http://example.com/ns#" ;
	shui:defaultNamespace "<http://example.com/ns#>" ;

Uh oh!

Conversation

robert-david commented May 22, 2026 • edited by edmondchuc Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

robert-david commented May 22, 2026 •

edited by edmondchuc

Loading