コンテンツにスキップ

機能2026/11/16約1分で読めます

カスタムCSS

Mitra の見た目は素の CSS でできており、その上に自分の CSS を重ねられます。使わないものを隠したり、今日を枠で囲んだり、サーバー全体を自分の色にしたりできます。場所は2つあります: 自分用なら 設定 → 一般 → カスタムCSS。サインインを使っている環境でサーバーの全員に適用するなら 設定 → 管理 → 全員向けカスタムCSS です。

ロゴの金色に染まった Mitra。その変更を行うカスタムCSSルールが開いた設定画面ロゴの金色に染まった Mitra。その変更を行うカスタムCSSルールが開いた設定画面

WARNING

Mitra 1.0 までは、どのアップデートでも、ルールが対象にする要素・属性・変数が変わる可能性があります。今日動いているルールが、アップデート後に効かなくなったり、何かを隠し始めたりすることがあります。スタイルシートは短く保ち、Mitra を更新したあとは見た目を確認してください。

設定 → 一般 を開き、カスタムCSS の下のボックスに CSS を入力します。入力したそばから Mitra がそのスタイルをまとい、入力を止めてしばらくすると保存されます。サインインしたすべてのデバイスとブラウザーにアカウントごと付いてきます。

カスタムCSS の横のスイッチで、消さずにスタイルシートをオフにできます。コマンドパレットにも カスタムCSS: オフ と カスタムCSS: オン があります。

スタイルシートの保存時に @import は取り除かれます: リンクではなく、スタイルシート全体を貼り付けてください。

サインインを使っている環境では、管理者がサーバーの全員向けに Mitra を着せ替えできます: 設定 → 管理 を開き、全員向けカスタムCSS の下のボックスに CSS を入力します。入力したそばから自分には適用され、他の人には次に Mitra を読み込んだときから適用されます。そのスイッチで、消さずに全員分オフにできます。サーバーに最初にサインインした人が管理者になります。サインインがない環境では、自分用のスタイルシートがすでに Mitra を使う全員に届くので、それだけが存在します。

色、フォント、すでに付いている名前など、そのサーバーらしさを作るものに向いています。各人のスタイルシートはその後に適用されるので、同じものを両方が設定した場合は個人の方が勝ちます。

Mitra 自身のルールは mitra という名前のカスケードレイヤーに入っていて、あなたのルールは入っていません。だから、セレクターが何であれ、あなたのルールが Mitra のルールに勝ちます。!important は不要です。Mitra 自身が持つ少数の !important 宣言は、レイヤーでは優先順位が逆転するため最上位に残ります。レイアウトを保つためのものです。

Mitra が設定したものを、上塗りではなく取り去りたいときは、プロパティに revert を指定します。これで月ビューの日の表面が消えます:

mitra-weeks mitra-day {
background: revert;
}
mitra-weeks [data-outside] {
visibility: hidden;
}

月ビューで、表示している月の前後の日、その日付と背景を隠します。その日の項目は残ります。visibility はグリッドをその場に保ちます。display: none だとグリッドが崩れてしまいます。ズームインすれば、当月の日にもっと広い場所ができます。

mitra-weeks mitra-day[today] {
outline: 2px solid var(--color-accent);
outline-offset: -2px;
}

border ではなく outline を使います: border だと日が大きくなりグリッドがずれます。

:root {
--color-accent: light-dark(#2e7d32, #81c784);
--border-radius: 8px;
}

light-dark() は最初にライトテーマの色、次にダークテーマの色を取ります。これらの変数から色を取っているものはすべて追従します。インストールしたアプリのタイトルバーも含めて:

変数色づけされるもの
--color-accent今日、選択中のもの、フォーカスリング、主要なボタン
--color-background-seedすべての背後の地。ダイアログはここから色を取る
--color-surface各ビューの日、コマンドパレットなど、地の上に乗るもの
--color-textテキスト
--color-text-mutedヒントや時刻などの副次的なテキスト
--color-errorエラーと警告
--border-radiusボタン、項目、ほとんどのコントロールの角
--font-familyテキストの書体

ブラウザーの開発者ツールでページ上のものが見えます: 右クリックして 検証 を選びます。Mitra 自身の要素は mitra-… という名前です。ビューは mitra-days(週)、mitra-weeks(月)、mitra-months(年)、mitra-timeline、mitra-table、1日は mitra-day、項目は mitra-entry-segment、サイドバーは mitra-sidebar。属性は today、data-outside、data-date のような事実を表します。

ボタン、フィールド、スイッチ、メニューなどのコントロールは、内部を外に見せません。mitra-switch::part(switch) のようなパートと、それらが読む --mitra-… 変数を通じて届きます。さらに届く必要があるときは、issue でパートをリクエストしてください。

Mitra を支えているものがいくつかあり、変えると壊れます:

  • mitra-day やビュー内の .entries の display と position: これらはビュー全体が共有するグリッドの上に乗っており、これがないと週ビューがとても遅くなります。
  • --_ で始まる変数: ズームの全フレームで変わるので、設定するとその動きと競合します。
  • 項目のサイズ: 見出しが幅でレイアウトを選ぶため、外からサイズを変えるとレイアウトが切り替わってしまいます。
  • all: unset は非表示の指定も消してしまうので、隣に [hidden] { display: none } を書き直してください。

アドレスに ?css=off を付けます。https://mitra.example.com/?css=off のように。そのときだけ両方のスタイルシートなしで読み込まれるので、設定 を開いて自分のものを直せます。管理者は、全員向けの方も同じ方法で直せます。

スタイルシートはコードを実行しませんが、アドレスを読み込むことはできます。それを狙って書かれたものは、画面に映っているものを送信できてしまいます。理解できる CSS だけを貼り付けてください。自分用のスタイルシートは自分にだけ届きます。サーバーのものはサーバーの全員に届きます。

自分のスタイルシートを共有する

Section titled “自分のスタイルシートを共有する”

ボックスの下にある GitHubで共有 を押すと、あなたのスタイルシートが入った状態で Custom CSS カテゴリーの新しいディスカッションが開きます。何をするものかを書き、見た目が分かるならスクリーンショットを添えて投稿します。リンクに収まらない長いスタイルシートは、代わりにクリップボードへコピーされるので、ディスカッションに貼り付けます。そのカテゴリーは、他の人が共有したスタイルシートを見つける場所でもあります。貼り付ける前に中身を読んでください。