ExtJS 基本介紹 - 1. 命名規則

ExtJS Class system設計目標在維持嚴謹的Class-based System,且不放棄Javascript原本所具備之動態相容性,在兩者之間去蕪存菁,以期創造一套簡單易學、容易開發、容易除錯、良好相容性、良好擴充性與好維護的架構.

ExtJS的class命名規則:

  • class名稱允許為{英文字母,數字},但是建議少用數字命名.不允許使用其他特殊符號(如: '_','-',...).
  • 最上層namespace與class名稱皆採用Pascal Casting,其他階層的namespace採用Camel Casting,單字縮寫也請遵循此Naming Rule.


MyCompany.useful_util.Debug_Toolbar (X) - 包含特殊符號
MyCompany.util.Base64
MyCompany.data.CoolProxy
MyCompany.ApplicationMyCompany.form.action.AutoLoad
Ext.data.JsonProxy
Ext.data.JSONProxy (X) - JSON未遵循Camel Casting
MyCompany.util.HtmlParser
MyCompary.parser.HTMLParser (X) - HTML未遵循Camel Casting
MyCompany.server.Http
MyCompany.server.HTTP (X) - HTTP未遵循Camel Casting

:Top-Level namespace
:Class name

Pascal Casting: 開頭大寫,單字與單字之間第一個字母為大寫.
Camel Casting: 開頭小寫,單字語單字之間第一個字母為大寫.

ExtJS的js置放規則:

class命名規則會決定js檔置放位置:
ext.js -> web/ext/ext.js
Ext.util.Observable -> web/ext/src/Ext/util/Observable.js
Ext.form.action.Submit -> web/ext/src/Ext/form/action/Submit.js
MyCompany.chart.axis.Numeric -> web/ext/src/MyCompany/chart/axis/Numeric.js

ExtJS的Method/Varibles/Property命名規則:

  • Method/Varibles/Property名稱允許為{英文字母,數字},但是建議少用數字命名.不允許使用其他特殊符號(如: '_','-',...).
  • Method/Varibles/Property採用Camel Casting方式命名.
  • Property特殊命名規則,當靜態變數採用全大寫命名.

Ext.MessageBox.YES = "Yes"
Ext.MessageBox.NO = "No"
MyCompany.alien.Math.PI = "4.13"

沒有留言:

橫式廣告