Interface: ITerminalOptions

An object containing start up options for the terminal.






<Optional> allowTransparency

● allowTransparency: boolean

Defined in xterm.d.ts:25

Whether background should support non-opaque color. It must be set before executing open() method and can’t be changed later without excuting it again. Warning: Enabling this option can reduce performances somewhat.

<Optional> bellSound

● bellSound: string

Defined in xterm.d.ts:30

A data uri of the sound to use for the bell (needs bellStyle = ‘sound’).

<Optional> bellStyle

● bellStyle: * “none” | “sound” *

Defined in xterm.d.ts:35

The type of the bell notification the terminal will use.

<Optional> cols

● cols: number

Defined in xterm.d.ts:40

The number of columns in the terminal.

● cursorBlink: boolean

Defined in xterm.d.ts:45

Whether the cursor blinks.

<Optional> cursorStyle

● cursorStyle: * “block” | “underline” | “bar” *

Defined in xterm.d.ts:50

The style of the cursor.

<Optional> disableStdin

● disableStdin: boolean

Defined in xterm.d.ts:55

Whether input should be disabled.

<Optional> drawBoldTextInBrightColors

● drawBoldTextInBrightColors: boolean

Defined in xterm.d.ts:60

Whether to draw bold text in bright colors. The default is true.

<Optional> enableBold

● enableBold: boolean

Defined in xterm.d.ts:67

Whether to enable the rendering of bold text. deprecated: Use fontWeight and fontWeightBold instead.

<Optional> experimentalCharAtlas

● experimentalCharAtlas: * “none” | “static” | “dynamic” *

Defined in xterm.d.ts:85

What character atlas implementation to use. The character atlas caches drawn characters, speeding up rendering significantly. However, it can introduce some minor rendering artifacts.

  • ‘none’: Don’t use an atlas.
  • ‘static’: Generate an atlas when the terminal starts or is reconfigured. This atlas will only contain ASCII characters in 16 colors.
  • ‘dynamic’: Generate an atlas using a LRU cache as characters are requested. Limited to ASCII characters (for now), but supports 256 colors. For characters covered by the static cache, it’s slightly slower in comparison, since there’s more overhead involved in managing the cache.

Currently defaults to ‘static’. This option may be removed in the future. If it is, passed parameters will be ignored.

<Optional> fontFamily

● fontFamily: string

Defined in xterm.d.ts:95

The font family used to render text.

<Optional> fontSize

● fontSize: number

Defined in xterm.d.ts:90

The font size used to render text.

<Optional> fontWeight

● fontWeight: FontWeight

Defined in xterm.d.ts:100

The font weight used to render non-bold text.

<Optional> fontWeightBold

● fontWeightBold: FontWeight

Defined in xterm.d.ts:105

The font weight used to render bold text.

<Optional> letterSpacing

● letterSpacing: number

Defined in xterm.d.ts:110

The spacing in whole pixels between characters..

<Optional> lineHeight

● lineHeight: number

Defined in xterm.d.ts:115

The line height used to render text.

<Optional> macOptionIsMeta

● macOptionIsMeta: boolean

Defined in xterm.d.ts:120

Whether to treat option as the meta key.

<Optional> rightClickSelectsWord

● rightClickSelectsWord: boolean

Defined in xterm.d.ts:126

Whether to select the word under the cursor on right click, this is standard behavior in a lot of macOS applications.

<Optional> rows

● rows: number

Defined in xterm.d.ts:131

The number of rows in the terminal.

<Optional> screenReaderMode

● screenReaderMode: boolean

Defined in xterm.d.ts:138

Whether screen reader support is enabled. When on this will expose supporting elements in the DOM to support NVDA on Windows and VoiceOver on macOS.

<Optional> scrollback

● scrollback: number

Defined in xterm.d.ts:144

The amount of scrollback in the terminal. Scrollback is the amount of rows that are retained when lines are scrolled beyond the initial viewport.

<Optional> tabStopWidth

● tabStopWidth: number

Defined in xterm.d.ts:149

The size of tab stops in the terminal.

<Optional> theme

● theme: ITheme

Defined in xterm.d.ts:154

The color theme of the terminal.