Mallar

När nya sidor skapas, antingen av en redaktör eller från ett program, skapas de baserat på Dynamix-mallar. En mall representeras av klassen Dynamix.Template. Ofta benämns även den presentationsfil som visar mallens innehåll, exempelvis en aspx-fil, som en mall.

De grundläggande uppgifterna för en mall är:

  • Ange hur informationen ska presenteras

  • Hantera vilka komponenter som ska finnas på sidor baserade på mallen

  • Hantera tillgång till nya innehåll och standardinnehåll på sidor

Definition och klasser

NavigationItem

För att skapa en egen mall definieras en klass som ärvs från Dynamix.Template eller någon av dess subklasser enligt:

  1. C#
  1. using System;
  2. using System.Runtime.Serialization;
  4. namespace MySite.Templates
  5. {
  7. [Serializable]
  8. [Dynamix.Definitions.Template]
  9. public class WideTemplate : Dynamix.ContentTemplate
  10. {
  12. // Serialization and Database constructors required by Dynamix
  13. protected WideTemplate( SerializationInfo info, StreamingContext context ) :
  14. base( info, context ) {}
  15. protected WideTemplate( Dynamix.ObjectID id ) : base( id ) {}
  17. public WideTemplate() : base()
  18. {
  19. // Add components...
  20. }
  22. public override string Url
  23. {
  24. get { return "/Templates/Wide.aspx"; }
  25. }
  27. public override string Name
  28. {
  29. get { return "Bred sida"; }
  30. }
  32. // Instance method for easy access from code
  33. public static WideTemplate Instance
  34. {
  35. get { return (WideTemplate)Dynamix.Object.GetInstance( typeof( WideTemplate ) ); }
  36. }
  38. }
  39. }

Attributet [Dynamix.Definitions.Template] definierar mallen för Dynamix. Den kan därmed installeras från Dynamix administrationsgränssnitt. Läs mer om definitionsattribut här.

Deklarera innehåll

I konstruktorn kan en eller flera komponenter läggas till. Dessa översätts sedan till sidkomponenter och kopieras ut till de sidor som bygger på mallen. Den överlägset vanligaste komponenten är FlowLayoutTemplateComponent som definierar en sektion med dynamiskt innehåll (text och innehållsobjekt).

Exempel:

  1. C#
  1. ...
  2. FlowLayoutTemplateComponent main =
  3. new FlowLayoutTemplateComponent( "Main", MySite.TextStyles.Normal );
  4. Components.Add( main );
  5. ...

Det är också möjligt att styra vilka innehållstyper som redaktörerna får använda i de dynamiska sektionerna. Detta görs genom att lägga till objekt i sektionens egenskap AllowedContentTypes.

Exempel:

  1. C#
  1. ...
  2. FlowLayoutTemplateComponent main =
  3. new FlowLayoutTemplateComponent( "Main", MySite.TextStyles.Normal );
  4. main.AllowedContentTypes.Add(
  5. Dynamix.Content.ImageElements.ImageContentType.ContentType
  6. );
  7. Components.Add( main );
  8. ...

Det går också att skapa komponenter som bara innehåller ett enda innehållsobjekt, exempelvis en bild eller en nyhetslista.

Exempel:

  1. C#
  1. ...
  2. ContentTemplateComponent image =
  3. new ContentTemplateComponent(
  4. "Image",
  5. Dynamix.Content.ImageElements.ImageContentType.ContentType
  6. );
  7. ...

Skapa nya mallar - steg för steg

  • Skapa ett nytt Web-formulär från Visual Studio

  • Ändra arvet i code-behind-filen från System.Web.UI.Page till Dynamix.UI.ContentPage

  • Definiera mallen enligt ovan. Implementera Url till att returnera sökvägen till formuläret.

  • Kompilera om och använd mallverktyget för att installera mallen.

Presentation av information

Den aspx-sida som presenterar mallen ska ärva från Dynamix.UI.ContentPage. Dynamiskt innehåll kan placeras på sidan genom deklararera (dra från toolboxen eller direkt i kod) en eller flera sektioner (Dynamix.Content.Controls.Section). Sektionernas namn anges till motsvarande de FlowLayoutTemplateComponents som deklarerats i mallen.

Läs mer

  • Guidelines för framtagning av mallar

  • Delade innehållssektioner