系統支持的語言是有類:Language表示;
多語言資源對應的類為:LocalizedProperty;
當先選擇某種語言存儲在類中:GenericAttribute;
多語言可以導出為XML文件,當然也支持導出。
IWorkContext及其實體類WebWorkContext為當前運行上下文;用戶的登錄信息以及一些上下文環境設置都保存在此類中。
具體包括:當前用戶信息:CurrentCustomer;當前用戶Cookie;貨幣;語言;稅的類型;供應商等;
展現多語言資源的方式有幾種:
一、在自定義類WebViewPageTModel>中放置了方法:T(),通過此方法,網頁在展現時獲取對應語言的文字。
其實T只是一個代理,代理的定義為:
namespace Nop.Web.Framework.Localization
{
public delegate LocalizedString Localizer(string text, params object[] args);
}
此代理返回值類型為LocalizedString,此類繼承接口IHtmlString,以保證能正確顯示本地化的文字資源。
IHtmlString的定義為:
// 摘要:
// 表示不應再次進行編碼的 HTML 編碼的字符串。
public interface IHtmlString
{
// 摘要:
// 返回 HTML 編碼的字符串。
//
// 返回結果:
// HTML 編碼的字符串。
string ToHtmlString();
}
二、通過擴展HtmlHelper
類HtmlExtensions擴展了HtmlHelper類,
主要是對一些控件的封裝,并支持多語言。
方法 LocalizedEditorT, TLocalizedModelLocal>是對Telerik的TabStrip控件的封裝(也就是多頁簽控件---Tab控件),的。系統同時支持有多種語言時,多為每種語言顯示一個頁簽,當然僅當需要時才這么做。這里面用到了接口ILocalizedModel和接口ILocalizedModelLocal。接口ILocalizedModel用來標示某Model類支持這種多語言顯示,其中里面包括多種語言數據列表Locales,實現接口ILocalizedModelLocal的類就是特定一種語言的數據。LocalizedEditor方法就是根據這些接口的配合實現了支持多種語言頁簽了。Admin項目使用此方法,Web項目沒有使用。
public static HelperResult LocalizedEditorT, TLocalizedModelLocal>(this HtmlHelperT> helper, string name,
Funcint, HelperResult> localizedTemplate,
FuncT, HelperResult> standardTemplate)
where T : ILocalizedModelTLocalizedModelLocal>
where TLocalizedModelLocal : ILocalizedModelLocal
{
return new HelperResult(writer =>
{
if (helper.ViewData.Model.Locales.Count > 1)
{
var tabStrip = helper.Telerik().TabStrip().Name(name).Items(x =>
{
x.Add().Text("Standard").Content(standardTemplate(helper.ViewData.Model).ToHtmlString()).Selected(true);
for (int i = 0; i helper.ViewData.Model.Locales.Count; i++)
{
var locale = helper.ViewData.Model.Locales[i];
var language = EngineContext.Current.ResolveILanguageService>().GetLanguageById(locale.LanguageId);
x.Add().Text(language.Name)
.Content(localizedTemplate
(i).
ToHtmlString
())
.ImageUrl("~/Content/images/flags/" + language.FlagImageFileName);
}
}).ToHtmlString();
writer.Write(tabStrip);
}
else
{
standardTemplate(helper.ViewData.Model).WriteTo(writer);
}
});
}
擴展方法NopLabelForTModel, TValue>是另外一種多語言實現方式。
此方法主要是根據特性DisplayNameAttribute的子類NopResourceDisplayName實現對屬性名稱的描述。此特性是對Model屬性的修飾,以指定屬性的名稱。
例如類AddNewsCommentModel的屬性用NopResourceDisplayName特性指定:
namespace Nop.Web.Models.News
{
public partial class AddNewsCommentModel : BaseNopModel
{
[NopResourceDisplayName("News.Comments.CommentTitle")]
[AllowHtml]
public string CommentTitle { get; set; }
[NopResourceDisplayName("News.Comments.CommentText")]
[AllowHtml]
public string CommentText { get; set; }
public bool DisplayCaptcha { get; set; }
}
}
HtmlHelper的擴展方法NopLabelFor的實現如下:
public static MvcHtmlString NopLabelForTModel, TValue>(this HtmlHelperTModel> helper, ExpressionFuncTModel, TValue>> expression, bool displayHint = true)
{
var result = new StringBuilder();
var metadata = ModelMetadata.FromLambdaExpression(expression, helper.ViewData);
var hintResource = string.Empty;
object value = null;
if (metadata.AdditionalValues.TryGetValue("NopResourceDisplayName", out value))
{
var resourceDisplayName = value as NopResourceDisplayName;
if (resourceDisplayName != null displayHint)
{
var langId = EngineContext.Current.ResolveIWorkContext>().WorkingLanguage.Id;
hintResource =
EngineContext.Current.ResolveILocalizationService>()
.GetResource(resourceDisplayName.ResourceKey + ".Hint", langId);
result.Append(helper.Hint(hintResource).ToHtmlString());
}
}
result.Append(helper.LabelFor(expression, new { title = hintResource }));
return MvcHtmlString.Create(result.ToString());
}
您可能感興趣的文章:- NopCommerce架構分析之(七)主題Theme皮膚管理器
- NopCommerce架構分析之(六)自定義RazorViewEngine和WebViewPage
- NopCommerce架構分析之(五)Model綁定Action參數
- NopCommerce架構分析之(四)基于路由實現靈活的插件機制
- NopCommerce架構分析之(三)EntityFramework數據庫初試化及數據操作
- NopCommerce架構分析(一)Autofac依賴注入類生成容器
- 使用Nopcommerce為商城添加滿XX減XX優惠券功能
- 基于nopCommerce的開發框架 附源碼