Crysta.Locale 0.1.3

Crysta

Introduction

The "Crysta.Locale" provides the mechanism of the localization (switching displayed texts) for the WPF Application.

How to use

At first, declares some reference to the namespace as below.

using Crysta;
using Crysta.Locale;

In the initializer of the view-model class, you initialize the Crysta.Locale.LanguageSource class as below. <br/>And then publishs it as a public property to binding in the Xaml.

namespace SampleProject 
{

	/// <summary>
	/// A bindable object (View-model in the MVVM design pattern or Presenter in the MVP design pattern) for the MainWindow.DataContext property.
	/// </summary>
	internal class MainPresenter : Presenter<MainWindow>
	{
		
		public MainPresenter() {
	
		    // Instantizes a new instance.
		    _LangSrc = new();
		    
	#if UsingJson
		    
		    // Makes a full-path specifies a language table file. (In this example, Specifies the path relatied application root directry.)
		    // You have to reference the resource file with "Build Action" property is "Content" and "Copy to Output Dictionary" property is "Copy always".
		    string en = System.IO.Path.Combine(AppDomain.CurrentDomain.BaseDirectory, @"Resources\LanguageResource.en.json");
		    string ja = System.IO.Path.Combine(AppDomain.CurrentDomain.BaseDirectory, @"Resources\LanguageResource.ja.json");
		    
		    // Registers it to the <see cref="LanguageSource"/> object.
		    _LangSrc.RegisterFromJSONFile(new System.Globalization.CultureInfo("en-US", false), en);
		    _LangSrc.RegisterFromJSONFile(new System.Globalization.CultureInfo("ja-JP", false), ja);
		    
	#else
		    
		    // Registers your <see cref="IDictionary{string, string}"/> (key:string, value:string) object with a <see cref="CultureInfo"/> key the corresponding to it.
		    
		    IDictionary<string, string>; enDic = new Dictionary<string, string>();
		    IDictionary<string, string>; jaDic = new Dictionary<string, string>();
		    
		    /* Adds your interpret definitions */
		    
		    _LangSrc.Register(new System.Globalization.CultureInfo("en-US", false), enDic);
		    _LangSrc.Register(new System.Globalization.CultureInfo("ja-JP", false), jaDic);
		    
	#endif
		}
	
	
		LanguageSource _LangSrc;
	
		// Publish as a binding property.
		LanguageSource Texts => _LangSrc;
	}

}

<br/> How to make the language table file (.json)

{
  "MyKey1": "Key1Value"
  "MyKey2": "Key2Value"
  ...
}

You make any number of the file corresponding to each languages.

<br/>

How to bind to the text content in the view (.xaml):

<Label Content="{Binding Lang.Current[MyKey1]}"/>
<TextBox Text="{Binding Lang.Current[MyKey2]}"/>

<br/> How to switch displayed language texts (.cs):

private void MyMethod() {
	// Set a new desired culture into the application UI's culture property.
	CultureInfo.CurrentUICulture = new("en-US");

	// Refreshs all of the binded texts in the UI.
	_LangSrc.UpdateCulture();
}