「カーソルが表示されない」から「ついに成功」までの核心的な理由は一つだけです:画像サイズの問題。
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 の透明 PNG10 28:ホットスポット座標(カーソルの「矢印の先端」の位置)auto !important:テーマのデフォルトカーソルを上書き
ヒント:ホットスポット座標が正しくないとカーソルが「正確にポイントできない」ので、画像に応じて手動で調整してください。
4. 一言でまとめると#
- ❗ ほとんどの問題は画像サイズが大きすぎることから来ている
- ❗ 32px / 48px を使用し、透明な背景を保持する必要がある
- ✔ PNG を GitHub に置き、jsDelivr を使用すれば安定してカーソルとして機能する
- ✔ 透明度の喪失とサイズの誤りはブラウザが直接無視する理由です
バージョン:1.0
適用シーン:xLog カスタムテーマ / カーソルの美化