# dictionary.translation()

The `dictionary.translation()` function returns a translation of [`$search`](#usdsearch) from a [global dictionary](https://docs.angular-package.dev/sass/translator-v1.0.0/dictionary.variables#usddictionary-default), [`$dictionary`](#usddictionary), and [`$dictionaries`](#usddictionaries...).

{% code lineNumbers="true" %}

```scss
// Sass.
@use 'sass:list';

// Variables.
@use 'dictionary.variables' as variables;

// Functions.
@use '../../../values';

// The `translator.dictionary-translation()` or `dictionary.translation()`
@function translation($search, $dictionary: (), $dictionaries...) {
  @each $dictionary in values.combine($dictionary, $dictionaries) {
    @each $phrase, $translation in $dictionary {
      @if list.index($phrase, $search) and $translation {
        @return $translation;
      }
    }
  }
  @return null;
}
```

{% endcode %}

{% embed url="<https://github.com/angular-package/sass/blob/main/translator/dictionary/_dictionary.translation.function.scss>" %}

### Parameters

#### `$search`

A word(string) or phrase(list space separated) to search for translation.

#### `$dictionary`

Additional dictionary to look for [`$search`](#usdsearch) translation.

#### `$dictionaries...`

Dictionaries to look for [`$search`](#usdsearch) translation.

### Return

The return value is a translation of the [`$search`](#usdsearch).

## Examples

```scss
// Use.
@use '@angular-package/sass/translator';

// Examples.


```