On this page
d-codeblock
アニメーション付きコピーボタン、ファイル名ヘッダーバー、言語バッジ、行番号、行ハイライト、diff表示に対応したシンタックスハイライト付きコードブロックコンポーネントです。
1<!-- タイトルと言語指定付きの基本コードブロック -->2<d-codeblock title="Server.js" lang="javascript" copyable>3const port = 3000;4function listen() {5 console.log("listening on", port);6}7</d-codeblock>8 9<!-- 行ハイライトと行番号表示 -->10<d-codeblock lang="javascript" highlight="2,4-5">11const a = 1;12const b = 2;13const c = 3;14const sum = a + b + c;15console.log(sum);16</d-codeblock>17 18<!-- フローティングコピーボタン付きdiff表示 -->19<d-codeblock diff copyable>20 initial config21-const timeout = 1000;22+const timeout = 5000;23 return timeout;24</d-codeblock>
属性とプロパティ(d-codeblock)
| 属性 | プロパティ | 型 | デフォルト値 | フォーム | 説明 |
|---|---|---|---|---|---|
title |
title |
string |
"" |
いいえ | ヘッダーバーに表示するファイル名またはラベル |
lang |
lang |
string |
"" |
いいえ | 大文字バッジとして表示するプログラミング言語識別子 |
code |
code |
string |
"" |
いいえ | プログラムから指定するソースコード文字列 |
line-numbers |
lineNumbers |
boolean |
true |
いいえ | 各行の横に行番号を表示するかどうか |
highlight |
highlight |
string |
"" |
いいえ | ハイライトする行番号または範囲(例:"2,4-6") |
diff |
diff |
boolean |
false |
いいえ | +または-で始まる行を差分スタイルで表示 |
copyable |
copyable |
boolean |
true |
いいえ | コピーボタンを表示するかどうか(ヘッダー内または右上に配置) |
wrap |
wrap |
boolean |
false |
いいえ | 横スクロールの代わりに行を折り返して表示 |
max-height |
maxHeight |
string |
"" |
いいえ | 長いコードに対する最大スクロール高さ |
code-font-size |
codeFontSize |
string |
"" |
いいえ | コードテキスト専用のカスタムフォントサイズ |
プログラム用api(d-codeblock)
1const block = select('d-codeblock');2 3// プログラムからクリップボードへコピー4block.copy();5 6// 生のコードテキストを取得7block.codeText; // string
イベント(d-codeblock)
| イベント | ペイロード | バブリング | 説明 |
|---|---|---|---|
copy |
{ text: string } |
はい | コードがクリップボードにコピーされたときに送出 |
動作仕様(d-codeblock)
titleまたはlangが指定されている場合、ファイルアイコン、ファイル名、言語バッジ、コピーボタンを備えたヘッダーバーを描画します。titleとlangの双方が省略されている場合、右上にフローティングコピーボタンを配置します。- コピーボタンをクリックすると、スプリングアニメーションを伴って緑色のチェックマーク(
dstrn-check-line)に切り替わり、2秒後に元のアイコンへ戻ります。 - ゼロインジェクション仕様の安全な内蔵トークナイザーにより、コードを安全にエスケープして標準トークンクラス(
.d-cb-keyword、.d-cb-string、.d-cb-number、.d-cb-comment、.d-cb-function)を適用します。 - サーバーで事前レンダリングされたマークアップ(
highlight.jsの行要素など)を重複なくシームレスに取り込んで表示します。

