diff --git a/index.html b/index.html index 07f6141..939f04b 100644 --- a/index.html +++ b/index.html @@ -292,7 +292,7 @@

The `renderMethod` Property

The `renderMethod` property is a reserved extension point in the -[[[VC-DATA-MODEL-2.1]]] specification . An [=issuer=] can utilize this property +[[[VC-DATA-MODEL-2.1]]] specification. An [=issuer=] can utilize this property in a [=verifiable credential=] to express one or more preferred render methods.

@@ -310,6 +310,53 @@

The `renderMethod` Property

+
+

Localization: Selecting on Language and Locale

+ +

+One of the core use cases for this specification is the ability to present a +different rendering payload based on the preferred language or locale of the +user. This extends beyond the value-level localization offered by the core +[[VC-DATA-MODEL#internationalization-considerations]] specification, and beyond +translating field labels. Clients displaying or rendering VCs must be able to +select arbitrary layouts, styling or full pre-rendered payloads based on the +user's language and locale preferences. +

+ +

+In the example below, the `renderMethod` property contains an array of two +`static` render method objects, each providing a pre-rendered PNG image of +the credential. The client selects the one whose `inLanguage` value best +matches the user's language preference. +

+ +
+{
+...
+"renderMethod": [
+  {
+    "type": "SuiteRenderMethod",
+    "renderSuite": "static",
+    "inLanguage": "en",
+    "mediaType": "image/png",
+    "name": "Credential image",
+    "payload": "data:image/png;base64,iVBORw0KGgo...AAAElFTkSuQmCC"
+  },
+  {
+    "type": "SuiteRenderMethod",
+    "renderSuite": "static",
+    "inLanguage": "es",
+    "mediaType": "image/png",
+    "name": "Imagen de la credencial",
+    "payload": "data:image/png;base64,iVBORw0KGgo...AAAElFTkSuQmCC"
+  }
+]
+...
+}
+        
+
+

SuiteRenderMethod

@@ -370,6 +417,15 @@

SuiteRenderMethod

than `name` of when the particular rendering might be useful. + + inLanguage + +An OPTIONAL [=string=] that designates a language range (based on +schema.org/inLanguage) this render +method is meant to support (see the Matching +language and language tags section for more details). + + renderProperty