Skip to content

Latest commit

 

History

History
186 lines (128 loc) · 9.71 KB

README.ja-JP.md

File metadata and controls

186 lines (128 loc) · 9.71 KB

English | 中文 | 日本語

logo

vscode-background

Visual Studio Code にも背景画像を。

エディターごとの画像表示全画面の画像表示画像の切り替わり画像・CSSのカスタマイズ...

GitHub | Visual Studio Marketplace

Version Installs Ratings Stars Build Status License

エディタサイドバーパネル、個別に設定

フルスクリーン

インストール

2つの方法でインストールできます:

  1. Visual Studio Marketplaceからインストール
  2. vscodeの拡張機能タブからshalldie.backgroundを検索

カスタマイズ

settings.jsonからユーザー設定をカスタマイズすることができます。

settings.json とは | 設定方法

コンフィグ

グローバル設定

設定 デフォルト 説明
background.enabled Boolean true 拡張機能を有効化するかどうかを制御します。

エディタ部分の設定

エディタ部分の設定を行うには、background.editorを編集します.

設定 デフォルト 説明
useFront boolean true 画像を最前面に表示するかどうかを制御します。
style object {} 全ての画像に適応される CSS を制御します。 MDN Reference
styles object[] [{},{},{}] 個別の画像に適応される CSS を制御します。
images string[] [] httpsまたはfileプロトコルで画像のパスを指定してください。複数指定することもできます。
interval number 0 次の画像を表示するまでの秒数を制御します。0の場合、画像は変更されません。
random boolean false 画像の表示順をランダムにするかを制御します。

設定例:

{
  "background.editor": {
    "useFront": true,
    "style": {
      "background-position": "100% 100%",
      "background-size": "auto",
      "opacity": 0.6
    },
    "styles": [{}, {}, {}],
    // ローカルの画像へのfileプロトコルによるパスは、ブラウザにドラッグアンドドロップすることで簡単に取得できます
    "images": ["https://pathtoimage.png", "file:///path/to/local/file"],
    "interval": 0,
    "random": false
  }
}

フルスクリーン、サイドバー、パネル部分の設定

フルスクリーン、サイドバー、パネル部分を設定するには、background.fullscreenbackground.sidebarbackground.panelを編集します。

設定 デフォルト 説明
images string[] [] httpsまたはfileプロトコルで画像のパスを指定してください。複数指定することもできます。
opacity number 0.1 画像の不透明度を制御します、opacityへのエイリアスです。推奨値 0.1 ~ 0.3
size string cover background-sizeへのエイリアスです。推奨 cover,縦横比を保ったまま領域を覆います。
position string center background-positionへのエイリアスです。デフォルト値は center です。
interval number 0 次の画像を表示するまでの秒数を制御します。0 の場合、画像は変更されません。
random boolean false 画像の表示順をランダムにするかを制御します。

example:

{
  "background.fullscreen": {
    // ローカルの画像へのfileプロトコルによるパスは、ブラウザにドラッグアンドドロップすることで簡単に取得できます
    "images": ["https://pathtoimage.png", "file:///path/to/local/file"],
    "opacity": 0.1,
    "size": "cover",
    "position": "center",
    "interval": 0,
    "random": false
  },
  // `sidebar`、`panel`も、`fullscreen`と同様の設定項目を持っています
  "background.sidebar": {},
  "background.panel": {}
}

クイックコマンド

ステータスバーの右下にある「background」をクリックすると、backgroundのすべてのコマンドが表示されます:

注意点

この拡張機能は、VSCode 本体の js ファイルを編集することで機能します。

問題が発生した際は、Common Issuesを参照してください。

アンインストール

Common Issues#how-to-uninstallを参照してください。

貢献者 🙏

shalldie suiyun39 frg2089 AzureeDev tumit asurinsaka u3u kuresaru Unthrottled rogeraabbccdd rogeraabbccdd

コントリビューションガイド

Contributing Guideを参照してください。

チェンジログ

チェンジログで全ての変更を確認できます。

画像をシェアする

こちらで背景用の画像のシェアを行っています。

v1からの移行

v1における設定は古いものであり、互換性は限定的です。 設定の移行の際には、migration-from-v1.mdを参照してください。

ライセンス

MIT