Page
Page はページ全体の HTML 文書です。タイトル、シグナルの初期値、ランタイムを持ちます。
Page
Page::render はすべての束縛をシグナルの初期値で評価します。そのため、最初の HTML には、ランタイムが計算するはずの値がすでに入っています。
| 項目 | 概要 |
|---|---|
Page::new | タイトルとシグナルの初期値からページを作り始めます。 |
child | <body> にノードを追加します。 |
on_key | ページのどこかで shortcut が押されると stmt を実行します。 |
computed | signal を value と等しく保ちます。value が読むシグナルが変わると計算し直します。 |
bind_title | 文書のタイトル(ブラウザのタブに出る文字列)を title と等しく保ちます。 |
theme | ページ全体のトークンの値を設定します。 |
global | タグで要素を選ぶ規則とフォントをページに追加します。 |
style | sheet を <style> ブロックとして <head> に追加します。 |
stylesheet | href にあるファイルを読み込む <link rel="stylesheet"> を <head> に追加します。 |
script | src にあるファイルを読み込む <script type="module"> を <head> に追加します。 |
lang | ページの言語(<html> の lang 属性)を BCP 47 のタグ tag に設定します。 |
runtime_src | ランタイムを RUNTIME_PATH ではなく src から読み込みます。静的ファイルとして配信するページに使います。 |
csp_nonce | スタイルを nonce で許す Content-Security-Policy に向けて、ページの <style> と <script> に nonce を付けます。 |
render | 文書を描画します。 |
value_of | ブラウザで signal が最初に持つ値です。ページのハンドラのテストで使います。 |
RUNTIME_PATH | Page がランタイムを読み込むパスです。パスには RUNTIME_JS のハッシュが入ります。 |
RUNTIME_JS | リポジトリの runtime/ からビルドした、ブラウザのランタイムです。 |
検索結果とリンクのプレビュー
canonical の URL とカードの画像は絶対 URL なので、パスを Origin につないで作ります。ページ遷移では次の文書を読み込むので、タグはページごとに書きます。
| 項目 | 概要 |
|---|---|
description | 検索結果やリンクのプレビューに出す、ページの要約を設定します。 |
canonical | origin 上の url を、ページのただ 1 つのアドレスとして示します。 |
alternate | origin 上の url を、hreflang の言語で書いた同じページとして示します。 |
alternate_default | origin 上の url を、どの alternate にも言語が合わない訪問者向けのページとして示します。 |
noindex | ページを検索結果に出さないよう、検索エンジンに求めます。 |
nofollow | ページのリンクをたどらないよう、検索エンジンに求めます。 |
json_ld | data を、検索エンジンが読む構造化データの JSON-LD として <head> に足します。 |
icon | href のファイルを、タブやブックマークに出すページのアイコンにします。 |
open_graph | チャットアプリや SNS でページへのリンクに出すカードを追加します。 |
Origin | サイトを配信するスキーム、ホスト、省略できるパスの接頭辞です。 |
Origin::under | サイトを /blog のような prefix の下に配信する、同じオリジンです。 |
Origin::parse | https://example.com/blog のような設定の値から、オリジンと省略できる接頭辞を読みます。 |
OriginError | Origin::parse が受け付けなかった文字列と、破っていた規則です。 |
OpenGraph | チャットアプリや SNS が、ページへのリンクに出すカードです。 |
OpenGraphType | ページが何を見せるかを表す、OpenGraph のカードの og:type です。 |
OpenGraphLocale | og:locale が受け取る ja_JP の形の、言語と地域です。 |