Interface: Translation

Provides i18n strings and templates for the UI elements.

Methods

formatIri()

formatIri(iri): string

Formats IRI to display in the UI:

• usual IRIs are enclosed in <IRI>;
• anonymous element IRIs displayed as (blank node).

Parameters

Parameter	Type
iri	string

Returns

string

Defined in

coreUtils/i18n.tsx:133

---

formatLabel()

formatLabel(labels, fallbackIri, language): string

Same as selectLabel() but uses local part of the fallbackIri as a fallback to display an entity referred by IRI even if there is no suitable label to use.

Example:

// Returns: 'Apple'
const name = t.formatLabel(
    [
        model.factory.literal('Apfel', 'de'),
        model.factory.literal('Яблоко', 'ru'),
    ],
    'http://example.com/entity/Apple',
    'en'
);

Parameters

Parameter	Type
labels	undefined | readonly Literal[]
fallbackIri	string
language	string

Returns

string

Defined in

coreUtils/i18n.tsx:122

---

selectLabel()

selectLabel(labels, language): undefined | Literal

Selects a single preferred literal for the target language out of several candidates.

Language code is specified as lowercase BCP47 string (examples: en, en-gb, etc).

Example:

// Returns: Rdf.Literal { value = 'Apfel', language = 'de' }
const name = t.selectLabel(
    [
        model.factory.literal('Apple', 'en'),
        model.factory.literal('Apfel', 'de'),
        model.factory.literal('Яблоко', 'ru'),
    ],
    'de'
);

Parameters

Parameter	Type	Description
labels	readonly Literal[]	candidate literal with same or different language codes
language	string	target language code

Returns

undefined | Literal

selected literal or undefined if no suitable literal was found

Defined in

coreUtils/i18n.tsx:83

---

selectValues()

selectValues(values, language): (Literal | NamedNode<string>)[]

Selects a subset of RDF values for the target language.

The value is included if matches at least one criteria:

• is a named node,
• is a literal without language,
• is a literal with language equal to the target language.

Language code is specified as lowercase BCP47 string (examples: en, en-gb, etc).

Parameters

Parameter	Type
values	readonly (Literal | NamedNode<string>)[]
language	string

Returns

(Literal | NamedNode<string>)[]

Defined in

coreUtils/i18n.tsx:99

---

template()

template(key, parts): ReactNode

Templates a translation string into React Fragment by replacing placeholders with provided React nodes (elements, etc).

Parameters

Parameter	Type
key	`${string}.${string}`
parts	Record<string, ReactNode>

Returns

ReactNode

Defined in

coreUtils/i18n.tsx:55

---

text()

text(key, placeholders?): string

Formats a translation string by replacing placeholders with provided values.

Parameters

Parameter	Type
key	`${string}.${string}`
placeholders?	Record<string, string | number | boolean>

Returns

string

Defined in

coreUtils/i18n.tsx:46