形状介绍（Introducing Shapes）
var shapeType = shapeName.Metadata.Type;
创建形状（Creating Shapes）
protected override DriverResult Display(
MapPart part, string displayType, dynamic shapeHelper)
{
return ContentShape("Parts_Map",
() => shapeHelper.Parts_Map(
Longitude: part.Longitude,
Latitude: part.Latitude));
}using Maps.Models;
using Orchard.ContentManagement;
using Orchard.ContentManagement.Drivers;
namespace Maps.Drivers
{
public class MapPartDriver : ContentPartDriver<MapPart>
{
protected override DriverResult Display(
MapPart part, string displayType, dynamic shapeHelper)
{
return ContentShape("Parts_Map",
() => shapeHelper.Parts_Map(
Longitude: part.Longitude,
Latitude: part.Latitude));
}
//GET
protected override DriverResult Editor(
MapPart part, dynamic shapeHelper)
{
return ContentShape("Parts_Map_Edit",
() => shapeHelper.EditorTemplate(
TemplateName: "Parts/Map",
Model: part));
}
//POST
protected override DriverResult Editor(
MapPart part, IUpdateModel updater, dynamic shapeHelper)
{
updater.TryUpdateModel(part, Prefix, null, null);
return Editor(part, shapeHelper);
}
}
}标记了Get的Editor方法使用ContentShape去创建一个形状用于编辑模板。在这个案例中，形状类型名称是Parts_Map_Edit并且shapeHelper对象创建了一个EditorTemplate的形状。这是一个特殊的形状，它有一个模板名称属性和一个Model属性。模板名称属性指定了一个模板的部分路径，在这个案例中，“Parts/Map”将使Orchard在Views/EditorTemplates/Parts/Map.cshtml路径中查找相应的编辑模板。Model属性设置了这个模板所用到的数据。
命名形状和模板（Naming Shapes and Templates）
下表总结了形状类型和模板的命名规则：
Applied To Shape Naming Convention Shape Type Example Template Example Content shapes Content__[ContentType] Content__BlogPost Content-BlogPost Content shapes Content__[Id] Content__42 Content-42 Content shapes Content__[DisplayType] Content__Summary Content.Summary Content shapes Content_[DisplayType]__[ContentType] Content_Summary__BlogPost Content-BlogPost.Summary Content shapes Content_[DisplayType]__[Id] Content_Summary__42 Content-42.Summary Content.Edit shapes Content_Edit__[DisplayType] Content_Edit__Page Content-Page.Edit Content Part templates [ShapeType]__[Id] Parts_Common_Metadata__42 Parts/Common.Metadata-42 Content Part templates [ShapeType]__[ContentType] Parts_Common_Metadata__BlogPost Parts/Common.Metadata-BlogPost Field templates [ShapeType]__[FieldName] Fields_Common_Text__Teaser Fields/Common.Text-Teaser Field templates [ShapeType]__[PartName] Fields_Common_Text__TeaserPart Fileds/Common.Text-TeaserPart Field templates [ShapeType]__[ContentType]__[PartName] Fields_Common_Text__Blog__TeaserPart Fields/Common.Text-Blog-TeaserPart Field templates [ShapeType]__[PartName]__[FieldName] Fields_Common_Text__TeaserPart__Teaser Fields/Common.Text-TeaserPart-Teaser Field templates [ShapeType]__[ContentType]__[FieldName] Fields_Common_Text__Blog__Teaser Fields/Common.Text-Blog-Teaser Field templates [ShapeType]__[ContentType]__[PartName]__[FieldName] Fields_Common_Text__Blog__TeaserPart__Teaser Fields/Common.Text-Blog-TeaserPart-Teaser LocalMenu LocalMenu__[MenuName] LocalMenu__main LocalMenu-main LocalMenuItem LocalMenuItem__[MenuName] LocalMenuItem__main LocalMenuItem-main Menu Menu__[MenuName] Menu__main Menu-main MenuItem MenuItem__[MenuName] MenuItem__main MenuItem-main Resource Resource__[FileName] Resource__flower.gif Resource-flower.gif Style Style__[FileName] Style__site.css Style-site.css Widget Widget__[ContentType] Widget__HtmlWidget Widget-HtmlWidget Widget Widget__[ZoneName] Widget__AsideSecond Widget-AsideSecond Zone Zone__[ZoneName] Zone__AsideSecond Zone-AsideSecond
- 内容项形状模板在 views/items目录下。
- 部件形状模板在views/parts目录下。
- 字段形状模板在views/fields目录下。
- 编辑模板在相应的 views/EditorTemplates/{相应模板名称} 目录下。例如：部件的编辑模板需要在 views/EditorTemplates/Parts目录下。
- 其他的形状模板都直接在views 目录下。
从模板文件名称到形状名称（From Template File Name to Shape Name）
- 将点（.）和反斜杠（\）改为下划线（_）。注意这点不包含后缀名中的点，如.cshtml。形状的模板文件需要在约定的目录中（见上文）。
- 短划线（-）改为双下划线（__）。
形状的可替换性呈现（Alternate Shape Rendering）
那一个可用替换将被呈现（Which Alternate Will Be Rendered?）
使用模板呈现形状（Built-In Content Item Alternates）
<img alt="Location" border="1" src="http://maps.google.com/maps/api/staticmap?
&zoom=14
&size=256x256
&maptype=satellite&markers=color:blue|@Model.Latitude,@Model.Longitude
&sensor=false" />@model Maps.Models.MapPart
<fieldset>
<legend>Map Fields</legend>
<div class="editor-label">
@Html.LabelFor(model => model.Longitude)
</div>
<div class="editor-field">
@Html.TextBoxFor(model => model.Latitude)
@Html.ValidationMessageFor(model => model.Latitude)
</div>
<div class="editor-label">
@Html.LabelFor(model => model.Longitude)
</div>
<div class="editor-field">
@Html.TextBoxFor(model => model.Longitude)
@Html.ValidationMessageFor(model => model.Longitude)
</div>
</fieldset>更多关于模板和Razor语法的信息，可查看《Template Files and their Locations》。
包装（Wrappers）
创建一个形状方法（Creating a Shape Method）
public class DateTimeShapes : IDependency {
private readonly IClock _clock;
public DateTimeShapes(IClock clock) {
_clock = clock;
T = NullLocalizer.Instance;
}
public Localizer T { get; set; }
[Shape]
public IHtmlString DateTimeRelative(HtmlHelper Html, DateTime dateTimeUtc) {
var time = _clock.UtcNow - dateTimeUtc;
if (time.TotalDays > 7)
return Html.DateTime(dateTimeUtc, T("'on' MMM d yyyy 'at' h:mm tt"));
if (time.TotalHours > 24)
return T.Plural("1 day ago", "{0} days ago", time.Days);
if (time.TotalMinutes > 60)
return T.Plural("1 hour ago", "{0} hours ago", time.Hours);
if (time.TotalSeconds > 60)
return T.Plural("1 minute ago", "{0} minutes ago", time.Minutes);
if (time.TotalSeconds > 10)
return T.Plural("1 second ago", "{0} seconds ago", time.Seconds);
return T("a moment ago");
}
}