Referência de opções de célula

Introdução

Esta página detalha as opções de célula disponíveis no Quarto Live para blocos de código interativos. Você pode usar essas opções para controlar como seu código é executado e exibido em seus documentos. Abaixo, cada opção é explicada com exemplos concisos para R (usando webr) e Python (usando pyodide). Para obter detalhes adicionais, consulte nossa documentação completa.

Visão geral

Abaixo estão informações de referência detalhadas para essas opções.

Opções gerais

Nome da opção	Valor padrão	Descrição
`autorun`	`false`	Execute automaticamente o bloco de código assim que o mecanismo for carregado.
`edit`	`true`	Determina se a célula de código é editável.
`runbutton`	`true`	Exibe o botão `Run Code` se definido como verdadeiro; definir como falso aciona a execução imediata.
`completion`	`true`	Habilita sugestões de autocompletar sensíveis ao contexto no editor.
`include`	`true`	Exibe o código-fonte e sua saída no documento final.
`persist`	`false`	Salva as alterações de código no armazenamento local do navegador para que elas persistam ao recarregar.
`startover`	`true`	Mostra o botão “Recomeçar” para redefinir o código para seu conteúdo original.
`timelimit`	`30`	Define um limite de tempo (em segundos) para a execução do código. Defina como 0 para desativar o limite.
`min-lines`	`0`	Número mínimo de linhas que o editor deve exibir.
`max-lines`	`Infinity`	Número máximo de linhas que o editor exibe antes que a rolagem seja ativada.

Opções do editor e de execução

Células somente leitura:
Definir edit: false cria uma célula somente leitura. O código-fonte aparece ao carregar e a saída é adicionada após a execução do código.
Execução imediata:
Usar runbutton: false faz com que o código seja executado imediatamente após ser inserido, sem a necessidade de um clique manual.
Execução sem saída:
Com include: false, o código é executado, mas nem o código-fonte nem a saída são exibidos no documento.

Opções adicionais para interatividade aprimorada

Armazenamento de código:
Use persist: true para que o editor armazene as alterações do usuário localmente. O botão “Recomeçar”, controlado por startover, pode restaurar o código original.
Altura do editor:
Controle a altura visível do editor usando min-lines e max-lines para atender às suas necessidades de layout.
Referências cruzadas:
Use fenced divs with an ID (e.g., ::: {#lst-ref}) for cross-referencing interactive code cells within your document.

Exemplos de uso

Para um exemplo conciso de uso, consulte nossa página Blocos de código interativos explicados.

Autorun

Execute automaticamente o código assim que o mecanismo WebAssembly for carregado.

Código-fonte:

R
Python

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

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

Código-fonte:

R
Python

Células editáveis vs. somente leitura

Definir edit: false cria uma célula somente leitura. O código-fonte é exibido inicialmente e a saída é anexada assim que a avaliação é concluída.

Código-fonte:

R (Somente leitura)
Python (Somente leitura)

```{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-fonte:

R (Somente leitura)
Python (Somente leitura)

Nota

No modo somente leitura, apenas o código-fonte é exibido inicialmente; a saída aparece depois que o mecanismo WebAssembly termina de avaliar a célula.

Execução imediata

Com runbutton: false, o código é avaliado imediatamente após ser inserido, sem a necessidade de clicar em um botão.

Código-fonte:

R
Python

```{webr}
#| legenda: Execução imediata
#| autorun: true
#| runbutton: false
foo <- 123
bar <- 246
foo + bar
```

```{pyodide}
#| legenda: Execução imediata
#| autorun: true
#| runbutton: false
foo = 123
bar = 246
print(foo + bar)
```

Código-fonte:

R
Python

Aviso

A execução imediata executa o código conforme você digita, mesmo que esteja incompleto. Mensagens de erro podem aparecer brevemente durante a digitação — use com cuidado.

Autocompletar

Controlar o preenchimento automático no editor de código. Defina completion: false para desativá-la.

Código-fonte:

R
Python

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

# Digite `n_` no editor para acionar sugestões de autocompletar.
```

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

# Digite 'n_' no editor para ver sugestões sensíveis ao contexto.
```

Código-fonte:

R
Python

Executar sem saída

Defina include: false para executar o código sem mostrar sua fonte ou saída no documento final.

Código-fonte:

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

Armazenamento e recuperação de código

Use persist: true para salvar as alterações do usuário localmente e startover: false para desativar o botão “Recomeçar”.

Nota

O botão “Recomeçar” (se ativado) redefine a célula para seu conteúdo original, substituindo quaisquer alterações persistentes.

Recomeçar desativado

Código-fonte:

R (Recomeçar desativado)
Python (Reiniciar desativado)

```{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 (Recomeçar desativado)
Python (Reiniciar desativado)

Persistir código

Código-fonte:

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)

Limite de tempo de execução

Defina um limite de tempo com timelimit: 3 (em segundos). Use timelimit: 0 para desativar. O bloco de código interrompe a execução após o tempo especificado, fornecendo uma rede de segurança para loops infinitos ou código de usuário problemático.

Código-fonte:

R
Python

```{webr}
#| timelimit: 3
while (TRUE) {
  # Loop infinito para teste; para após 3 segundos.
}
```

```{pyodide}
#| timelimit: 3
while True:
    pass  # Loop infinito para teste; para após 3 segundos.
```

Resultados:

R
Python

Altura do editor

Controle a altura visível do editor com min-lines e max-lines.

Código-fonte:

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

Referências cruzadas

Para referenciar células de código interativas, use a sintaxe div cercada com um ID.

Exemplo de fonte

::: {#lst-ref}
```{webr}
mod <- lm(mpg ~ cyl, data = mtcars)
summary(mod)
```
Um bloco de código R interativo demonstrando um modelo linear.
:::

Consulte @lst-ref para obter detalhes.

Exemplo de saída

Listagem 1: Um bloco de código R interativo demonstrando um modelo linear.

Consulte Listagem 1 para obter detalhes.

De volta ao topo

Reuso

CC BY-NC-SA 4.0

Citação

BibTeX

@online{kassambara2025,
  author = {Kassambara, Alboukadel},
  title = {Referência de opções de célula},
  date = {2025-03-07},
  url = {https://www.datanovia.com/pt/learn/interactive/reference/cell-options.html},
  langid = {pt}
}

Por favor, cite este trabalho como:

Kassambara, Alboukadel. 2025. “Referência de opções de célula.” March 7, 2025. https://www.datanovia.com/pt/learn/interactive/reference/cell-options.html.