Référence des options de cellule

Options détaillées pour les blocs de code interactifs dans Quarto Live

Un guide complet des différentes options de cellules disponibles dans Quarto Live pour R (webr) et Python (pyodide).

Outils
Auteur·rice
Affiliation

Alboukadel Kassambara

Datanovia

Date de publication

7 mars 2025

Mots clés

options de cellule, options des blocs de code interactifs, Configuration de Quarto Live

Introduction

Cette page détaille les options de cellule disponibles dans Quarto Live pour les blocs de code interactifs. Vous pouvez utiliser ces options pour contrôler la façon dont votre code est exécuté et affiché dans vos documents. Ci-dessous, chaque option est expliquée avec des exemples concis pour R (en utilisant webr) et Python (en utilisant pyodide). Pour plus de détails, veuillez vous référer à notre documentation complète.



Vue d’ensemble

Vous trouverez ci-dessous des informations de référence détaillées pour ces options.

Options générales

Option Name Valeur par défaut Description de l’option
autorun false Exécution automatique du bloc de code dès que le moteur se charge.
edit true Détermine si la cellule de code est modifiable.
runbutton true Affiche le bouton Run Code s’il est défini comme vrai ; s’il est défini comme faux, l’exécution est immédiate.
completion true Active les suggestions contextuelles de saisie semi-automatique dans l’éditeur.
include true Affiche à la fois le code source et son résultat dans le document final.
persist false Enregistre les modifications du code dans le stockage local du navigateur afin qu’elles persistent lors du rechargement.
startover true Affiche le bouton ‘Recommencer’ pour réinitialiser le code à son contenu d’origine.
timelimit 30 Fixe une limite de temps (en secondes) pour l’exécution du code. Mettre à 0 pour désactiver la limite.
min-lines 0 Nombre minimum de lignes que l’éditeur doit afficher.
max-lines Infinity Nombre maximal de lignes affichées par l’éditeur avant que le défilement ne soit activé.

Options d’édition et d’exécution

  • Cellules en lecture seule:
    Le paramètre edit: false crée une cellule en lecture seule. Le code source apparaît au chargement et la sortie est ajoutée après l’exécution du code.

  • Exécution immédiate:
    L’utilisation de runbutton: false entraîne l’exécution du code immédiatement après sa saisie, sans nécessiter de clic manuel.

  • Exécution sans sortie:
    Avec include: false, le code est exécuté mais ni le code source ni la sortie ne sont affichés dans le document.

