# Globalization

The globalization process combines the translation of component messages with adapting them to specific cultures.

For more information on how globalization practices are implemented in Kendo UI for Angular, refer to the [overview article](https://www.telerik.com/kendo-angular-ui-develop/components/globalization). For more information on the globalization aspects which are available for each component, refer to the article on [globalization support](https://www.telerik.com/kendo-angular-ui-develop/components/globalization/globalization-support).

## Internationalization

The internationalization (i18n) process applies specific culture formats to a web application.

For more information, refer to:

<Row>
  <Column count={[24,24,12]} style={{marginBottom: "1rem"}}>
    <Component className="tile" href="/globalization/internationalization">
      <ComponentTitle>Kendo UI Documentation on Internationalization</ComponentTitle>
      <ComponentDescription style={{padding: "0 10px 10px 10px"}}>Learn about internationalization features and practices in Kendo UI for Angular.</ComponentDescription>
    </Component>
  </Column>
  <Column count={[24,24,12]} style={{marginBottom: "1rem"}}>
    <Component className="tile" href="https://github.com/telerik/kendo-intl">
      <ComponentTitle>kendo-intl (Base Internationalization Package)</ComponentTitle>
      <ComponentDescription style={{padding: "0 10px 10px 10px"}}>Explore the base internationalization package on GitHub for advanced use cases.</ComponentDescription>
    </Component>
  </Column>
</Row>

## Messages

The [PDFViewer](https://www.telerik.com/kendo-angular-ui-develop/components/pdfviewer) component supports both [built-in](https://www.telerik.com/kendo-angular-ui-develop/components/pdfviewer/globalization#built-in-messages) and [custom](https://www.telerik.com/kendo-angular-ui-develop/components/pdfviewer/globalization#custom-messages) messages.

### Built-In Messages

To translate the built-in messages, utilize the [Angular i18n framework](https://angular.dev/guide/i18n). For more information on how to achieve this, refer to the article on [Localization](https://www.telerik.com/kendo-angular-ui-develop/components/globalization/localization).

### Custom Messages

To customize the built-in messages of the PDFViewer component, you can use the [`PDFViewerCustomMessagesComponent`](https://www.telerik.com/kendo-angular-ui-develop/components/pdfviewer/api/pdfviewercustommessagescomponent) component. This component allows you to override the default messages with your own translations without the need for Angular i18n.

```html
<kendo-pdfviewer [url]="pdfUrl">
  <kendo-pdfviewer-messages
      downloadTitle="Download PDF"
      printTitle="Print PDF">
  </kendo-pdfviewer-messages>
</kendo-pdfviewer>
```

> In i18n applications, message attributes take precedence over localized text from translation files.

The following table lists the available messages for the PDFViewer component:

| Message Key                      | Default Value                      |
| -------------------------------- | ---------------------------------- |
| `pagerFirstPage`                 | Go to the first page               |
| `pagerPreviousPage`              | Go to the previous page            |
| `pagerNextPage`                  | Go to the next page                |
| `pagerLastPage`                  | Go to the last page                |
| `pagerPage`                      | Page                               |
| `pagerOf`                        | of                                 |
| `pagerInputTitle`                | Page Number                        |
| `pagerInputLabel`                | Type a page number                 |
| `zoomInTitle`                    | Zoom in                            |
| `zoomOutTitle`                   | Zoom out                           |
| `selectionTitle`                 | Enable selection                   |
| `panningTitle`                   | Enable panning                     |
| `searchTitle`                    | Search                             |
| `openTitle`                      | Open                               |
| `downloadTitle`                  | Download                           |
| `printTitle`                     | Print                              |
| `fitToPage`                      | Fit to page                        |
| `fitToWidth`                     | Fit to width                       |
| `searchInputPlaceholder`         | Search                             |
| `searchMatchesOf`                | of                                 |
| `searchPreviousMatchTitle`       | Previous match                     |
| `searchNextMatchTitle`           | Next match                         |
| `searchCloseTitle`               | Close                              |
| `searchMatchCaseTitle`           | Match case                         |
| `zoomInputPlaceholder`           | Choose zoom level                  |
| `blankPageDropFilesHere`         | Drop files here to upload          |
| `blankPageExternalDropFilesHere` | Drag and drop files here to upload |
| `blankPageSelect`                | Select files...                    |

The following example demonstrates how to utilize the custom messages for the PDFViewer component.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/pdfviewer/globalization/messages/source.txt)

## Right-to-Left Support

The PDFViewer component supports right-to-left (RTL) layouts. To enable RTL support, you can set the `RTL` provider to `true` in the component's providers.

```typescript
import { Component } from '@angular/core';
import { KENDO_PDFVIEWER } from '@progress/kendo-angular-pdfviewer';
import { RTL } from '@progress/kendo-angular-l10n';

@Component({
    selector: 'my-app',
    standalone: true,
    imports: [KENDO_PDFVIEWER],
    providers: [{ provide: RTL, useValue: true }],
    template: `
        <kendo-pdfviewer> </kendo-pdfviewer>
    `
})
export class AppComponent {}
```

The following example demonstrates how to utilize the RTL support for the PDFViewer components.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/pdfviewer/globalization/rtl/source.txt)

## Suggested Links

* [Angular PDFViewer Homepage](https://www.telerik.com/kendo-angular-ui/pdfviewer)
* [Globalization](https://www.telerik.com/kendo-angular-ui-develop/components/globalization)
* [Internationalization](https://www.telerik.com/kendo-angular-ui-develop/components/globalization/internationalization)
* [Localization](https://www.telerik.com/kendo-angular-ui-develop/components/globalization/localization)
