API Reference
Class
EmailBox
Represents a content box container for email layouts. Provides email-compatible styling with background colors, borders, and shadows.
Inheritance
- EmailContainer
- EmailBox
Constructors
EmailBox 2 overloads
Methods
Add(System.Action{HtmlForgeX.Email.BasicElement} config) #Adds content to the box using a configuration action.
Parameters
- config System.Action{HtmlForgeX.Email.BasicElement}
- The configuration action for the content.
Returns
The EmailBox object, allowing for method chaining.
public EmailBox CenterWithMargin(String verticalMargin = "24px") #Returns:
EmailBoxCenters the box with specific horizontal margins.
Parameters
- verticalMargin System.String = "24px"
- The vertical margin (top and bottom).
Returns
The EmailBox object, allowing for method chaining.
public EmailBox DisableBoxShadow() #Returns:
EmailBoxDisables the box shadow.
Returns
The EmailBox object, allowing for method chaining.
public override Void EvaluateLayout(LayoutContext context) #Returns:
VoidCalculates default border radius based on rounding mode and configuration.
Parameters
- context HtmlForgeX.Email.LayoutContext
- Layout evaluation context.
public String GetThemeBackgroundColor() #Returns:
StringGets the appropriate background color based on theme mode.
public String GetThemeBorderColor() #Returns:
StringGets the appropriate border color based on theme mode.
RenderHtml(System.Text.StringBuilder sb) #Renders the EmailBox and its children. When nested inside another EmailBox, a wrapper table is only rendered when explicitly requested via UseWrapper.
Parameters
- sb System.Text.StringBuilder
- The StringBuilder to append HTML to.
WithBackground 2 overloads
public virtual EmailBox WithBackground(RGBColor color) #Returns:
EmailBoxSets the background color of the box.
Parameters
- color System.String
- The background color.
Returns
The EmailBox object, allowing for method chaining.
WithBackground(HtmlForgeX.Email.RGBColor color) #Sets the background color of the box.
Parameters
- color HtmlForgeX.Email.RGBColor
- The background color.
Returns
The EmailBox object, allowing for method chaining.
WithBackgroundColor 2 overloads
public EmailBox WithBackgroundColor(RGBColor color) #Returns:
EmailBoxSets the background color of the box.
Parameters
- color System.String
- The background color.
Returns
This instance for method chaining.
WithBackgroundColor(HtmlForgeX.Email.RGBColor color) #Sets the background color of the box using RGBColor.
Parameters
- color HtmlForgeX.Email.RGBColor
- The background color.
Returns
This instance for method chaining.
WithBorder 2 overloads
public virtual EmailBox WithBorder(BorderWidth width = Thin, String customValue = null) #Returns:
EmailBoxSets the border width using a predefined size.
Parameters
- width HtmlForgeX.Email.BorderWidth = Thin
- The border width size.
- customValue System.String = null
- Custom value when using BorderWidth.Custom.
Returns
This instance for method chaining.
public virtual EmailBox WithBorder(Boolean enabled) #Returns:
EmailBoxEnables or disables borders for the box.
Parameters
- enabled System.Boolean
Returns
This instance for method chaining.
WithBorderColor 2 overloads
public virtual EmailBox WithBorderColor(RGBColor color) #Returns:
EmailBoxSets the border color of the box.
Parameters
- color System.String
- The border color.
Returns
The EmailBox object, allowing for method chaining.
WithBorderColor(HtmlForgeX.Email.RGBColor color) #Sets the border color of the box using RGBColor.
Parameters
- color HtmlForgeX.Email.RGBColor
- The border color.
Returns
The EmailBox object, allowing for method chaining.
public virtual EmailBox WithBorderRadius(String radius) #Returns:
EmailBoxSets the border radius of the box.
Parameters
- radius System.String
- The border radius value.
Returns
The EmailBox object, allowing for method chaining.
public EmailBox WithBorderStyle(BorderWidth width = Thin, String color = null, Radius radius = Medium) #Returns:
EmailBoxSets the border style with width, color, and radius.
Parameters
- width HtmlForgeX.Email.BorderWidth = Thin
- The border width.
- color System.String = null
- The border color.
- radius HtmlForgeX.Email.Radius = Medium
- The border radius.
Returns
This instance for method chaining.
public EmailBox WithMaxWidth(String maxWidth) #Returns:
EmailBoxSets the maximum width of the box.
Parameters
- maxWidth System.String
- The maximum width value.
Returns
The EmailBox object, allowing for method chaining.
WithRounded 2 overloads
public virtual EmailBox WithRounded(Radius radius = Medium, String customValue = null) #Returns:
EmailBoxSets the border radius using a predefined size.
Parameters
- radius HtmlForgeX.Email.Radius = Medium
- The border radius size.
- customValue System.String = null
- Custom value when using Custom.
Returns
This instance for method chaining.
public virtual EmailBox WithRounded() #Returns:
EmailBoxApplies the default border radius (6px) for rounded corners.
Returns
This instance for method chaining.
public virtual EmailBox WithRoundingMode(RoundingMode mode) #Returns:
EmailBoxSets the rounding mode for this box.
Parameters
- mode HtmlForgeX.Email.RoundingMode
- Rounding mode.
Returns
The box instance.
public EmailBox WithShadow(Boolean enabled = true) #Returns:
EmailBoxEnables or disables the box shadow.
Parameters
- enabled System.Boolean = true
- Whether to include box shadow.
Returns
This instance for method chaining.
WithSpacing 2 overloads
public EmailBox WithSpacing(EmailSpacing spacing) #Returns:
EmailBoxSets the spacing around the box using semantic sizing.
Parameters
- spacing HtmlForgeX.Email.EmailSpacing
- The spacing size to apply.
Returns
This instance for method chaining.
public EmailBox WithSpacing(EmailSpacing above, EmailSpacing below) #Returns:
EmailBoxSets different spacing above and below the box.
Parameters
- above HtmlForgeX.Email.EmailSpacing
- The spacing size above.
- below HtmlForgeX.Email.EmailSpacing
- The spacing size below.
Returns
This instance for method chaining.
public EmailBox WithStructuralMode(Boolean enabled) #Returns:
EmailBoxEnables or disables structural mode. When enabled, the box renders as a simple table without visual styling. When disabled, full visual styling is applied.
Parameters
- enabled System.Boolean
- Whether structural mode should be enabled.
Returns
The EmailBox object, allowing for method chaining.
Inherited Methods
public override Element Add(Element element) #Returns:
ElementInherited from Element
Adds an element to the box.
Parameters
- element HtmlForgeX.Email.Element
- The element to add.
Returns
The EmailBox object, allowing for method chaining.
public override Element AddCssClass(String cssClass) #Returns:
ElementInherited from Element
Parameters
- cssClass String
public EmailActivityList EmailActivityList() #Returns:
EmailActivityListInherited from Element
Parameters
- config Action<EmailActivityList>
public EmailAddressBlock EmailAddressBlock() #Returns:
EmailAddressBlockInherited from Element
Parameters
- config Action<EmailAddressBlock>
public EmailAddressCard EmailAddressCard() #Returns:
EmailAddressCardInherited from Element
Parameters
- config Action<EmailAddressCard>
public EmailAlert EmailAlert(EmailAlertType type, String title, String message = "") #Returns:
EmailAlertInherited from Element
Parameters
- config Action<EmailAlert>
public EmailArticleCard EmailArticleCard() #Returns:
EmailArticleCardInherited from Element
Parameters
- config Action<EmailArticleCard>
public EmailArticleList EmailArticleList() #Returns:
EmailArticleListInherited from Element
Parameters
- config Action<EmailArticleList>
public EmailAttachmentList EmailAttachmentList() #Returns:
EmailAttachmentListInherited from Element
Parameters
- config Action<EmailAttachmentList>
public EmailAvatar EmailAvatar(String initials, String size = "40px") #Returns:
EmailAvatarInherited from Element
Parameters
- config Action<EmailAvatar>
public EmailAvatarStack EmailAvatarStack() #Returns:
EmailAvatarStackInherited from Element
Parameters
- config Action<EmailAvatarStack>
public EmailBackgroundImageBox EmailBackgroundImageBox() #Returns:
EmailBackgroundImageBoxInherited from Element
Parameters
- config Action<EmailBackgroundImageBox>
public EmailBadge EmailBadge(String text, String backgroundColor = "#64748B", String color = "#FFFFFF") #Returns:
EmailBadgeInherited from Element
Parameters
- config Action<EmailBadge>
public EmailBadgeList EmailBadgeList() #Returns:
EmailBadgeListInherited from Element
Parameters
- config Action<EmailBadgeList>
public EmailBarChart EmailBarChart() #Returns:
EmailBarChartInherited from Element
Parameters
- config Action<EmailBarChart>
public EmailBarcode EmailBarcode(String value) #Returns:
EmailBarcodeInherited from Element
Parameters
- config Action<EmailBarcode>
public Element EmailBlockquote(Action<EmailBlockquote> config) #Returns:
ElementInherited from Element
Parameters
- content String = ""
public Element EmailBox(Action<EmailBox> config) #Returns:
ElementInherited from Element
Parameters
- config Action<EmailBox>
public Element EmailBoxWithBuilder(Action<EmailBoxBuilder> config) #Returns:
ElementInherited from Element
Parameters
- config Action<EmailBoxBuilder>
public EmailBrandStrip EmailBrandStrip() #Returns:
EmailBrandStripInherited from Element
Parameters
- config Action<EmailBrandStrip>
public Element EmailButton(Action<EmailButton> config) #Returns:
ElementInherited from Element
Parameters
- config Action<EmailButton>
public EmailButtonGroup EmailButtonGroup() #Returns:
EmailButtonGroupInherited from Element
Parameters
- config Action<EmailButtonGroup>
public EmailCalendar EmailCalendar() #Returns:
EmailCalendarInherited from Element
Parameters
- config Action<EmailCalendar>
public EmailCalloutCard EmailCalloutCard() #Returns:
EmailCalloutCardInherited from Element
Parameters
- config Action<EmailCalloutCard>
public EmailChangelog EmailChangelog() #Returns:
EmailChangelogInherited from Element
Parameters
- config Action<EmailChangelog>
public Element EmailColumn(Action<EmailColumn> config) #Returns:
ElementInherited from Element
Parameters
- config Action<EmailColumn>
public EmailCommentList EmailCommentList() #Returns:
EmailCommentListInherited from Element
Parameters
- config Action<EmailCommentList>
public EmailComparisonTable EmailComparisonTable() #Returns:
EmailComparisonTableInherited from Element
Parameters
- config Action<EmailComparisonTable>
public Element EmailContent(Action<EmailContent> config) #Returns:
ElementInherited from Element
Parameters
- config Action<EmailContent>
public EmailCredentialCard EmailCredentialCard() #Returns:
EmailCredentialCardInherited from Element
Parameters
- config Action<EmailCredentialCard>
public EmailDateStrip EmailDateStrip() #Returns:
EmailDateStripInherited from Element
Parameters
- config Action<EmailDateStrip>
public Element EmailDivider(Action<EmailDivider> config) #Returns:
ElementInherited from Element
Parameters
- config Action<EmailDivider>
public EmailDnsRecordsTable EmailDnsRecordsTable() #Returns:
EmailDnsRecordsTableInherited from Element
Parameters
- config Action<EmailDnsRecordsTable>
public EmailDonutChart EmailDonutChart() #Returns:
EmailDonutChartInherited from Element
Parameters
- config Action<EmailDonutChart>
public EmailDownloadCard EmailDownloadCard() #Returns:
EmailDownloadCardInherited from Element
Parameters
- config Action<EmailDownloadCard>
public EmailEmojiRating EmailEmojiRating() #Returns:
EmailEmojiRatingInherited from Element
Parameters
- config Action<EmailEmojiRating>
public EmailEmptyStateCard EmailEmptyStateCard() #Returns:
EmailEmptyStateCardInherited from Element
Parameters
- config Action<EmailEmptyStateCard>
public EmailEventCard EmailEventCard() #Returns:
EmailEventCardInherited from Element
Parameters
- config Action<EmailEventCard>
public EmailFaqList EmailFaqList() #Returns:
EmailFaqListInherited from Element
Parameters
- config Action<EmailFaqList>
public EmailFeatureList EmailFeatureList() #Returns:
EmailFeatureListInherited from Element
Parameters
- config Action<EmailFeatureList>
public Element EmailHeading(Action<EmailHeading> config) #Returns:
ElementInherited from Element
Parameters
- content String = ""
- level Int32 = 2
public EmailHeatmap EmailHeatmap() #Returns:
EmailHeatmapInherited from Element
Parameters
- config Action<EmailHeatmap>
public EmailHero EmailHero() #Returns:
EmailHeroInherited from Element
Parameters
- config Action<EmailHero>
public EmailIconCircle EmailIconCircle() #Returns:
EmailIconCircleInherited from Element
Parameters
- config Action<EmailIconCircle>
public EmailImage EmailImage(String source, String width) #Returns:
EmailImageInherited from Element
Parameters
- config Action<EmailImage>
public EmailIncidentSummaryCard EmailIncidentSummaryCard() #Returns:
EmailIncidentSummaryCardInherited from Element
Parameters
- config Action<EmailIncidentSummaryCard>
public EmailInlineStack EmailInlineStack() #Returns:
EmailInlineStackInherited from Element
Parameters
- config Action<EmailInlineStack>
public EmailInvoiceLineItemsTable EmailInvoiceLineItemsTable() #Returns:
EmailInvoiceLineItemsTableInherited from Element
Parameters
- config Action<EmailInvoiceLineItemsTable>
public EmailInvoiceTotals EmailInvoiceTotals() #Returns:
EmailInvoiceTotalsInherited from Element
Parameters
- config Action<EmailInvoiceTotals>
public EmailKeyValueTable EmailKeyValueTable() #Returns:
EmailKeyValueTableInherited from Element
Parameters
- config Action<EmailKeyValueTable>
public EmailKpiDelta EmailKpiDelta() #Returns:
EmailKpiDeltaInherited from Element
Parameters
- config Action<EmailKpiDelta>
public EmailLineBreak EmailLineBreak(String height) #Returns:
EmailLineBreakInherited from Element
Parameters
- height String
public EmailLineItemsTable EmailLineItemsTable() #Returns:
EmailLineItemsTableInherited from Element
Parameters
- config Action<EmailLineItemsTable>
public Element EmailLink(Action<EmailLink> config) #Returns:
ElementInherited from Element
Parameters
- content String
- href String
public Element EmailList(Action<EmailList> config) #Returns:
ElementInherited from Element
Parameters
- config Action<EmailList>
public EmailMapCard EmailMapCard() #Returns:
EmailMapCardInherited from Element
Parameters
- config Action<EmailMapCard>
public EmailMediaObject EmailMediaObject() #Returns:
EmailMediaObjectInherited from Element
Parameters
- config Action<EmailMediaObject>
public EmailMessageThread EmailMessageThread() #Returns:
EmailMessageThreadInherited from Element
Parameters
- config Action<EmailMessageThread>
public EmailMetricTile EmailMetricTile(String value, String label, String icon = "") #Returns:
EmailMetricTileInherited from Element
Parameters
- config Action<EmailMetricTile>
public EmailNpsRating EmailNpsRating() #Returns:
EmailNpsRatingInherited from Element
Parameters
- config Action<EmailNpsRating>
public EmailOfferCard EmailOfferCard() #Returns:
EmailOfferCardInherited from Element
Parameters
- config Action<EmailOfferCard>
public EmailOtpCode EmailOtpCode(String code) #Returns:
EmailOtpCodeInherited from Element
Parameters
- config Action<EmailOtpCode>
public EmailPhotoCard EmailPhotoCard() #Returns:
EmailPhotoCardInherited from Element
Parameters
- config Action<EmailPhotoCard>
public EmailPhotoGrid EmailPhotoGrid() #Returns:
EmailPhotoGridInherited from Element
Parameters
- config Action<EmailPhotoGrid>
public EmailPricingTable EmailPricingTable() #Returns:
EmailPricingTableInherited from Element
Parameters
- config Action<EmailPricingTable>
public EmailProductCard EmailProductCard() #Returns:
EmailProductCardInherited from Element
Parameters
- config Action<EmailProductCard>
public EmailProductGrid EmailProductGrid() #Returns:
EmailProductGridInherited from Element
Parameters
- config Action<EmailProductGrid>
public EmailProfileCard EmailProfileCard() #Returns:
EmailProfileCardInherited from Element
Parameters
- config Action<EmailProfileCard>
public EmailProgressBar EmailProgressBar(Int32 value) #Returns:
EmailProgressBarInherited from Element
Parameters
- config Action<EmailProgressBar>
public EmailProjectList EmailProjectList() #Returns:
EmailProjectListInherited from Element
Parameters
- config Action<EmailProjectList>
public EmailPromoCodeCard EmailPromoCodeCard() #Returns:
EmailPromoCodeCardInherited from Element
Parameters
- config Action<EmailPromoCodeCard>
public EmailQrCode EmailQrCode(String value) #Returns:
EmailQrCodeInherited from Element
Parameters
- config Action<EmailQrCode>
public EmailReceiptCard EmailReceiptCard() #Returns:
EmailReceiptCardInherited from Element
Parameters
- config Action<EmailReceiptCard>
public EmailRepoStatsCard EmailRepoStatsCard() #Returns:
EmailRepoStatsCardInherited from Element
Parameters
- config Action<EmailRepoStatsCard>
public EmailReviewStars EmailReviewStars() #Returns:
EmailReviewStarsInherited from Element
Parameters
- config Action<EmailReviewStars>
public EmailReviewSummary EmailReviewSummary() #Returns:
EmailReviewSummaryInherited from Element
Parameters
- config Action<EmailReviewSummary>
public Element EmailRow(Action<EmailRow> config) #Returns:
ElementInherited from Element
Parameters
- config Action<EmailRow>
public EmailScheduleCard EmailScheduleCard() #Returns:
EmailScheduleCardInherited from Element
Parameters
- config Action<EmailScheduleCard>
public EmailScheduleList EmailScheduleList() #Returns:
EmailScheduleListInherited from Element
Parameters
- config Action<EmailScheduleList>
public EmailShippingProgress EmailShippingProgress() #Returns:
EmailShippingProgressInherited from Element
Parameters
- config Action<EmailShippingProgress>
public EmailSocialLinks EmailSocialLinks() #Returns:
EmailSocialLinksInherited from Element
Parameters
- config Action<EmailSocialLinks>
public Element EmailSpacer(Action<EmailSpacer> config) #Returns:
ElementInherited from Element
Parameters
- height String
public EmailSparklineBars EmailSparklineBars(params Int32[] values) #Returns:
EmailSparklineBarsInherited from Element
Parameters
- config Action<EmailSparklineBars>
public EmailStatCard EmailStatCard(String title, String value, String subtitle = "", String delta = "", EmailTrendDirection trend = Neutral) #Returns:
EmailStatCardInherited from Element
Parameters
- config Action<EmailStatCard>
public EmailStatusTimeline EmailStatusTimeline() #Returns:
EmailStatusTimelineInherited from Element
Parameters
- config Action<EmailStatusTimeline>
public EmailStepsIndicator EmailStepsIndicator() #Returns:
EmailStepsIndicatorInherited from Element
Parameters
- config Action<EmailStepsIndicator>
public EmailStoreBadges EmailStoreBadges() #Returns:
EmailStoreBadgesInherited from Element
Parameters
- config Action<EmailStoreBadges>
public EmailSubscriptionSummaryCard EmailSubscriptionSummaryCard() #Returns:
EmailSubscriptionSummaryCardInherited from Element
Parameters
- config Action<EmailSubscriptionSummaryCard>
public EmailSurveyOptions EmailSurveyOptions() #Returns:
EmailSurveyOptionsInherited from Element
Parameters
- config Action<EmailSurveyOptions>
public Element EmailTable<T>(IEnumerable<T> data, Action<EmailDynamicTable<T>> config) #Returns:
ElementInherited from Element
Type Parameters
- T
Parameters
- config Action<EmailTable>
public Element EmailText(Action<EmailText> config) #Returns:
ElementInherited from Element
Parameters
- content String = ""
public EmailTextBlock EmailTextBlock() #Returns:
EmailTextBlockInherited from Element
Parameters
- config Action<EmailTextBlock>
public EmailTodoList EmailTodoList() #Returns:
EmailTodoListInherited from Element
Parameters
- config Action<EmailTodoList>
public override Boolean Equals(Object obj) #Returns:
BooleanInherited from Object
Parameters
- obj Object
public override Element WithCssClass(String cssClass) #Returns:
ElementInherited from Element
Parameters
- cssClass String
public override Element WithMargin(String margin) #Returns:
ElementInherited from Element
Parameters
- margin String
public override Element WithPadding(String padding) #Returns:
ElementInherited from Element
Sets the padding of the box.
Parameters
- padding System.String
- The padding value.
Returns
The EmailBox object, allowing for method chaining.
public EmailContainer WithSpacingMode(SpacingMode mode) #Returns:
EmailContainerInherited from EmailContainer
Sets the spacing mode for child elements.
Parameters
- mode HtmlForgeX.Email.SpacingMode
- Spacing mode.
Returns
This instance for chaining.
Properties
public virtual String BackgroundColor { get; set; } #Gets or sets the background color of the box.
public virtual String BorderRadius { get; set; } #Gets or sets the border radius of the box.
public virtual RoundingMode RoundingMode { get; set; } #Gets or sets how border radius should be applied.
public virtual String BorderColor { get; set; } #Gets or sets the border color of the box.
public virtual String BorderWidth { get; set; } #Gets or sets the border width of the box.
public Boolean IncludeBoxShadow { get; set; } #Gets or sets whether to include box shadow.
public String BoxShadow { get; set; } #Gets or sets the box shadow CSS.
public String InlineStyle { get; set; } #Gets or sets additional inline styles.
public Boolean UseConsistentSpacing { get; set; } #Gets or sets whether to use consistent spacing between elements. When true, applies consistent vertical spacing between child elements.
public String ChildSpacing { get; set; } #Gets or sets the spacing between child elements.
public String OuterMargin { get; set; } #Gets or sets the outer margin around the entire box.
public String MaxWidth { get; set; } #Gets or sets the maximum width of the box. If not explicitly set, uses the email's configured layout width.
public Boolean StructuralMode { get; set; } #Gets or sets whether to use structural mode (no visual styling). When true, renders as a simple table structure without borders, shadows, or background. Perfect for headers, footers, or when you just need layout structure.
public Boolean UseWrapper { get; set; } #Gets or sets whether this box should render its own table wrapper when nested inside another EmailBox.
public override String Padding { get; set; } #Inherited Properties
public override sealed SpacingMode SpacingMode { get; set; } #Inherited from EmailContainer
Extension Methods
public static EmailBox WithMargin(EmailBox box, EmailSpacing all) #Returns:
EmailBoxSets a uniform margin on an EmailBox using a typed spacing value.
Parameters
- box HtmlForgeX.Email.EmailBox
- Target container.
- all HtmlForgeX.Email.EmailSpacing
- Spacing applied to all sides.
WithPadding 3 overloads
public static EmailBox WithPadding(EmailBox box, EmailSpacing all) #Returns:
EmailBoxSets uniform padding on an EmailBox using a typed spacing value.
Parameters
- box HtmlForgeX.Email.EmailBox
- Target container.
- all HtmlForgeX.Email.EmailSpacing
- Spacing applied to all sides.
public static EmailBox WithPadding(EmailBox box, EmailSpacing vertical, EmailSpacing horizontal) #Returns:
EmailBoxSets vertical and horizontal padding on an EmailBox using typed spacing values.
Parameters
- box HtmlForgeX.Email.EmailBox
- Target container.
- vertical HtmlForgeX.Email.EmailSpacing
- Top and bottom padding.
- horizontal HtmlForgeX.Email.EmailSpacing
- Left and right padding.
public static EmailBox WithPadding(EmailBox box, EmailSpacing top, EmailSpacing right, EmailSpacing bottom, EmailSpacing left) #Returns:
EmailBoxSets top/right/bottom/left padding on an EmailBox using typed spacing values.
Parameters
- box HtmlForgeX.Email.EmailBox
- Target container.
- top HtmlForgeX.Email.EmailSpacing
- Top padding.
- right HtmlForgeX.Email.EmailSpacing
- Right padding.
- bottom HtmlForgeX.Email.EmailSpacing
- Bottom padding.
- left HtmlForgeX.Email.EmailSpacing
- Left padding.