banner
yyh

Hi, I'm yyh

github
x
email

xLogのカスタムカーソルを設定する:トラブルシューティング速記

「カーソルが表示されない」から「ついに成功」までの核心的な理由は一つだけです:画像サイズの問題


1. カーソルが表示されない理由:画像サイズが大きすぎる#

最初に使用していたのは 2048×2048 / 512×512 の PNG でしたが、
結果としてブラウザは カーソルを直接無視します(エラーも表示されず、通知もありません)。

カーソルが正常に表示される推奨サイズ:

サイズ表現
32×32最も互換性があり、すべてのブラウザで安定
48×48明瞭で、ブログテーマのカーソルとして適している(推奨)
>128px❌ ブラウザが自動的に破棄し、完全に表示されない

したがって、最初のステップは画像を 32px または 48px にリサイズすることです。

推奨される ImageMagick コマンド(透明な背景を保持することを確認):

magick input.png -resize 48x48 png32:cursor.png
  • png32: = 透明度を強制的に保持(そうしないと白い背景になる)
  • flatten/extent などのコマンドを使用しないでください。そうしないと透明な背景が消えます。

2. 正常に使用できる画像 URL(推奨)#

raw.githubusercontent でもカーソルは表示されますが、サイズが正しい場合に限ります。
しかし、jsDelivr を使用することをお勧めします:

https://cdn.jsdelivr.net/gh/<username>/<repo>/<path>/cursor.png

利点:

  • 正しい Content-Type を自動的に返す
  • グローバル CDN、より速く安定している
  • すべての公開 GitHub リポジトリを直接使用できる

例:

https://cdn.jsdelivr.net/gh/lyzno1/lyzno1/images/cursor-48.png

3. 完全な xLog カーソル設定の例#

以下の CSS を xLog 外部 CSS またはローカル CSS に追加してください:

body {
  cursor: url("https://cdn.jsdelivr.net/gh/username/repo/images/cursor-48.png") 10 28, auto !important;
}

パラメータの説明:

  • url(...):あなたの 32px または 48px の透明 PNG
  • 10 28:ホットスポット座標(カーソルの「矢印の先端」の位置)
  • auto !important:テーマのデフォルトカーソルを上書き

ヒント:ホットスポット座標が正しくないとカーソルが「正確にポイントできない」ので、画像に応じて手動で調整してください。


4. 一言でまとめると#

  • ほとんどの問題は画像サイズが大きすぎることから来ている
  • ❗ 32px / 48px を使用し、透明な背景を保持する必要がある
  • ✔ PNG を GitHub に置き、jsDelivr を使用すれば安定してカーソルとして機能する
  • ✔ 透明度の喪失とサイズの誤りはブラウザが直接無視する理由です

バージョン:1.0
適用シーン:xLog カスタムテーマ / カーソルの美化

読み込み中...
文章は、創作者によって署名され、ブロックチェーンに安全に保存されています。