Options supplémentaires pour une meilleure interactivité

  • Stockage du code:
    Utilisez persist: true pour que l’éditeur stocke localement les modifications apportées par l’utilisateur. Le bouton ‘Recommencer’, contrôlé par startover, permet de restaurer le code original.

  • Hauteur de l’éditeur:
    Contrôlez la hauteur visible de l’éditeur en utilisant les options min-lines et max-lines pour répondre à vos besoins en matière de mise en page.

  • Références croisées:
    Use fenced divs with an ID (e.g., ::: {#lst-ref}) for cross-referencing interactive code cells within your document.

Exemples d’utilisation

Pour un exemple d’utilisation concis, voir notre page Blocs de code interactifs expliqués.

Autorun

Exécute automatiquement le code dès que le moteur WebAssembly est chargé.

Source Code:

```{webr}
#| autorun : true
123 + 456
```
```{pyodide}
#| autorun : true
print(123 + 456)
```

Source Code:

Cellules modifiables ou en lecture seule

Le paramètre edit: false crée une cellule en lecture seule. Le code source est initialement affiché et la sortie est ajoutée une fois l’évaluation terminée.

Source Code:

```{webr}
#| edit: false
df <- data.frame(foo = c(1, 2, 3), bar = c(10, 20, 30))
df$foo
df$bar
```
```{pyodide}
#| edit: false
import pandas as pd
df = pd.DataFrame({"foo": [1, 2, 3], "bar": [10, 20, 30]})
print(df["foo"])
print(df["bar"])
```

Source Code:

Note

En mode lecture seule, seul le code source est affiché dans un premier temps ; la sortie apparaît une fois que le moteur WebAssembly a fini d’évaluer la cellule.

Exécution immédiate

Avec runbutton: false, le code est évalué dès qu’il est saisi, sans qu’il soit nécessaire de cliquer sur un bouton.

Source Code:

```{webr}
#| légende : Exécution immédiate
#| autorun : true
#| runbutton: false
foo <- 123
bar <- 246
foo + bar
```
```{pyodide}
#| légende : Exécution immédiate
#| autorun : true
#| runbutton: false
foo = 123
bar = 246
print(foo + bar)
```

Source Code:

Avertissement

L’exécution immédiate exécute le code au fur et à mesure que vous le tapez, même s’il est incomplet. Des messages d’erreur peuvent apparaître brièvement pendant la saisie - à utiliser avec précaution.

Autocomplétion

Contrôle de l’autocomplétion dans l’éditeur de code. Définissez completion: false pour la désactiver.

Source Code:

```{webr}
#| autorun : true
#| completion: true
n_mean <- 120
n_sd <- 5

# Tapez `n_` dans l'éditeur pour déclencher les suggestions de l'autocomplétion.
```
```{pyodide}
#| autorun : true
#| completion: true
n_mean = 120
n_sd = 5

# Tapez 'n_' dans votre éditeur pour voir les suggestions contextuelles.
```

Source Code:

Exécution sans sortie

Définissez include: false pour exécuter le code sans afficher sa source ou sa sortie dans le document final.

Source Code:

```{webr}
#| include: false
123
456
include_false_n <- 789
```

```{webr}
print(include_false_n)
```
```{pyodide}
#| include: false
print(123)
print(456)
include_false_n = 789
```

```{pyodide}
print(include_false_n)
```

Résultats:

Stockage et rappel du code

Utilisez persist: true pour sauvegarder les modifications de l’utilisateur localement et startover: false pour désactiver le bouton ‘Recommencer’.

Note

Le bouton ‘Recommencer’ (s’il est activé) réinitialise la cellule à son contenu d’origine, en annulant toute modification persistante.

Démarrage désactivé

Source Code:

```{webr}
#| startover: false
foo <- c(2, 4, 6, 8)
foo + 1
```
```{pyodide}
#| startover: false
foo = [2, 4, 6, 8]
print([x + 1 for x in foo])
```

Résultats:

Persistance du code

Source Code:

```{webr}
#| persist: true
foo <- c(1, 3, 5, 7)
foo + 1
```
```{pyodide}
#| persist: true
foo = [1, 3, 5, 7]
print([x + 1 for x in foo])
```

Résultats:

Limite de temps d’exécution

Fixer une limite de temps avec timelimit: 3 (en secondes). Utiliser timelimit: 0 pour la désactiver. Le bloc de code cesse de s’exécuter après le délai spécifié, ce qui constitue un filet de sécurité pour les boucles infinies ou le code utilisateur problématique.

Source Code:

```{webr}
#| timelimit: 3
while (TRUE) {
  # Boucle infinie pour les tests ; s'arrête après 3 secondes.
}
```
```{pyodide}
#| timelimit: 3
while True:
    pass  # Boucle infinie pour les tests ; s'arrête après 3 secondes.
```

Résultats:

Hauteur de l’éditeur

Contrôlez la hauteur visible de l’éditeur avec min-lines et max-lines.

Source Code:

```{webr}
#| min-lines: 6
#| max-lines: 10
x <- 173

y <- 205

x + y
```
```{pyodide}
#| min-lines: 6
#| max-lines: 10
x = 173

y = 205

print(x + y)
```

Résultats:

Références croisées

Pour les références croisées entre les cellules de code interactif, utilisez la syntaxe div clôturée avec un identifiant.

Exemple de source

::: {#lst-ref}
```{webr}
mod <- lm(mpg ~ cyl, data = mtcars)
summary(mod)
```
Un bloc de code R interactif démontrant un modèle linéaire.
:::

Voir @lst-ref pour plus de détails.

Exemple de sortie

Listing 1: Un bloc de code R interactif démontrant un modèle linéaire.

Voir Listing 1 pour plus de détails.

Retour au sommet

Réutilisation

Citation

BibTeX
@online{kassambara2025,
  author = {Kassambara, Alboukadel},
  title = {Référence des options de cellule},
  date = {2025-03-07},
  url = {https://www.datanovia.com/fr/learn/interactive/reference/cell-options.html},
  langid = {fr}
}
Veuillez citer ce travail comme suit :
Kassambara, Alboukadel. 2025. “Référence des options de cellule.” March 7, 2025. https://www.datanovia.com/fr/learn/interactive/reference/cell-options.html.