# TableCellPropertiesConfig

interface

The configuration of the table cell properties user interface (balloon).

[See source](https://github.com/ckeditor/ckeditor5/blob/master/packages/ckeditor5-table/src/tableconfig.ts#L465)

<a id="properties">

## Properties

<a id="member-backgroundColors">

### `backgroundColors?: TableColorConfig`

The color palette for the table cell background color picker.

```typescript
const tableConfig = {
	tableCellProperties: {
		backgroundColors: [
			{
				color: 'hsl(0, 0%, 100%)',
				label: 'White',
				hasBorder: true
			},
			{
				color: 'hsl(120, 75%, 60%)',
				label: 'Green'
			}
		]
	}
};
```

**Note**: This configuration only affects the UI. It does not limit or filter the colors in the data.

Defaults to [`defaultColors`](module_table_utils_ui_table-properties.md#constant-defaultColors).

[See source](https://github.com/ckeditor/ckeditor5/blob/master/packages/ckeditor5-table/src/tableconfig.ts#L523)

#### Related:

* [TableColorConfig](module_table_tableconfig-TableColorConfig.md)

<a id="member-borderColors">

### `borderColors?: TableColorConfig`

The color palette for the table cell border color picker.

```typescript
const tableConfig = {
	tableCellProperties: {
		borderColors: [
			{
				color: 'hsl(0, 0%, 0%)',
				label: 'Black'
			},
			{
				color: 'hsl(0, 0%, 100%)',
				label: 'White',
				hasBorder: true
			}
		]
	}
};
```

**Note**: This configuration only affects the UI. It does not limit or filter the colors in the data.

Defaults to [`defaultColors`](module_table_utils_ui_table-properties.md#constant-defaultColors).

[See source](https://github.com/ckeditor/ckeditor5/blob/master/packages/ckeditor5-table/src/tableconfig.ts#L494)

#### Related:

* [TableColorConfig](module_table_tableconfig-TableColorConfig.md)

<a id="member-colorGridColumns">

### `colorGridColumns?: number`

The number of columns in the `borderColors` and `backgroundColors` palettes of the table cell properties balloon.

```typescript
const tableConfig = {
	tableCellProperties: {
		colorGridColumns: 8
	}
};
```

Defaults to [`defaultColorGridColumns`](module_ui_colorgrid_colors.md#constant-defaultColorGridColumns).

[See source](https://github.com/ckeditor/ckeditor5/blob/master/packages/ckeditor5-table/src/tableconfig.ts#L562)

<a id="member-colorPicker">

### `colorPicker?: false | ColorPickerConfig`

Configuration of the color picker in the table cell properties balloon.

If set to `false` the picker will not appear.

[See source](https://github.com/ckeditor/ckeditor5/blob/master/packages/ckeditor5-table/src/tableconfig.ts#L569)

<a id="member-defaultProperties">

### `defaultProperties?: TableCellPropertiesOptions`

Default styles for newly created table cells.

```typescript
const tableConfig = {
	tableCellProperties: {
		defaultProperties: {
			borderStyle: 'dashed',
			borderColor: 'hsl(0, 0%, 90%)',
			borderWidth: '3px',
			horizontalAlignment: 'center',
			verticalAlignment: 'middle',
			padding: '10px'
		}
	}
}
```

**Note**: The model does not store the default values. The editor will only keep values that differ from the defaults.

See [`TableCellPropertiesOptions`](module_table_tableconfig-TableCellPropertiesOptions.md) for the full list of properties.

[See source](https://github.com/ckeditor/ckeditor5/blob/master/packages/ckeditor5-table/src/tableconfig.ts#L547)

<a id="member-scopedHeaders">

### `scopedHeaders?: boolean`

If set to `true`, the `scope` attribute will be applied to table headers (`<th>`) based on their position in the table.

The table cell properties UI will extend a dropdown with two more options that allow manually setting the header scope:

* `Column header` — sets `scope="col"` on `<th>`.
* `Row header` — sets `scope="row"` on `<th>`.

If header cell is both in a heading row and a heading column, the `col` scope will be prioritized by the header rows and columns setting logic. In such case, the user can manually change the scope using the table cell properties UI.

To disable this behavior:

```typescript
const tableConfig = {
	tableCellProperties: {
		scopedHeaders: false
	}
};
```

[See source](https://github.com/ckeditor/ckeditor5/blob/master/packages/ckeditor5-table/src/tableconfig.ts#L594)

Defaults to `true`

---

Full index of the CKEditor 5 API reference: [llms.txt](llms.txt)