iceshrimp-legacy/src/docs/zh-TW/theme.md

外觀主題

テーマを設定して、Misskeyクライアントの見た目を変更できます。

佈景主題設定

設定 > 佈景主題

製造佈景主題

テーマコードはJSON5で記述されたテーマオブジェクトです。 テーマは以下のようなオブジェクトです。

{
    id: '17587283-dd92-4a2c-a22c-be0637c9e22a',

    name: 'Danboard',
    author: 'syuilo',

    base: 'light',

    props: {
        accent: 'rgb(218, 141, 49)',
        bg: 'rgb(218, 212, 190)',
        fg: 'rgb(115, 108, 92)',
        panel: 'rgb(236, 232, 220)',
        renote: 'rgb(100, 152, 106)',
        link: 'rgb(100, 152, 106)',
        mention: '@accent',
        hashtag: 'rgb(100, 152, 106)',
        header: 'rgba(239, 227, 213, 0.75)',
        navBg: 'rgb(216, 206, 182)',
        inputBorder: 'rgba(0, 0, 0, 0.1)',
    },
}

• id ... 佈景主題唯一識別碼。建議使用UUID。
• name ... 佈景主題名稱
• author ... 佈景主題作者
• desc ... 佈景主題説明(可選)
• base ... 採用淺色底色/深色底色
  • lightにすると明るいテーマになり、darkにすると暗いテーマになります。
  • テーマはここで設定されたベーステーマを継承します。
• props ... テーマのスタイル定義。これから説明します。

テーマのスタイル定義

props下にはテーマのスタイルを定義します。 キーがCSSの変数名になり、バリューで中身を指定します。 なお、このpropsオブジェクトはベーステーマから継承されます。 ベーステーマは、このテーマのbaseがlightなら_light.json5で、darkなら_dark.json5です。 つまり、このテーマ内のpropsにpanelというキーが無くても、そこにはベーステーマのpanelがあると見なされます。

バリューで使える構文

• 以十六進位色碼標示
  • 例: #00ff00
• 以rgb(r, g, b)形式標示RGB顏色
  • 例: rgb(0, 255, 0)
• 以rgb(r, g, b, a)形式標示RGBA顏色
  • 例: rgba(0, 255, 0, 0.5)
• 他のキーの値の参照
  • @{キー名}と書くと他のキーの値の参照になります。{キー名}は参照したいキーの名前に置き換えます。
  • 例: @panel
• 定数(後述)の参照
  • ${定数名}と書くと定数の参照になります。{定数名}は参照したい定数の名前に置き換えます。
  • 例: $main
• 函數(見下文)
  • :{函數名稱}<{參數}<{顏色}

常數

「CSS変数として出力はしたくないが、他のCSS変数の値として使いまわしたい」値があるときは、定数を使うと便利です。 キー名を$で始めると、そのキーはCSS変数として出力されません。

函数

wip