1033024: Localization UG in Blazor PDF Viewer

Document-Processing-toc.html

@@ -1251,7 +1251,13 @@
 								</ul>
 							</li>
 							<li> <a href="/document-processing/pdf/pdf-viewer/blazor/events">Events</a></li>
-							<li> <a href="/document-processing/pdf/pdf-viewer/blazor/globalization">Globalization and RTL</a></li>
+							<li> <a href="/document-processing/pdf/pdf-viewer/blazor/globalization">Localization and Globalization</a>
+								<ul>
+									<li><a href="/document-processing/pdf/pdf-viewer/blazor/globalization/overview">Overview</a></li>
+									<li><a href="/document-processing/pdf/pdf-viewer/blazor/globalization/localization">Localization</a></li>
+									<li><a href="/document-processing/pdf/pdf-viewer/blazor/globalization/rtl-support">RTL and Localization</a></li>
+								</ul>
+							</li>
 							<li> <a href="/document-processing/pdf/pdf-viewer/blazor/faq">FAQ</a> 
 								<ul>
 									<li> <a href="/document-processing/pdf/pdf-viewer/blazor/faqs/how-to-load-PDF-from-URL-to-server-side-PDF-viewer">How to Load PDF from URL to server-side PDF viewer</a></li>

Document-Processing/PDF/PDF-Viewer/blazor/globalization/localization.md

