Typography and surfaces

Text styles

The text styles

The type is Segoe UI at 14px for body text and controls. The text styles are keyed TextBlock styles; the sizes are resources, so a whole app can scale them.

Style Size / weight For
Nocturne.Styles.TextBlock.Title 30 / SemiBold Page titles
Nocturne.Styles.TextBlock.Subtitle 20 / SemiBold Sections, dialog titles
Nocturne.Styles.TextBlock.Eyebrow 12 / Bold Section labels above a group, written in capitals (as on cards)
Nocturne.Styles.TextBlock.ListTitle 16 / Medium The first line of a list item
Nocturne.Styles.TextBlock.Body 14 Paragraphs
Nocturne.Styles.TextBlock.Label 13 / Medium Labels above fields
Nocturne.Styles.TextBlock.Caption 13, secondary colour The second line of a list item, descriptions
Nocturne.Styles.TextBlock.Hint 12, hint colour Help text under a field
Nocturne.Styles.TextBlock.Error 12, red The message under an invalid field
Nocturne.Styles.TextBlock.Mono 11, monospaced Codes, keys, values
Size key  
Nocturne.Font.Size.Title 30
Nocturne.Font.Size.Subtitle 20
Nocturne.Font.Size.ListTitle 16
Nocturne.Font.Size.Default 14
Nocturne.Font.Size.Caption 13
Nocturne.Font.Size.Small 12
Nocturne.Font.Size.Tag 11

The text colours are Nocturne.Brushes.Text (primary), .Secondary, .Label, .Hint and .Placeholder. To use another font, see Theme and accents.

Cards

A card, pills, a tag, a badge and icon tiles

A card is the surface a group of controls sits on: Nocturne.Brushes.Surface1 with a 1px border, 14px corners and 20px padding. Nocturne.Styles.Card is a HeaderedContentControl with a section label (Header) and an optional tag on the right (Tag); Nocturne.Styles.Border.Card is the same surface as a plain Border.

<HeaderedContentControl Style="{StaticResource Nocturne.Styles.Card}" Header="SYNCHRONISATION" Tag="Beta">
    <StackPanel>...</StackPanel>
</HeaderedContentControl>

<Border Style="{StaticResource Nocturne.Styles.Border.Card}">...</Border>

Tags, pills and badges

All three are ContentControl styles.

Style  
Nocturne.Styles.Tag A small outlined label in monospaced text, as on the cards
Nocturne.Styles.Pill A rounded status label, green (.Success is the same); .Warning amber and .Error red
Nocturne.Styles.Badge A small round count in amber, as on the document tabs
<ContentControl Style="{StaticResource Nocturne.Styles.Pill.Warning}" Content="Invited" />
<ContentControl Style="{StaticResource Nocturne.Styles.Tag}" Content="ListBox · ListBoxItem" />

Icon tiles

Nocturne.Styles.IconTile (42×42) and Nocturne.Styles.IconTile.Small (36×36) put an icon on a small rounded surface, as in lists and the side navigation. In a selected ListBoxItem the tile fills with the accent.

<ContentControl Style="{StaticResource Nocturne.Styles.IconTile}">
    <nc:StrokeIcon Data="{StaticResource Nocturne.Icons.Shield}" />
</ContentControl>

Icons

The icons

nc:StrokeIcon draws a line icon on a 24×24 grid with round ends, in its Foreground. The theme’s icons are the Nocturne.Icons.* geometries above (drawn for Nocturne, MIT); any path data in 24×24 units works too.

<nc:StrokeIcon Width="20" Height="20" Data="{StaticResource Nocturne.Icons.Folder}" />
<nc:StrokeIcon Width="16" Height="16" StrokeThickness="2" Data="M5,12 L19,12" />
Property  
Data The outline in 24×24 units
StrokeThickness Line width in 24×24 units; it scales with the icon
Foreground The colour (inherited, so an icon in a button takes the button’s text colour)

Templates with room for an icon read ControlHelper.Icon (menu items, AutoSuggestBox), so they take the same geometries.

NocturneIcon

Material Design icons alone, on icon buttons and on a primary button

nc:NocturneIcon draws one of a set of Material Design Icons by Pictogrammers, filled, in its Foreground, 20×20 by default. Kind takes the icon’s name as MahApps’ IconBrowser shows it (view-grid is ViewGrid). Use these for an app’s own icons (navigation, commands, status); the line icons above stay for the theme’s templates.

<nc:NocturneIcon Kind="Bell" />
<nc:NocturneIcon Kind="AccountMultiple" Width="16" Height="16" Foreground="{DynamicResource Nocturne.Brushes.Accent.Light}" />

Two markup extensions, IconExtension and IconGeometryExtension, save the element around it:

Markup Gives For
{nc:Icon ContentSave} a new NocturneIcon (Size=18 sets width and height) Icon of a MenuItem or HamburgerMenuItem, Content of an icon button
{nc:IconGeometry Star} the icon’s frozen geometry in 24×24 units, filled Data of a Path, a GeometryDrawing
<Button Style="{StaticResource Nocturne.Styles.Button.Icon}" Content="{nc:Icon Refresh, Size=18}" ToolTip="Refresh" />
<MenuItem Header="Save" Icon="{nc:Icon ContentSave}" InputGestureText="Ctrl+S" />
<Path Width="20" Height="20" Stretch="Uniform" Data="{nc:IconGeometry Star}" Fill="{DynamicResource Nocturne.Brushes.Warning}" />

{nc:Icon} makes one element, and an element can only have one parent: in a Style setter, where one value is shared by every control, put a NocturneIcon in a template instead. Menu items scale an icon larger than their 16px slot down to fit.

The demo's Icons page

The demo’s Icons page shows every icon with its name; click one to copy its XAML. The set is listed in icons/icons.json in the repository; to add an icon, put its MDI name there and run python tools/generate_icons.py --fetch, which downloads the SVG and regenerates NocturneIconKind.

Property  
Kind The icon (NocturneIconKind; None draws nothing)
Data Read-only: the icon’s geometry in 24×24 units (NocturneIcon.GeometryOf(kind) from code)
Foreground The colour (inherited)

The icons are licensed under the Apache License 2.0, the rest of Nocturne under MIT; the package’s licence is MIT AND Apache-2.0 and it carries both licences and a NOTICE.md.