CodeBlock
Bloco de código escuro com cabeçalho, copiar e realce
Bloco de código com linguagem, copiar e realce de sintaxe na paleta da marca.
Código sendo escrito
1defmodule Signetum.NFe do2 # emite e transmite à SEFAZ3 def emitir(pedido) do4 pedido |> montar_xml() |> assinar() |> transmitir()5 end6end
<.code_block id="code-demo" title="lib/signetum/nfe.ex" icon="code" language="elixir" loop line_numbers code={"defmodule Signetum.NFe do\n # emite e transmite à SEFAZ\n def emitir(pedido) do\n pedido |> montar_xml() |> assinar() |> transmitir()\n end\nend"} />
size default/sm · variant default/destructive
<div class="flex flex-wrap items-center gap-2.5"><.chip>default</.chip><.chip>sm</.chip><.badge canvas color="error">destructive</.badge></div>
Uso
<.code_block language="elixir" code={@code} />
Regras
- Fundo escuro fixo nos dois temas; números de linha opcionais.
- Diff: linhas adicionadas/removidas em verde/rosa translúcido.
Referência da API
Todos os function components, atributos, valores e slots que este componente cobre.
Code, terminal output, logs and diffs in a dark card (the same dark palette in every theme),
styled only with Tailwind utilities: an optional header with a title and a copy button, line
numbers, wrapping, added, removed and highlighted lines, and a small size for tool output inside
a LedgerUI.Components.Trace.trace/1.
<.code_block id="install" title="Terminal" icon="terminal" code={@output} line_numbers wrap />
code is a string split into lines. lines is a list instead, each a string or a map with
:text (or :html, already safe HTML) and :variant ("added", "removed", "highlighted"):
<.code_block id="diff" title="mix.exs" lines={[
"defp deps do",
%{text: ~s( {:phoenix, "~> 1.7"},), variant: "removed"},
%{text: ~s( {:phoenix, "~> 1.8"},), variant: "added"},
"end"
]} />
Syntax highlighting
language ("elixir", "js") highlights the text of each line on the server, one colour
utility per token (keyword, string/atom, comment, function/module, number); see highlight/2. No client library is involved. Without language the text is
only escaped. The block (:inner_block) can also hold your own safe HTML, drawn as is.
Copy
copy adds a button (hook LedgerUI.CodeBlock, file priv/static/ledger_ui/hooks/code_block.js)
that copies the code without line numbers. It needs the id.
<.code_block>
Renders the code block.
| Attr | Type | Default | Values / notes |
|---|---|---|---|
id (required) |
:string |
||
code |
:string |
nil |
The code, split into lines. |
lines |
:list |
nil |
Strings or maps with :text (or :html) and :variant (added, removed, highlighted). |
language |
:string |
nil |
Highlights each line server-side: elixir, js. |
highlight |
:list |
[] |
Line numbers drawn highlighted. |
title |
:string |
nil |
|
icon |
:string |
nil |
|
copy |
:boolean |
false |
|
copy_label |
:string |
"Copy" |
|
copy_text |
:string |
nil |
What the copy button copies; the code itself when nil. |
line_numbers |
:boolean |
false |
|
start_line |
:integer |
1 |
|
wrap |
:boolean |
false |
|
loop |
:boolean |
false |
The canvas loop: the lines appear one after the other (0.35s apart) and fade out, forever. |
max_height |
:integer |
nil |
|
size |
:string |
"default" |
default, sm |
variant |
:string |
"default" |
default, destructive |
class |
:any |
nil |
Any other HTML/phx attribute goes to the root element.
Slots:
<:actions>- Buttons next to the copy button, in the header.<:footer>- A row under the code.<:inner_block>- Code as safe HTML (highlighted), drawn as is.