core/str

Fetch and return language strings.

Source:
Since:
  • 2.9
Copyright:
  • 2015 Damyon Wiese
License:
  • http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

Members

(static, constant) get_string

Source:

Return a Promise that resolves to a string.

If the string has previously been cached, then the Promise will be resolved immediately, otherwise it will be fetched from the server and resolved when available.

Example

Fetching a string

import {getString} from 'core/str';
get_string('cannotfindteacher', 'error')
.then((str) => window.console.log(str)); // Cannot find teacher

(static, constant) get_strings

Source:

Make a batch request to load a set of strings.

Any missing string will be fetched from the server. The Promise will only be resolved once all strings are available, or an attempt has been made to fetch them.

Example

Fetching a set of strings

import {getStrings} from 'core/str';
get_strings([
    {
        key: 'cannotfindteacher',
        component: 'error',
    },
    {
        key: 'yes',
        component: 'core',
    },
    {
        key: 'no',
        component: 'core',
    },
])
.then((cannotFindTeacher, yes, no) => {
    window.console.log(cannotFindTeacher); // Cannot find teacher
    window.console.log(yes); // Yes
    window.console.log(no); // No
});

(static, constant) getString

Source:

Return a Promise that resolves to a string.

If the string has previously been cached, then the Promise will be resolved immediately, otherwise it will be fetched from the server and resolved when available.

Example

Fetching a string

import {getString} from 'core/str';

getString('cannotfindteacher', 'error')
.then((str) => window.console.log(str)); // Cannot find teacher

(static, constant) getStrings

Source:

Make a batch request to load a set of strings.

Any missing string will be fetched from the server. The Promise will only be resolved once all strings are available, or an attempt has been made to fetch them.

Example

Fetching a set of strings

import {getStrings} from 'core/str';
getStrings([
    {
        key: 'cannotfindteacher',
        component: 'error',
    },
    {
        key: 'yes',
        component: 'core',
    },
    {
        key: 'no',
        component: 'core',
    },
])
.then((cannotFindTeacher, yes, no) => {
    window.console.log(cannotFindTeacher); // Cannot find teacher
    window.console.log(yes); // Yes
    window.console.log(no); // No
});

Methods

(protected, inner) cache_strings(strings)

Source:

Add a list of strings to the caches.

This function should typically only be called from core APIs to pre-cache values.

Parameters:
Name Type Description
strings Array.<Object>

List of strings to fetch

Properties
Name Type Attributes Default Description
key string

The string identifer to fetch
value string

The string value
component string <optional>
 'core'

The componet to fetch from
lang string <optional>
 Config.language

The language to fetch a string for. Defaults to current page language.

(inner) getRequestedStrings(requests) → {Array.<Promise>}

Source:

Internal function to perform the string requests.

Parameters:
Name Type Description
requests Array.<StringRequest>

List of strings to fetch
Returns:
Type
Array.<Promise>

Type Definitions

StringRequest

Source:
Type:
  • object