@@ -0,0 +1,256 @@
+---
+layout: post
+title: Set Up Static Localization in Blazor PDF Viewer Component | Syncfusion
+description: Learn how to enable static localization in Syncfusion Blazor PDF Viewer using culture-based resource files.
+platform: document-processing
+control: SfPdfViewer
+documentation: ug
+---
+
+# Set Up Static Localization
+
+This guide shows you how to enable static localization in your Blazor PDF Viewer application using culture-based resource files.
+
+## Prerequisites
+
+- A Blazor WebApp project (see [Getting Started](../getting-started/web-app))
+- Syncfusion Blazor PDF Viewer installed
+- Visual Studio 2022 or Visual Studio Code
+- Basic knowledge of Blazor components and C#
+
+## Supported Cultures
+
+Blazor PDF Viewer supports multiple languages. Download culture-specific resource files from the [Syncfusion Blazor Locale GitHub repository](https://github.com/syncfusion/blazor-locale).
+
+## Step 1: Create the Resources Folder
+
+1. In your Blazor project root, create a new folder named `Resources`
+2. This folder will contain all culture-specific .resx files
+
+## Step 2: Add Culture-Based Resource Files
+
+1. Navigate to the [Syncfusion Blazor Locale repository](https://github.com/syncfusion/blazor-locale)
+2. Download the culture files you need (e.g., `SfResources.ar.resx` for Arabic)
+3. Also download `SfResources.resx` (neutral/default culture)
+4. Place all files in the `Resources` folder
+
+![Resources Files in root](../images/resources-files.png)
+
+**Folder structure example:**
+```
+YourBlazorApp/
+├── Resources/
+│   ├── SfResources.resx          (default)
+│   ├── SfResources.ar.resx       (Arabic)
+│   ├── SfResources.de.resx       (German)
+│   └── SfResources.fr.resx       (French)
+├── Program.cs
+└── Pages/
+```
+
+## Step 3: Create the SyncfusionLocalizer Class
+
+Create a new file named `SyncfusionLocalizer.cs` in your project root. The implementation differs based on your development environment.
+
+{% tabcontents %}
+{% tabcontent Using Visual Studio %}
+
+For Visual Studio, the Designer.cs file is auto-generated:
+
+1. Open `SfResources.resx` in the Resource Editor
+2. Right-click → Properties
+3. Set **Access Modifier** to **Public**
+
+![Set Access Modifier to Public](../images/access-modifier-public.png)
+
+4. Visual Studio automatically generates `SfResources.Designer.cs`
+
+Then, create `SyncfusionLocalizer.cs`:
+
+{% tabs %}
+{% highlight razor tabtitle="SyncfusionLocalizer.cs" %}
+
+using Syncfusion.Blazor;
+
+public class SyncfusionLocalizer : ISyncfusionStringLocalizer
+{
+    public string GetText(string key)
+    {
+        return this.ResourceManager.GetString(key);
+    }
+
+    public System.Resources.ResourceManager ResourceManager
+    {
+        get
+        {
+            // Replace YourBlazorApp with your actual application namespace
+            return YourBlazorApp.Resources.SfResources.ResourceManager;
+
+            // For .NET MAUI Blazor App, use:
+            // return YourBlazorApp.LocalizationResources.SfResources.ResourceManager;
+        }
+    }
+}
+
+{% endhighlight %}
+{% endtabs %}
+
+{% endtabcontent %}
+{% tabcontent Using Visual Studio Code %}
+
+For Visual Studio Code, manually define the ResourceManager:
+
+Create `SyncfusionLocalizer.cs`:
+
+{% tabs %}
+{% highlight razor tabtitle="SyncfusionLocalizer.cs" %}
+
+using Syncfusion.Blazor;
+using System.Resources;
+
+public class SyncfusionLocalizer : ISyncfusionStringLocalizer
+{
+    // Replace BlazorWebApp with your application namespace
+    private readonly ResourceManager resourceManager =
+        new ResourceManager(
+            "BlazorWebApp.Resources.SfResources",
+            typeof(SyncfusionLocalizer).Assembly);
+
+    public string GetText(string key)
+    {
+        return resourceManager.GetString(key) ?? key;
+    }
+
+    public ResourceManager ResourceManager => resourceManager;
+}
+
+{% endhighlight %}
+{% endtabs %}
+
+{% endtabcontent %}
+{% endtabcontents %}
+
+
+## Step 4: Register Services in Program.cs
+
+Open `Program.cs` and add the following code:
+
+{% tabs %}
+{% highlight razor tabtitle="Program.cs"  hl_lines="10 13" %}
+using Syncfusion.Blazor;
+
+var builder = WebApplication.CreateBuilder(args);
+
+// Add services to the container
+builder.Services.AddRazorComponents()
+    .AddInteractiveServerComponents();
+
+// Add Syncfusion Blazor services
+builder.Services.AddSyncfusionBlazor();
+
+// Register the ISyncfusionStringLocalizer for localization
+builder.Services.AddSingleton(typeof(ISyncfusionStringLocalizer), typeof(SyncfusionLocalizer));
+
+var app = builder.Build();
+
+// Configure the HTTP request pipeline
+if (!app.Environment.IsDevelopment())
+{
+    app.UseExceptionHandler("/Error", createScopeForErrors: true);
+    app.UseHsts();
+}
+
+app.UseHttpsRedirection();
+app.UseStaticFiles();
+app.UseAntiforgery();
+
+app.MapRazorComponents<App>()
+    .AddInteractiveServerRenderMode();
+
+app.Run();
+{% endhighlight %}
+{% endtabs %}
+
+## Step 5: Set the Application Culture
+
+In `Program.cs`, after `var app = builder.Build();`, set the culture using `UseRequestLocalization`:
+
+{% tabs %}
+{% highlight csharp tabtitle="Program.cs"  hl_lines="4" %}
+var app = builder.Build();
+
+// Set the application culture
+app.UseRequestLocalization("ar");  // Arabic
+
+// Common culture codes:
+// "ar" - Arabic
+// "de" - German
+// "de-DE" - German (Germany)
+// "en" - English
+// "en-US" - English (United States)
+// "fr" - French
+// "es" - Spanish
+// "ja" - Japanese
+// "zh" - Chinese (Simplified)
+// "zh-TW" - Chinese (Traditional)
+
+// See supported culture codes at https://github.com/syncfusion/blazor-locale
+{% endhighlight %}
+{% endtabs %}
+
+## Step 6: Test Localization
+
+Open `Pages/Home.razor` and add the PDF Viewer component:
+
+{% tabs %}
+{% highlight razor tabtitle="Home.razor" %}
+
+<SfPdfViewer2 DocumentPath="https://cdn.syncfusion.com/content/pdf/pdf-succinctly.pdf"
+              Height="100%"
+              Width="100%">
+</SfPdfViewer2>
+
+{% endhighlight %}
+{% endtabs %}
+
+Run your application and verify that:
+
+- Toolbar buttons display in the selected language
+- Dialog texts and messages appear in the selected language
+- All UI elements reflect the chosen culture
+
+![Localization demo showing PDF Viewer in multiple languages](../images/localization-demo.png)
+
+[View Sample in GitHub](https://github.com/SyncfusionExamples/blazor-pdf-viewer-examples)
+
+## Troubleshooting
+
+**Issue:** SfResources.Designer.cs not generated in Visual Studio
+
+**Solution:** Make sure you:
+1. Open `SfResources.resx` in the Resource Editor (double-click the file)
+2. Right-click on the file in Solution Explorer
+3. Select Properties (not Properties window)
+4. Change Access Modifier from "Internal" to "Public"
+5. Save the file (Ctrl+S)
+
+**Issue:** ResourceManager throws exception in Visual Studio Code
+
+**Solution:** Verify that:
+1. The namespace in the ResourceManager string matches your project namespace exactly
+2. The folder structure matches: `YourNamespace.Resources.SfResources`
+3. Resource files are in the `Resources` folder at project root
+
+## Related Resources
+
+- [Blazor Common Localization](https://blazor.syncfusion.com/documentation/common/localization)
+- [Supported Cultures - GitHub](https://github.com/syncfusion/blazor-locale)
+
+## After Completing This Guide
+
+You now have a localized Blazor PDF Viewer displaying UI strings in your chosen language. Your application supports switching between multiple languages with culture-based resource files.
+
+## Next Steps
+
+- [Enable right-to-left support](rtl-support) for RTL languages like Arabic
+- [Configure dynamic localization](https://blazor.syncfusion.com/documentation/common/localization#dynamically-set-the-culture)

Document-Processing/PDF/PDF-Viewer/blazor/globalization/overview.md

@@ -0,0 +1,80 @@
+---
+layout: post
+title: Globalization in Blazor PDF Viewer Component | Syncfusion
+description: Learn about globalization and localization in Syncfusion Blazor PDF Viewer to support multiple languages and cultures.
+platform: document-processing
+control: SfPdfViewer
+documentation: ug
+---
+
+# Overview of Globalization and Localization
+
+Blazor PDF Viewer supports globalization and localization to help you build applications that serve users across different languages and cultural regions.
+
+## What is Globalization?
+
+Globalization is the design and development approach of creating applications that work seamlessly across different cultures, languages, and regions. This includes supporting:
+
+- Multiple languages for UI text
+- Culture-specific date, time, and number formats
+- Right-to-left (RTL) text directions for languages like Arabic and Hebrew
+- Regional preferences and conventions
+
+## What is Localization?
+
+Localization is the process of adapting your application's content and interface for specific languages and regions. In Blazor PDF Viewer, this includes:
+
+- Translating toolbar buttons, dialogs, and error messages
+- Displaying culture-based resource strings
+- Supporting RTL layout and text direction
+- Applying culture-specific formatting
+
+## Why Localize Your PDF Viewer?
+
+Localizing your PDF Viewer application provides:
+
+- **Better User Experience:** Users see the interface in their preferred language
+- **Broader Market Reach:** Support for multiple languages expands your application's accessibility
+- **Cultural Respect:** Display content in culturally appropriate formats and directions
+- **Compliance:** Meet regional requirements and accessibility standards
+
+## Localization Approaches in Blazor PDF Viewer
+
+### Static Localization
+
+Use predefined culture-based resource files (.resx) that ship with your application. Ideal for applications with:
+
+- A fixed set of supported languages
+- Translations that don't change frequently
+- Simple deployment requirements
+
+### Dynamic Localization
+
+Load translations from external sources (databases, APIs, or cloud services) at runtime. Ideal for applications with:
+
+- Frequently updated translations
+- A large number of supported languages
+- User-contributed or crowd sourced content
+
+## How Blazor PDF Viewer Supports Localization
+
+Blazor PDF Viewer provides:
+
+- **ISyncfusionStringLocalizer Interface:** Implement custom localization logic
+- **Culture-Based Resource Files:** Download predefined .resx files for supported languages
+- **EnableRtl Property:** Enable right-to-left layout support
+- **Culture Configuration:** Set your application's culture in `Program.cs`
+
+## Supported Languages
+
+Blazor PDF Viewer includes localization support for multiple languages. See [supported cultures](https://github.com/syncfusion/blazor-locale) for the complete list.
+
+## Related Resources
+
+- [Blazor Common Localization](https://blazor.syncfusion.com/documentation/common/localization)
+- [Blazor Common Globalization](https://blazor.syncfusion.com/documentation/common/globalization)
+
+## Next Steps
+
+- [Set up static localization](localization)
+- [Enable right-to-left support](rtl-support)