無料のJavaScriptリファレンス。
JavaScriptのネーミングルール
変数や関数名などを名づける時のルールやヒントです。
システムルール
JavaScriptにおけるネーミングルールで、 これは必ず守らないとエラーになったり予期せぬ結果を招いたりします。
- 名前には半角英数字と_と$しか使ってはいけない。
- 予約語は使えない。これはどの言語でも同じです。
- 同じ文字の小文字大文字は区別される。
- 頭文字は半角数字で始まってはいけない。
暗黙のルール
他のプログラマーに見せる時や、 メンテナンスする時の事を考えるとある程度のルールが見えてきます。
これらは、ファイル名やディレクトリー名にも使えます。
単語は英語で
馴れないうちは日本語のローマ字表記でも良いと思っていますが、基本は英語です。
短い名前がよい。
馴れないうちはフルスペルか少し省略した程度でも良いと思っていますが、 なるべく短く省略する。 3〜4文字に収まるとベスト。 略語については略語辞典に書き溜めてあります。
単語の順序を統一する。
標準というべき規格がないので個人の判断となるが、最初の単語を動詞で書き始め、次に目的語を書く事が多い。
私が気をつけているのは、 プログラムから変数や関数を目的別検索した時に便利にしようという事です。 例えば変数名の最初にgetをつけていると、get一覧を検索するとき便利です。
ループカウンター名はお決まりの名前がある。
ループカウンターにはi,j,n,mや、nx,mxがよく使われます。 人によっては、見間違いやすいi,jを避け、nx,mxにする事もあります。 私はi,jを使っていましたが、nxに変えようと思います。
例:for(n1=0;n1<exp;n1++)
関数名は目立たせる。
変数名などと違い、グループの扱いなので他より少し違いがあった方が分かりやすい。
単語の区切り方
camel記法
最初の単語を小文字で始め、以後の単語の先頭文字は大文字にする。
例:yearMonthDay
pascal記法
全単語の先頭文字を大文字にする
例:YearMonthDay
小文字でアンダーバー区切り
全単語を小文字にして、アンダーバーで区切る。
例:year_month_day
大文字でアンダーバー区切り
全単語を大文字にして、アンダーバーで区切る。
例:YEAR_MONTH_DAY
すべての名前を統一するのではなく、これらを組み合わせて使う事が多い。
