diff --git a/images/ui/typography/typography_example_1.png b/images/ui/typography/typography_example_1.png new file mode 100644 index 00000000000..68c4fa47c54 Binary files /dev/null and b/images/ui/typography/typography_example_1.png differ diff --git a/images/ui/typography/typography_example_1_dark.png b/images/ui/typography/typography_example_1_dark.png new file mode 100644 index 00000000000..b1bd74e41fb Binary files /dev/null and b/images/ui/typography/typography_example_1_dark.png differ diff --git a/images/ui/typography/typography_example_2.png b/images/ui/typography/typography_example_2.png new file mode 100644 index 00000000000..497623af992 Binary files /dev/null and b/images/ui/typography/typography_example_2.png differ diff --git a/images/ui/typography/typography_example_2_dark.png b/images/ui/typography/typography_example_2_dark.png new file mode 100644 index 00000000000..afcbc3e67b4 Binary files /dev/null and b/images/ui/typography/typography_example_2_dark.png differ diff --git a/images/ui/typography/typography_example_4.png b/images/ui/typography/typography_example_4.png new file mode 100644 index 00000000000..08a8b10f376 Binary files /dev/null and b/images/ui/typography/typography_example_4.png differ diff --git a/images/ui/typography/typography_example_4_dark.png b/images/ui/typography/typography_example_4_dark.png new file mode 100644 index 00000000000..618f8684206 Binary files /dev/null and b/images/ui/typography/typography_example_4_dark.png differ diff --git a/images/ui/typography/typography_example_5.png b/images/ui/typography/typography_example_5.png new file mode 100644 index 00000000000..7dca62954ae Binary files /dev/null and b/images/ui/typography/typography_example_5.png differ diff --git a/images/ui/typography/typography_example_5_dark.png b/images/ui/typography/typography_example_5_dark.png new file mode 100644 index 00000000000..58d3f5e74d3 Binary files /dev/null and b/images/ui/typography/typography_example_5_dark.png differ diff --git a/topics/ui/principles/typography.md b/topics/ui/principles/typography.md index 06fb06f9c7a..88326d9913d 100644 --- a/topics/ui/principles/typography.md +++ b/topics/ui/principles/typography.md @@ -10,11 +10,11 @@ -## IDE font +## UI font -The system fonts are used for the IDE user interface by default. The default font sizes are below: +[Inter](https://github.com/rsms/inter) is used for the IDE user interface by default. The default font size is the same for all supported OS: 13. - + -Users can change the default font size in Settings. If the default font size is changed, other font sizes used in the UI are scaled respectively. +Users can change the default font in Settings | Appearance. If the default font size is changed, other font sizes used in the UI are scaled respectively. Use the built-in text styles from the table below whenever possible. @@ -49,63 +48,34 @@ Use the built-in text styles from the table below whenever possible. - - - - - - - - - - - - - - - - - - - - + + - - + + - - - - - - - + - + @@ -113,7 +83,7 @@ Use the built-in text styles from the table below whenever possible. + - - - + + - - - - - -
Usage Examples
H0 bold

JBFont.h0().asBold()

Default + 12 - Rich text headers. See the "What’s New" page example below. -
H1 bold

JBFont.h1().asBold()

Default + 9
H2

JBFont.h2()

Default + 5
H2 bold

JBFont.h2().asBold()

H1

JBFont.h1().asBold()

Default +5 - Small page header. Examples: Plugin name, GitHub timeline header + Main page header. Example: Plugin name
H3

JBFont.h3()

Default + 3 H2

JBFont.h2().asBold()

Default +3 - Accent body text + Small page header. Example: Headers in a plugin description
H3 bold

JBFont.h3().asBold()

- Headers in dialogs with a small number of elements (Customize page on Welcome screen, Login page in Get from VCS dialog) -
H4 bold (Default bold)

JBFont.h4().asBold()

JBFont.regular().asBold()

Default

JBFont.regular()

Default -

Header in dialogs with a large number of elements (Run configurations dialog), notification header, breadcrumbs in settings, header in navigation popup, accent elements in lists and trees.

-

Use Group header to divide the page on groups, but not to draw too much attention to the headings.

+ Main UI font. Examples: Labels, inputs, links, trees, tables, and other controls
Default

JBFont.regular()

Default semibold

JBFont.regular().asBold()

Default - Labels, inputs, links, trees, tables and other controls; text outputs, notifications, shortcuts +

Header in dialogs, popups, notifications, tool windows, Got It tooltips

Paragraph

Default

-

Line height default + 3

+

Line height default +3

Multiline description text @@ -122,62 +92,66 @@ Use the built-in text styles from the table below whenever possible.
Medium

JBFont.medium()

Default –1 -

macOS: Default - 1

-

Win: Default

-

Linux: Default - 1

-
- Tool window header, navigation bar, editor breadcrumbs, editor tabs (small on macOS) + Help text
Medium bold

JBFont.medium().asBold()

Medium semibold

JBFont.medium().asBold()

Default –1 - Module in the navigation bar -
Small

JBFont.small()

-

macOS: Default - 2

-

Win: Default

-

Linux: Default - 2

-
- Status bar, tool window buttons, inline help, help text in tooltips, separators in lists + Group headers in popups
If none of the built-in sizes work and a custom one is needed, define it as the default size +/- constant value. Do **not** hardcode font sizes. -Use the underlined text style for hovered links. +### Examples in UI + +Run popup: + +![](typography_example_1.png){width=706} + +Plugin page: + +![](typography_example_2.png){width=706} ## Editor font -JetBrains Mono font is used by default for the Editor. +[JetBrains Mono](https://fonts.google.com/specimen/JetBrains+Mono) font is used by default for the Editor. - - + + - + - - + +
Name Font size
Name Font size Usage
Default Default Editor Code in the editor, code snippets, completion popup, and documentation popup
Small Default - 1 Line number Default –1 Line number in the editor
-## Colors +Users can change the editor font in Editor | Color scheme | Color Scheme Font. If the default font size is changed, other font sizes used in the editor are scaled respectively. + +### Examples in editor + +Line numbers in the gutter and code in the editor: + +![](typography_example_4.png){width=706} + +Editor font and paragraph UI font in the documentation popup: + +![](typography_example_5.png){width=706} + +