URLスラッグの作り方|小文字とハイフンに変換する正規表現

記事のタイトルや任意の文章をそのままURLに使うと、空白は %20 のようなパーセントエンコーディングに置き換わり、記号が混ざるとアドレスが長くて見苦しくなります。これを整理する標準的な方法が スラッグ(Slug) への変換です。
この記事では、文字列をスラッグに変えるルールを実際の正規表現とあわせて整理し、ハングルを残すか削除するかで結果がどう変わるかを説明します。
なぜ空白や記号をそのまま使ってはいけないのか
エンコードされていない空白や記号がブラウザのアドレスバーにそのまま入ると、ブラウザは通信のためにそれをパーセントエンコーディングという16進数の文字列に変換してしまいます。
- 変換前:
my page 1 - ブラウザによる自動エンコード:
my%20page%201(空白が%20に変わり、アドレスが見苦しくなる) - スラッグ変換:
my-page-1(ハイフンでつながって短く、コピーしても崩れない)
スラッグに変換するルール: 自分で計算する方法
文字列をスラッグに変える手順は、次の順番で進みます。
- 小文字に統一します。 英字の大文字をすべて小文字に変えます。
- 許可しない文字を削除します。 英小文字・数字・空白・ハイフンだけを残し、それ以外の記号(カンマ、ピリオド、アットマークなど)を取り除きます。
- 空白とアンダースコアをハイフンに変え、連続するハイフンを1つにまとめます。 続けて、文字列の前後に残ったハイフンも整理します。
コードに落とすと、次のような正規表現のチェーンになります。
function slugify(text) {
return text
.trim()
.toLowerCase()
.replace(/[^a-z0-9\s-]/g, "") // 許可文字以外を削除
.replace(/[\s_]+/g, "-") // 空白・アンダースコア → ハイフン
.replace(/-+/g, "-") // 連続ハイフンを圧縮
.replace(/^-+|-+$/g, ""); // 前後のハイフンを整理
}
ハングルが混ざった文章は少し勝手が違います。2ステップ目の許可文字リストにハングル音節(가-힣)を加えれば、ハングルを消さずにそのまま残せます。逆にハングルまで削除して英数字だけのスラッグにしたい場合は、このリストからハングルを外せばよいだけです。
毎回正規表現を手で組み立てる代わりに、下のツールに文章を貼り付ければ2通りの結果をすぐに比べられます。
URLに使うタイトルや文章を入力すると、ハングルを残すかどうかを選んで小文字ハイフンのスラッグをすぐに作れます。

このツールは「ハングルを保持」チェックボックスで2つのモードを切り替えます。オンにするとハングルはそのままに空白と記号だけを整理し、オフにするとハングルも削除して英数字とハイフンだけを残します。既定ではハングルを保持する設定です。
よくつまずくところ
| 状況 | 処理方法 |
|---|---|
| 空白が複数続く | ハイフン1つに圧縮 |
アンダースコア(_)を含む | ハイフンに統一 |
| 文の前後に残るハイフン | 自動で削除 |
| 同じタイトルの記事が2つ以上 | スラッグが重複するので、末尾に番号や日付を付けて区別 |
アンダースコアではなくハイフンを使う慣行は、一部の検索エンジンのクローラーが、アンダースコアでつないだ文字列は1つの単語、ハイフンでつないだ文字列は複数の単語として認識するといわれていることに由来します。ただし、これは検索での表示順位を保証するルールではなく、アドレスの可読性のための慣行だという点は分けて考える必要があります。
まとめ
- スラッグは空白や記号をハイフンと小文字の組み合わせに整理し、URLを短く読みやすくします。
- 正規表現の4ステップ(小文字化 → 記号の削除 → ハイフンの圧縮 → 前後の整理)さえ覚えれば、自分で実装できます。
- ハングルを残すか削除するかはサービスの性格によって異なるので、結果を事前に確認してから選ぶほうが安全です。
URLに使うタイトルや文章を入力すると、ハングルを残すかどうかを選んで小文字ハイフンのスラッグをすぐに作れます。
よくある質問
ハングルのタイトルもスラッグにできますか?
できます。「ハングルを保持」オプションをオンにすると、ハングルはそのままに空白と許可されていない記号だけを整理します。英数字だけで構成されたスラッグが必要なら、オプションをオフにしてハングルまで削除してください。
スラッグの末尾にハイフンが残ったらどうすればいいですか?
正規表現の最後のステップ(.replace(/^-+|-+$/g, ""))で、文字列の前後に残ったハイフンを取り除けば大丈夫です。ツールが生成するスラッグは、この整理まで自動で処理された結果です。
同じスラッグが重複したらどうなりますか?
ルーティングの仕組みが、どの記事を開くべきか判断できなくなります。実務ではスラッグの末尾に番号や日付の文字列を付けて、衝突を避けます。
この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む