# ITextRun

- Human documentation: [https://docs.univer.ai/reference/types/text-run](https://docs.univer.ai/reference/types/text-run)

- Agent Markdown: [https://docs.univer.ai/reference/types/text-run.md](https://docs.univer.ai/reference/types/text-run.md)

- Requested language: `en-US`

- Content language: `en-US`

- Documentation version: `1.0.0-rc.0`

- Source: [types/text-run.mdx](https://github.com/dream-num/documentation/blob/dev/content/reference/types/text-run.mdx)

---

A text formatting run within an `IDocumentBody`. It associates a text interval[^utf16-offsets] with an `ITextStyle`.

[^utf16-offsets]: Text offsets use JavaScript UTF-16 code units, not visible character counts. For example, `"😀".length` is 2. A text run covers `[st, ed)`: `st` is included and `ed` is excluded; do not reuse the inclusive end indices of sheet ranges.

## Import

```ts
import type { ITextRun } from '@univerjs/core'
```

## Definition

```ts
interface ITextRun {
  st: number

  ed: number
  sId?: string
  ts?: ITextStyle
}
```

## Fields

### `st`

Required · `number`

Inclusive character index of the first styled character.

### `ed`

Required · `number`

Exclusive character boundary after the last styled character.

### `sId`

Optional · `string | undefined`

### `ts`

Optional · `ITextStyle | undefined`

## Related types

* [`ITextStyle`](https://docs.univer.ai/reference/types/text-style.md)

**Package:** [`@univerjs/core`](https://docs.univer.ai/reference/packages/plugins/univerjs/core.md) · [Type definitions](https://unpkg.com/@univerjs/core@1.0.0-rc.0/lib/types/types/interfaces/i-document-data.d.ts)