> For the complete documentation index, see [llms.txt](https://docs.angular-package.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.angular-package.dev/sass/translator-v1.0.0/overview.md).

# Overview

version: 1.0.0

Simplified dictionary, works only with a global variable.

## Dictionary

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong><code>dictionary.get()</code></strong></td><td>returns global dictionary(if in use) along with a given <code>$dictionary</code> and/or <code>$key</code>.</td><td></td><td><a href="/pages/g9L1IKLWtNwp1leKOprL">/pages/g9L1IKLWtNwp1leKOprL</a></td></tr><tr><td><strong><code>dictionary.is-global()</code></strong></td><td>Checks whether the global dictionary is in use. </td><td></td><td><a href="/pages/Qvk9ZapCMJCy6xKQjzUM">/pages/Qvk9ZapCMJCy6xKQjzUM</a></td></tr><tr><td><strong><code>dictionary.merge()</code></strong></td><td>Merges the global dictionary(if in use) with multiple dictionaries from the given <code>$dictionary</code> in the <code>$key</code>.</td><td></td><td><a href="/pages/MvBqT0eTSe8wokQfuTB9">/pages/MvBqT0eTSe8wokQfuTB9</a></td></tr><tr><td><strong><code>dictionary.pick()</code></strong></td><td>Returns the dictionary from a global dictionary(if in use) and a given <code>$dictionary</code> from the associated <code>$key</code>.</td><td></td><td><a href="/pages/VGDDYiXeDHEDw8iJmg0C">/pages/VGDDYiXeDHEDw8iJmg0C</a></td></tr><tr><td><strong><code>dictionary.set()</code></strong></td><td>Sets the global dictionary and/or given <code>$dictionary</code> under the <code>$key</code> with <code>$value</code>.</td><td></td><td><a href="/pages/8kLo6Ng29tZidR9VHLk5">/pages/8kLo6Ng29tZidR9VHLk5</a></td></tr><tr><td><strong><code>dictionary.translation()</code></strong></td><td>Returns a translation of <code>$search</code> from <code>$dictionaries</code>.</td><td></td><td><a href="/pages/08sJ24s9e9OigPhF9RFg">/pages/08sJ24s9e9OigPhF9RFg</a></td></tr></tbody></table>

## Translate

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong><code>translate.list()</code></strong></td><td>Translates <code>$list</code> with a global dictionary and/or given <code>$dictionary</code>.</td><td></td><td><a href="/pages/j16nDTSea2SN7WXeYVVE">/pages/j16nDTSea2SN7WXeYVVE</a></td></tr><tr><td><strong><code>translate.map()</code></strong></td><td>Translates flatten <code>$map</code> with a global dictionary and/or <code>$dictionary</code>.</td><td></td><td><a href="/pages/HInLGWE2l9ipueM4Fx82">/pages/HInLGWE2l9ipueM4Fx82</a></td></tr><tr><td><strong><code>translate.nth()</code></strong></td><td>Translates element at <code>$n</code> index in <code>$list</code> with a global dictionary and/or <code>$dictionary</code>.</td><td></td><td><a href="/pages/QdJIFH0z6ijSDnTaVwTk">/pages/QdJIFH0z6ijSDnTaVwTk</a></td></tr><tr><td><strong><code>translate.string()</code></strong></td><td>returns a translation of the <code>$string</code>, if found, otherwise not translated <code>$string</code>.</td><td></td><td><a href="/pages/iiHY8vif33Wbec9uAqGQ">/pages/iiHY8vif33Wbec9uAqGQ</a></td></tr></tbody></table>

## Translator

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong><code>translator.dictionary()</code></strong></td><td>Returns(flattened map) the global and/or given <code>$dictionary</code>, merging it with the dictionary retrieved by the provided <code>$key</code> from this dictionary.</td><td></td><td><a href="/pages/BWRQTYtKJQpBjhxAab2x">/pages/BWRQTYtKJQpBjhxAab2x</a></td></tr><tr><td><strong><code>translator.translate()</code></strong></td><td>Translates <code>string</code>, <code>map</code>, or <code>list</code> with a global dictionary and/or given <code>$dictionary</code>, optionally with a dictionary retrieved by the given <code>$key</code>.</td><td></td><td><a href="/pages/lyZydeeJzUg2xkc14kd7">/pages/lyZydeeJzUg2xkc14kd7</a></td></tr></tbody></table>