Patakaran sa istilo ng JavaScript
Palaging gamitin ang parehong tuntunin ng pagsusulit para sa lahat ng iyong mga proyekto ng JavaScript.
Tuntunin ng pagsusulit ng JavaScript
Ang tuntunin ng pagsusulit (Coding conventions) ay tinutukoy sa:Gawain ng patakaran sa istilo ng pagsusulitAng mga prinsipyo na ito ay karamihan kasama ang:
- Tuntunin sa pangalang at pagdeklara ng variable at function
- Tuntunin sa paggamit ng espasyo, pagkakalat at komento
- Paggamit ng patakaran at kautusan sa pagsusulit
Tuntunin ng pagsusulitTiyakin ang kalidad:
- Pagpapabuti ng pagkakakita ng kodigo
- Pagtaas ng kahusayan ng pagpapanatili ng kodigo
Ang tuntunin ng pagsusulit ay maaaring maging isang pahayag ng patakaran na pinapagsubaybay ng pangkat o ang iyong personal na karanasan sa pagsusulit.
Ang pahina na ito ay naglalarawan ng pangkalahatang tuntunin ng JavaScript na ginagamit ng CodeW3C.com.
Dapat kang patuloy na basahin ang susunod na kabanata na 'Pinakamahusay na Paggamit', upang matututunan kung paano maiwasan ang mga kalokohan sa pagsusulit.
Pangalan ng variable
Sa CodeW3C.com, gumagamit kami ng CamelCase para sa pangalan ng identifier (variable at function);CamelCase。
Ang lahat ng pangalan ay nagsisimula sa:LetraPangunahin.
Sa ibabaw ng pahina na ito, magsasalita kami ng mas malawak na tungkol sa patakaran ng pangalan.
firstName = "Bill"; lastName = "Gates"; price = 19.90; tax = 0.20; fullPrice = price + (price * tax);
Espasyo sa paligid ng operator
Palaging magdagdag ng espasyo sa paligid ng operator ( = + - * / ) at pagkatapos ng kumon;
Sample
var x = y + z; var values = ["Volvo", "Saab", "Fiat"];
Pag-indent ng code
Palaging gamitin ang 4 espasyo para sa pag-indent ng bloke ng code:
Fn
function toCelsius(fahrenheit) {
return (5 / 9) * (fahrenheit - 32);
}
Huwag gamitin ang tab sa pag-indent. Ang iba't ibang editor ay may magkakaibang pagpaliwanag sa tab;
Patakaran ng pangungusap
Pangkalahatang mga patakaran para sa simple na pangungusap:
Palaging magwakas ang isang pangungusap sa isang pahintulot:
Sample
var values = ["Volvo", "Saab", "Fiat"];
var person = {
firstName: "Bill",
lastName: "Gates",
age: 50,
eyeColor: "blue"
};
Pangkalahatang mga patakaran para sa komplikadong pangungusap (compound):
- Magulat sa unang linya ang bukas na kuwadrado;
- Gamit ang espasyo bago ang bukas na kuwadrado;
- Magulat sa bagong linya ang pagsasara ng kuwadrado na pahintulot, walang maagap na espasyo;
- Huwag gamitin ang pahintulot sa pagwakas ng komplikadong pangungusap;
Fn:
function toCelsius(fahrenheit) {
return (5 / 9) * (fahrenheit - 32);
}
Siklik:
for (i = 0; i < 5; i++) {
x += i;
}
Kundisyon:
if (time < 20) {
greeting = "Good day";
} else {
greeting = "Good evening";
}
Patakaran ng object
Pangkalahatang mga patakaran para sa paglalarawan ng object:
- Ilagay ang bukas na kuwadrado at pangalan ng object sa parehong linya;
- Gamit ang tuldok at espasyo sa pagitan ng bawat attribute at kanyang halaga;
- Huwag maglagay ng kumon sa likod ng huling magkakasamang halaga ng attribute;
- Magulat sa bagong linya ang pagsasara ng kuwadrado na pahintulot, walang maagap na espasyo;
- Palaging magwakas ang paglalarawan ng object sa isang pahintulot;
Sample
var person = {
firstName: "Bill",
lastName: "Gates",
age: 19,
eyeColor: "blue"
};
Maari kang isahin ang maikling object sa isang linya, gamit lamang ang espasyo sa pagitan ng mga attribute, tulad nito:
var person = {firstName:"Bill", lastName:"Gates", age:50, eyeColor:"blue"};
Length of line less than 80
Upang mapababangon ang pagbasa, iwasan ang paggamit ng linya na higit sa 80 na karakter.
Kung ang haba ng JavaScript statement ay higit sa isang linya, ang pinakamagandang lugar para sa pagpalit ng linya ay sa pagkatapos ng operator o komma.
Sample
document.getElementById("demo").innerHTML =
"Hello Kitty.";
Pangalanang Patakaran
Mangyaring gamitin ang parehong pangalan sa lahat ng iyong code. Halimbawa:
- Ang pangalan ng variable at function ay gamitinCamelCaseUpang isulat
- Ang mga global variable ay gamitinBigyan ng kapangyarihan(Hindi namin ginagawa ito, ngunit lubos na kalat ito sa paggamit)
- Ang mga constant (tulad ng PI) ay gamitinBigyan ng kapangyarihan
Kung dapat gamitin sa pangalan ng variableHyphen,CamelCaseOUnderscoreBa?
Ito ang problema na palagian tinatalakay ng mga programer. Ang sagot ay depende sa kung sino ang tumatanggap ng tanong:
Ang hyphen sa HTML at CSS:
Ang mga attribute ng HTML5 ay maaaring magsimula sa data- (data-quantity, data-price).
Ang CSS ay gumagamit ng hyphen sa property-names (font-size).
Ang hyphen ay maaaring maling ituring na operator ng pagbawas. Ang pangalan ng JavaScript ay hindi pinapayagan ang paggamit ng hyphen.
Underscore:
Maraming programer ang gustong gumamit ng underscore (date_of_birth), lalo na sa SQL database.
Ang underscore ay kadalasang ginagamit sa mga reference ng PHP.
PascalCase (PascalCase):
Ang mga programer ng C na wika ay kadalasang gumagamit ng PascalCase (PascalCase).
CamelCase:
Ang JavaScript, jQuery at iba pang library ng JavaScript ay gumagamit ng camelCase (camelCase):
Huwag magsimula ang pangalan ng JavaScript gamit ang simbolo ng dolyar ($). Ito ay magdudulot ng konflikto sa pangalan ng JavaScript.
Loading JavaScript sa HTML
Gumamit ng simple na syntax upang ilagay ang panlabas na script (ang attribute na type ay hindi kinakailangan):
<script src="myscript.js"></script>
Accessing HTML elements
Ang konsekwensya ng paggamit ng "di-magandang" HTML style ay maaaring dahilan ng error sa JavaScript.
Ang dalawang ganitong JavaScript statement ay magbibigay ng magkakaibang resulta:
var obj = getElementById("Demo")
var obj = getElementById("demo")
Kung posibleng, gamitin ang parehong pangalan sa HTML (katulad ng JavaScript).
文件扩展名
HTML 文件应该使用 .html 扩展名（而非 .htm）。
CSS 文件应该使用 .css 扩展名。
JavaScript 文件应该使用 .js 扩展名。
使用小写文件名
大多数 web 服务器（Apache、Unix）对文件名的大小写敏感：
london.jpg 无法视作 London.jpg 进行访问。
其他 web 服务器（微软的 IIS）对大小写不敏感：
london.jpg 能够以 London.jpg 或 london.jpg 来访问。
如果您混合使用大小写，则必须严格保持连续和一致。
如果您将站点从大小写不敏感的服务器转移至对大小写敏感的服务器，即使这种小错误也可能破坏您的网站。
为了避免这些问题，请始终使用小写文件名（如果可能）。
性能
计算机不会使用代码约定。大部分规则对程序的执行影响很小。
缩进和额外的空格对小段脚本并不重要。
对于开发中的脚本，应该优先考虑可读性。应该缩小更大型的生产脚本。
