Referenz der Zelloptionen

Einführung

Diese Seite beschreibt die verfügbaren Zellenoptionen in Quarto Live für interaktive Codeblöcke. Mit diesen Optionen können Sie steuern, wie Ihr Code ausgeführt und in Ihren Dokumenten angezeigt wird. Im Folgenden wird jede Option zusammen mit kurzen Beispielen für R (mit webr) und Python (mit pyodide) erläutert. Weitere Details finden Sie in unserer umfassenden Dokumentation.

Übersicht

Im Folgenden finden Sie detaillierte Informationen zu diesen Optionen.

Allgemeine Optionen

Option Name	Standardwert	Beschreibung
`autorun`	`false`	Automatisches Ausführen des Codeblocks, sobald die Engine geladen ist.
`edit`	`true`	Bestimmt, ob die Codezelle editierbar ist.
`runbutton`	`true`	Zeigt die Schaltfläche `Run Code` an, wenn sie auf true gesetzt ist; die Einstellung false löst die sofortige Ausführung aus.
`completion`	`true`	Ermöglicht kontextabhängige Vorschläge zur automatischen Vervollständigung im Editor.
`include`	`true`	Zeigt sowohl den Quellcode als auch dessen Ausgabe im endgültigen Dokument an.
`persist`	`false`	Speichert Codeänderungen im lokalen Speicher des Browsers, so dass sie beim erneuten Laden erhalten bleiben.
`startover`	`true`	Zeigt die Schaltfläche ‘Neu beginnen’ an, um den Code auf seinen ursprünglichen Inhalt zurückzusetzen.
`timelimit`	`30`	Setzt ein Zeitlimit (in Sekunden) für die Codeausführung. Auf 0 setzen, um die Begrenzung zu deaktivieren.
`min-lines`	`0`	Mindestanzahl von Zeilen, die der Editor anzeigen soll.
`max-lines`	`Infinity`	Maximale Anzahl von Zeilen, die der Editor anzeigt, bevor der Bildlauf aktiviert wird.

Editor und Ausführungsoptionen

Nur-Lese-Zellen:
Die Einstellung edit: false erzeugt eine schreibgeschützte Zelle. Der Quellcode wird beim Laden angezeigt, und die Ausgabe wird nach der Ausführung des Codes hinzugefügt.
Sofortige Ausführung:
Die Verwendung von runbutton: false bewirkt, dass der Code sofort nach der Eingabe ausgeführt wird, ohne dass ein manueller Klick erforderlich ist.
Ausführung ohne Ausgabe:
Mit include: false wird der Code ausgeführt, aber weder der Quellcode noch die Ausgabe werden im Dokument angezeigt.

Zusätzliche Optionen für verbesserte Interaktivität

