Referencia de opciones de celda

Introducción

Esta página detalla las opciones de celda disponibles en Quarto Live para bloques de código interactivo. Puede utilizar estas opciones para controlar cómo se ejecuta y se muestra el código en sus documentos. A continuación, se explica cada opción con ejemplos concisos tanto para R (utilizando webr) como para Python (utilizando pyodide). Para obtener más información, consulte nuestra documentación completa.

Visión general

A continuación se muestra información de referencia detallada sobre estas opciones.

Opciones generales

Nombre de la opción	Valor por defecto	Descripción
`autorun`	`false`	Ejecuta automáticamente el bloque de código tan pronto como se carga el motor.
`edit`	`true`	Determina si la celda de código es editable.
`runbutton`	`true`	Muestra el botón `Run Code` si se establece en verdadero; si se establece en falso, se activa la ejecución inmediata.
`completion`	`true`	Habilita sugerencias de autocompletado sensibles al contexto en el editor.
`include`	`true`	Muestra tanto el código fuente como su salida en el documento final.
`persist`	`false`	Guarda los cambios en el código en el almacenamiento local del navegador para que se mantengan al recargar.
`startover`	`true`	Muestra el botón «Empezar de nuevo» para restablecer el código a su contenido original.
`timelimit`	`30`	Establece un límite de tiempo (en segundos) para la ejecución del código. Establezca en 0 para desactivar el límite.
`min-lines`	`0`	Número mínimo de líneas que debe mostrar el editor.
`max-lines`	`Infinity`	Número máximo de líneas que muestra el editor antes de que se active el desplazamiento.

Opciones del editor y de ejecución

Celdas de solo lectura:
Al establecer edit: false se crea una celda de solo lectura. El código fuente aparece al cargarse y el resultado se añade después de ejecutar el código.
Ejecución inmediata:
El uso de runbutton: false hace que el código se ejecute inmediatamente al introducirlo, sin necesidad de hacer clic manualmente.
Ejecución sin salida:
Con include: false, el código se ejecuta, pero ni el código fuente ni el resultado se muestran en el documento.

Opciones adicionales para una mayor interactividad

Almacenamiento de código:
Utilice persist: true para que el editor almacene los cambios del usuario localmente. El botón «Empezar de nuevo», controlado por startover, puede restaurar el código original.
Altura del editor:
Controla la altura visible del editor utilizando min-lines y max-lines para adaptarlo a tus necesidades de diseño.
Referencias cruzadas:
Use fenced divs with an ID (e.g., ::: {#lst-ref}) for cross-referencing interactive code cells within your document.

Ejemplos de uso

Para ver un ejemplo conciso de uso, consulte nuestra página Explicación de los bloques de código interactivos.

Autorun

Ejecuta automáticamente el código tan pronto como se carga el motor WebAssembly.

Código fuente:

R
Python

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

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

Código fuente:

R
Python

Celdas editables frente a celdas de solo lectura

Al establecer edit: false se crea una celda de solo lectura. El código fuente se muestra inicialmente y la salida se añade una vez completada la evaluación.

Código fuente:

R (Solo lectura)
Python (Solo lectura)

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

Código fuente:

R (Solo lectura)
Python (Solo lectura)

Nota

En el modo de solo lectura, al principio solo se muestra el código fuente; el resultado aparece después de que el motor WebAssembly termina de evaluar la celda.

Ejecución inmediata

Con runbutton: false, el código se evalúa inmediatamente al introducirlo, sin necesidad de hacer clic en ningún botón.

Código fuente:

R
Python

```{webr}
#| Leyenda: Ejecución inmediata
#| autorun: true
#| runbutton: false
foo <- 123
bar <- 246
foo + bar
```

```{pyodide}
#| Leyenda: Ejecución inmediata
#| autorun: true
#| runbutton: false
foo = 123
bar = 246
print(foo + bar)
```

Código fuente:

R
Python

Advertencia

La ejecución inmediata ejecuta el código a medida que se escribe, incluso si está incompleto. Pueden aparecer mensajes de error brevemente durante la escritura; utilícelos con precaución.

Autocompletar

Controlar el autocompletado en el editor de código. Establezca completion: false para desactivarlo.

Código fuente:

R
Python

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

# Escriba `n_` en el editor para activar las sugerencias de autocompletado.
```

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

# Escriba «n_» en el editor para ver sugerencias contextuales.
```

Código fuente:

R
Python

Ejecutar sin salida

Establezca include: false para ejecutar el código sin mostrar su fuente ni su salida en el documento final.

Código fuente:

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

Resultados:

R
Python

Almacenamiento y recuperación de código

Utilice persist: true para guardar los cambios del usuario localmente y startover: false para desactivar el botón «Empezar de nuevo».

Nota

El botón «Empezar de nuevo» (si está habilitado) restablece la celda a su contenido original, anulando cualquier cambio persistente.

Reinicio desactivado

Código fuente:

R (Reinicio desactivado)
Python (Reiniciar desactivado)

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

Resultados:

R (Reinicio desactivado)
Python (Reiniciar desactivado)

Persistir código

Código fuente:

R (Persistir código)
Python (Persistir código)

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

Resultados:

R (Persistir código)
Python (Persistir código)

Límite de tiempo de ejecución

Establezca un límite de tiempo con timelimit: 3 (en segundos). Utilice timelimit: 0 para desactivarlo. El bloque de código deja de ejecutarse después del tiempo especificado, lo que proporciona una red de seguridad para bucles infinitos o código de usuario problemático.

Código fuente:

R
Python

```{webr}
#| timelimit: 3
while (TRUE) {
  # Bucle infinito para pruebas; se detiene después de 3 segundos.
}
```

```{pyodide}
#| timelimit: 3
while True:
    pass  # Bucle infinito para pruebas; se detiene después de 3 segundos.
```

Resultados:

R
Python

Altura del editor

Controla la altura visible del editor con min-lines y max-lines.

Código fuente:

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

Resultados:

R
Python

Referencias cruzadas

Para hacer referencias cruzadas entre celdas de código interactivo, utilice la sintaxis div con un ID.

Ejemplo de código fuente

::: {#lst-ref}
```{webr}
mod <- lm(mpg ~ cyl, data = mtcars)
summary(mod)
```
Bloque de código R interactivo que muestra un modelo lineal.
:::

Consulte @lst-ref para obtener más detalles.

Ejemplo de salida

Listado 1: Bloque de código R interactivo que muestra un modelo lineal.

Consulte Listado 1 para obtener más detalles.

Volver arriba

Reutilización

CC BY-NC-SA 4.0

Cómo citar

BibTeX

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

Por favor, cita este trabajo como:

Kassambara, Alboukadel. 2025. “Referencia de opciones de celda.” March 7, 2025. https://www.datanovia.com/es/learn/interactive/reference/cell-options.html.