# Lignes et colonnes

- Human documentation: [https://docs.univer.ai/fr-FR/guides/sheets/features/core/row-col](https://docs.univer.ai/fr-FR/guides/sheets/features/core/row-col)

- Agent Markdown: [https://docs.univer.ai/fr-FR/guides/sheets/features/core/row-col.md](https://docs.univer.ai/fr-FR/guides/sheets/features/core/row-col.md)

- Requested language: `fr-FR`

- Content language: `fr-FR`

- Documentation version: `1.2.0`

- Source: [sheets/features/core/row-col.fr-FR.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/sheets/features/core/row-col.fr-FR.mdx)

---

## Facade API

La définition complète des types de l’API Facade est disponible dans la [documentation de l’API Facade](https://docs.univer.ai/fr-FR/reference/facade.md).

### Lignes

#### Insérer une ligne après une position donnée

[`insertRowAfter(afterPosition)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#insertrowafter) : insère une ligne après la position de ligne indiquée.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// This inserts a row after the first row position
sheet.insertRowAfter(0)
```

#### Insérer une ligne avant une position donnée

[`insertRowBefore(beforePosition)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#insertrowbefore) : insère une ligne avant la position de ligne indiquée.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// This inserts a row before the first row position
sheet.insertRowBefore(0)
```

#### Insérer plusieurs lignes à l’emplacement indiqué

[`insertRows(rowIndex, numRows)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#insertrows) : insère dans une feuille une ou plusieurs lignes vides consécutives à partir de l’emplacement indiqué.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Shifts all rows down by three
sheet.insertRows(0, 3)
```

#### Insérer plusieurs lignes après une position donnée

[`insertRowsAfter(afterPosition, howMany)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#insertrowsafter) : insère le nombre de lignes indiqué après la position de ligne donnée.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// This inserts five rows after the first row
sheet.insertRowsAfter(0, 5)
```

#### Insérer plusieurs lignes avant une position donnée

[`insertRowsBefore(beforePosition, howMany)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#insertrowsbefore) : insère le nombre de lignes indiqué avant la position de ligne donnée.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// This inserts five rows before the first row
sheet.insertRowsBefore(0, 5)
```

#### Supprimer la ligne à une position donnée

[`deleteRow(rowPosition)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#deleterow) : supprime la ligne située à la position indiquée.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Rows start at "0" - this deletes the first row
sheet.deleteRow(0)
```

#### Supprimer plusieurs lignes à partir d’une position donnée

[`deleteRows(rowPosition, howMany)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#deleterows) : supprime le nombre de lignes indiqué à partir de la position de ligne donnée.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Rows start at "0" - this deletes the first two rows
sheet.deleteRows(0, 2)
```

#### Supprimer plusieurs lignes aux positions indiquées

[`deleteRowsByPoints(rowPoints)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#deleterowsbypoints) : supprime plusieurs lignes, pas nécessairement consécutives, désignées par un tableau de positions.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Rows start at "0" - this deletes the 3rd row and rows 5 to 7
fWorksheet.deleteRowsByPoints([2, [4, 6]])
```

#### Déplacer des lignes vers une nouvelle position

[`moveRows(rowSpec, destinationIndex)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#moverows) : déplace les lignes sélectionnées par la plage donnée vers la position indiquée par `destinationIndex`. `rowSpec` ne doit pas nécessairement représenter avec exactitude une ligne entière ou un groupe de lignes à déplacer : toutes les lignes traversées par la plage sont sélectionnées.

```typescript
// The code below moves rows 1-2 to destination index 5
// This results in those rows becoming rows 3-4
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Selects row 1 and row 2 to be moved
const rowSpec = sheet.getRange('1:2')
sheet.moveRows(rowSpec, 5)
```

#### Masquer les lignes d’une plage donnée

[`hideRow(row)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#hiderow) : masque les lignes de la plage indiquée.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// This hides the first row
const range = sheet.getRange('1:1')
sheet.hideRow(range)
```

#### Masquer plusieurs lignes consécutives

[`hideRows(rowIndex, numRows)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#hiderows) : masque une ou plusieurs lignes consécutives à partir de l’indice donné. Cette méthode utilise des indices commençant à 0.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Hides the first three rows
sheet.hideRows(0, 3)
```

#### Réafficher une ligne dans une plage donnée

[`unhideRow(row)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#unhiderow) : réaffiche la ligne de la plage indiquée.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// This unhides the first row if it was previously hidden
const range = sheet.getRange('1:1')
sheet.unhideRow(range)
```

#### Réafficher plusieurs lignes consécutives

[`showRows(rowIndex, numRows)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#showrows) : réaffiche une ou plusieurs lignes consécutives à partir de l’indice donné. Cette méthode utilise des indices commençant à 0.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Unhides the first three rows
sheet.showRows(0, 3)
```

#### Définir la hauteur d’une ligne

[`setRowHeight(rowPosition, height)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#setrowheight) : définit en pixels la hauteur de la ligne donnée. Par défaut, les lignes s’agrandissent pour s’adapter au contenu des cellules. Pour imposer une hauteur précise, utilisez `setRowHeightsForced(startRow, numRows, height)`.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Sets the first row to a height of 200 pixels
sheet.setRowHeight(0, 200)
```

#### Définir la hauteur de plusieurs lignes

[`setRowHeights(startRow, numRows, height)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#setrowheights) : définit en pixels la hauteur des lignes données. Par défaut, les lignes s’agrandissent pour s’adapter au contenu des cellules. Pour imposer une hauteur précise, utilisez `setRowHeightsForced(startRow, numRows, height)`.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Sets the first three rows to a height of 200 pixels
sheet.setRowHeights(0, 3, 200)
```

#### Imposer la hauteur de plusieurs lignes

[`setRowHeightsForced(startRow, numRows, height)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#setrowheightsforced) : définit en pixels la hauteur des lignes données. Par défaut, les lignes s’agrandissent pour s’adapter au contenu des cellules. Avec `setRowHeightsForced`, les lignes conservent la hauteur indiquée même si le contenu des cellules est plus haut.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Sets the first three rows to a height of 5 pixels
sheet.setRowHeightsForced(0, 3, 5)
```

#### Ajuster automatiquement la hauteur des lignes

[`autoResizeRows(startRow, numRows)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#autoresizerows) : ajuste automatiquement la hauteur des lignes données à leur contenu textuel.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Set the first 3 rows to a height that fits their text.
sheet.autoResizeRows(0, 3)
```

#### Définir des propriétés personnalisées pour les lignes

[`setRowCustom(custom)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#setrowcustom) : définit des propriétés personnalisées pour les lignes données. Un objet `custom` est enregistré sur la ligne et peut contenir toute donnée conforme au format JSON afin de stocker des informations supplémentaires.
La mise à jour des données `custom` écrase les données `custom` d’origine. Pour conserver les données `custom` d’origine lors d’une mise à jour, récupérez au préalable les données `custom` et fusionnez-les avec les nouvelles données avant d’effectuer la mise à jour.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Set custom properties for the first and third rows
sheet.setRowCustom({
  0: { color: 'red' },
  2: { size: 16 },
})
```

### Colonnes

#### Insérer une colonne après une position donnée

[`insertColumnAfter(afterPosition)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#insertcolumnafter) : insère une colonne après la position de colonne donnée.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// This inserts a column after the first column position
sheet.insertColumnAfter(0)
```

#### Insérer une colonne avant une position donnée

[`insertColumnBefore(beforePosition)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#insertcolumnbefore) : insère une colonne avant la position de colonne donnée.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// This inserts a column in the first column position
sheet.insertColumnBefore(0)
```

#### Insérer plusieurs colonnes à l’emplacement indiqué

[`insertColumns(columnIndex, numColumns)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#insertcolumns) : insère dans une feuille une ou plusieurs colonnes vides consécutives à partir de l’emplacement indiqué.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Shifts all columns by three
sheet.insertColumns(0, 3)
```

#### Insérer plusieurs colonnes après une position donnée

[`insertColumnsAfter(afterPosition, howMany)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#insertcolumnsafter) : insère le nombre de colonnes indiqué après la position de colonne donnée.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Inserts two columns after the first column
sheet.insertColumnsAfter(0, 2)
```

#### Insérer plusieurs colonnes avant une position donnée

[`insertColumnsBefore(beforePosition, howMany)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#insertcolumnsbefore) : insère le nombre de colonnes indiqué avant la position de colonne donnée.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// This inserts five columns before the first column
sheet.insertColumnsBefore(0, 5)
```

#### Supprimer la colonne à une position donnée

[`deleteColumn(columnPosition)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#deletecolumn) : supprime la colonne située à la position donnée.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Columns start at "0" - this deletes the first column
sheet.deleteColumn(0)
```

#### Supprimer plusieurs colonnes à partir d’une position donnée

[`deleteColumns(columnPosition, howMany)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#deletecolumns) : supprime le nombre de colonnes indiqué à partir de la position de colonne donnée.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Columns start at "0" - this deletes the first two columns
sheet.deleteColumns(0, 2)
```

#### Supprimer plusieurs colonnes aux positions indiquées

[`deleteColumnsByPoints(columnPoints)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#deletecolumnsbypoints) : supprime plusieurs colonnes, pas nécessairement consécutives, désignées par un tableau de positions.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Columns start at "0" - this deletes the Column C and Columns E-G
fWorksheet.deleteColumnsByPoints([2, [4, 6]])
```

#### Déplacer des colonnes vers une nouvelle position

[`moveColumns(columnSpec, destinationIndex)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#movecolumns) : déplace les colonnes sélectionnées par la plage donnée vers la position indiquée par `destinationIndex`. `columnSpec` ne doit pas nécessairement représenter avec exactitude une colonne entière ou un groupe de colonnes à déplacer : toutes les colonnes traversées par la plage sont sélectionnées.

```typescript
// The code below moves rows A-B to destination index 5.
// This results in those columns becoming columns C-D.
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Selects column A and column B to be moved.
const columnSpec = sheet.getRange('A:B')
sheet.moveColumns(columnSpec, 5)
```

#### Masquer les colonnes d’une plage donnée

[`hideColumn(column)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#hidecolumn) : masque la ou les colonnes de la plage donnée.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// This hides the first column
const range = sheet.getRange('A:A')
sheet.hideColumn(range)
```

#### Masquer plusieurs colonnes consécutives

[`hideColumns(columnIndex, numColumns)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#hidecolumns) : masque une ou plusieurs colonnes consécutives à partir de l’indice donné. Cette méthode utilise des indices commençant à 0.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Hides the first three columns
sheet.hideColumns(0, 3)
```

#### Réafficher une colonne dans une plage donnée

[`unhideColumn(column)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#unhidecolumn) : réaffiche la colonne de la plage donnée.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// This unhides the first column if it was previously hidden
const range = sheet.getRange('A:A')
sheet.unhideColumn(range)
```

#### Réafficher plusieurs colonnes consécutives

[`showColumns(columnIndex, numColumns)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#showcolumns) : réaffiche une ou plusieurs colonnes consécutives à partir de l’indice donné. Cette méthode utilise des indices commençant à 0.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Unhides the first three columns
sheet.showColumns(0, 3)
```

#### Définir la largeur d’une colonne

[`setColumnWidth(columnPosition, width)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#setcolumnwidth) : définit en pixels la largeur de la colonne donnée.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Sets the first column to a width of 200 pixels
sheet.setColumnWidth(0, 200)
```

#### Définir la largeur de plusieurs colonnes

[`setColumnWidths(startColumn, numColumns, width)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#setcolumnwidths) : définit en pixels la largeur des colonnes données.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Sets the first three columns to a width of 200 pixels
sheet.setColumnWidths(0, 3, 200)
```

#### Ajuster automatiquement la largeur des colonnes

[`autoResizeColumns(startColumn, numColumns)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#autoresizecolumns) : ajuste automatiquement la largeur des colonnes données à leur contenu textuel.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Set the A:C columns to a width that fits their text.
sheet.autoResizeColumns(0, 3)
```

#### Définir des propriétés personnalisées pour les colonnes

[`setColumnCustom(custom)`](https://docs.univer.ai/fr-FR/reference/facade/worksheet.md#setcolumncustom) : définit des propriétés personnalisées pour les colonnes données. Un objet `custom` est enregistré sur la colonne et peut contenir toute donnée conforme au format JSON afin de stocker des informations supplémentaires.
La mise à jour des données `custom` écrase les données `custom` d’origine. Pour conserver les données `custom` d’origine lors d’une mise à jour, récupérez au préalable les données `custom` et fusionnez-les avec les nouvelles données avant d’effectuer la mise à jour.

```typescript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()

// Set custom properties for the first and third columns
sheet.setColumnCustom({
  0: { color: 'red' },
  2: { size: 16 },
})
```