Code abspeichern:
Verwenden Sie persist: true, damit der Editor Änderungen des Benutzers lokal speichert. Mit der Schaltfläche ‘Neu beginnen’, die durch startover gesteuert wird, kann der ursprüngliche Code wiederhergestellt werden.
Editor Höhe:
Steuern Sie die sichtbare Höhe des Editors mit min-lines und max-lines entsprechend Ihren Layout-Anforderungen.
Querverweise:
Use fenced divs with an ID (e.g., ::: {#lst-ref}) for cross-referencing interactive code cells within your document.

Beispiele für die Verwendung

Ein kurzes Anwendungsbeispiel finden Sie auf unserer Seite Interaktive Codeblöcke erklärt.

Autorun

Automatisches Ausführen des Codes, sobald die WebAssembly-Engine geladen wird.

Quellcode:

R
Python

```{webr}
#| autorun: wahr
123 + 456
```

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

Quellcode:

R
Python

Editierbare vs. Nur-Lese-Zellen

Die Einstellung edit: false erzeugt eine schreibgeschützte Zelle. Der Quellcode wird anfangs angezeigt und die Ausgabe wird angehängt, sobald die Auswertung abgeschlossen ist.

Quellcode:

R (Schreibgeschützt)
Python (Schreibgeschützt)

```{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"])
```

Quellcode:

R (Schreibgeschützt)
Python (Schreibgeschützt)

Hinweis

Im Nur-Lese-Modus wird zunächst nur der Quellcode angezeigt; die Ausgabe erscheint, nachdem die WebAssembly-Engine die Auswertung der Zelle abgeschlossen hat.

Sofortige Ausführung

Mit runbutton: false wird der Code sofort bei der Eingabe ausgewertet, ohne dass eine Schaltfläche angeklickt werden muss.

Quellcode:

R
Python

```{webr}
#| Beschriftung: Sofortige Ausführung
#| autorun: wahr
#| runbutton: false
foo <- 123
bar <- 246
foo + bar
```

```{pyodide}
#| Beschriftung: Sofortige Ausführung
#| autorun: wahr
#| runbutton: false
foo = 123
bar = 246
print(foo + bar)
```

Quellcode:

R
Python

Warnung

Sofortige Ausführung führt den Code während der Eingabe aus, auch wenn er unvollständig ist. Während der Eingabe können kurzzeitig Fehlermeldungen erscheinen - mit Vorsicht zu verwenden.

Autovervollständigen

Steuerung der Autovervollständigung im Code-Editor. Setzen Sie completion: false, um sie zu deaktivieren.

Quellcode:

R
Python

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

# Tippen Sie `n_` in den Editor, um Vorschläge für die automatische Vervollständigung auszulösen.
```

```{pyodide}
#| autorun: wahr
#| completion: true
n_mean = 120
n_sd = 5

# Geben Sie 'n_' in Ihren Editor ein, um kontextabhängige Vorschläge zu sehen.
```

Quellcode:

R
Python

Ausführen ohne Ausgabe

Legen Sie include: false fest, um den Code auszuführen, ohne den Quellcode oder die Ausgabe im endgültigen Dokument anzuzeigen.

Quellcode:

R
Python

```{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)
```

Ergebnisse:

R
Python

Speichern und Wiederaufrufen von Code

Verwenden Sie persist: true, um Benutzeränderungen lokal zu speichern und startover: false, um die Schaltfläche ‘Neu beginnen’ zu deaktivieren.

Hinweis

Die Schaltfläche ‘Neu beginnen’ (falls aktiviert) setzt die Zelle auf ihren ursprünglichen Inhalt zurück und setzt alle gespeicherten Änderungen außer Kraft.

Start Over Deaktiviert

Quellcode:

R (Start Over Deaktiviert)
Python (Neuanfang deaktiviert)

```{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])
```

Ergebnisse:

R (Start Over Deaktiviert)
Python (Neuanfang deaktiviert)

Code beibehalten

Quellcode:

R (Code beibehalten)
Python (Code beibehalten)

```{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])
```

Ergebnisse:

R (Code beibehalten)
Python (Code beibehalten)

Zeitlimit für die Ausführung

Setzen eines Zeitlimits mit timelimit: 3 (in Sekunden). Verwenden Sie timelimit: 0 zum Deaktivieren. Der Codeblock stoppt die Ausführung nach der angegebenen Zeit und bietet so ein Sicherheitsnetz für Endlosschleifen oder problematischen Anwendercode.

Quellcode:

R
Python

```{webr}
#| timelimit: 3
while (TRUE) {
  # Endlosschleife zum Testen; stoppt nach 3 Sekunden.
}
```

```{pyodide}
#| timelimit: 3
while True:
    pass  # Endlosschleife zum Testen; stoppt nach 3 Sekunden.
```

Ergebnisse:

R
Python

Editor Höhe

Steuern Sie die sichtbare Höhe des Editors mit min-lines und max-lines.

Quellcode:

R
Python

```{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)
```

Ergebnisse:

R
Python

Querverweise

Für Querverweise auf interaktive Code-Zellen ist eine umrahmte div-Syntax mit einer ID zu verwenden.

Beispiel Quelle

::: {#lst-ref}
```{webr}
mod <- lm(mpg ~ cyl, data = mtcars)
summary(mod)
```
Ein interaktiver R-Codeblock zur Demonstration eines linearen Modells.
:::

Siehe @lst-ref für Einzelheiten.

Beispiel Ausgabe

Listing 1: Ein interaktiver R-Codeblock zur Demonstration eines linearen Modells.

Siehe Listing 1 für Einzelheiten.

Zurück nach oben

Wiederverwendung

CC BY-NC-SA 4.0

Zitat

Mit BibTeX zitieren:

@online{kassambara2025,
  author = {Kassambara, Alboukadel},
  title = {Referenz der Zelloptionen},
  date = {2025-03-07},
  url = {https://www.datanovia.com/de/learn/interactive/reference/cell-options.html},
  langid = {de}
}

Bitte zitieren Sie diese Arbeit als:

Kassambara, Alboukadel. 2025. “Referenz der Zelloptionen.” March 7, 2025. https://www.datanovia.com/de/learn/interactive/reference/cell-options.html.