Angular 筆記系列(一)項目組織與命名規範

来源:http://www.cnblogs.com/Slim-Shady/archive/2016/06/17/5594191.html
-Advertisement-
Play Games

其實使用 Angular.js 做項目已經很久了,也遇到過許多問題。其中很多問題的出現都是因為沒有按照規範或者最佳實踐來做,大部分原因是學的不夠細,很多 tips 沒 get 到,用到項目中就會出現各種問題,我遇到的問題最多的就是 directive 這塊。很多的 bug都是指令的嵌套引發的。當時自 ...


其實使用 Angular.js 做項目已經很久了,也遇到過許多問題。其中很多問題的出現都是因為沒有按照規範或者最佳實踐來做,大部分原因是學的不夠細,很多 tips 沒 get 到,用到項目中就會出現各種問題,我遇到的問題最多的就是 directive 這塊。很多的 bug都是指令的嵌套引發的。當時自己學的時候很多小 tip 也沒有註意過,打算重新擼一遍文檔,夯實一下基礎。


Angular 的項目結構,常見的有兩種方式:

一丶 類型優先,業務功能其次,當前我們項目就採用的是這種方式:

├── app
│   ├── app.js
│   ├── controllers
│   │   ├── home
│   │   │   ├── FirstCtrl.js
│   │   │   └── SecondCtrl.js
│   │   └── about
│   │       └── ThirdCtrl.js
│   ├── directives
│   │   ├── home
│   │   │   └── directive1.js
│   │   └── about
│   │       ├── directive2.js
│   │       └── directive3.js
│   ├── filters
│   │   ├── home
│   │   └── about
│   └── services
│       ├── CommonService.js
│       ├── cache
│       │   ├── Cache1.js
│       │   └── Cache2.js
│       └── models
│           ├── Model1.js
│           └── Model2.js
├── partials
├── lib
└── test

 

 

二丶業務功能優先,類型其次:

.
├── app
│   ├── app.js
│   ├── common
│   │   ├── controllers
│   │   ├── directives
│   │   ├── filters
│   │   └── services
│   ├── home
│   │   ├── controllers
│   │   │   ├── FirstCtrl.js
│   │   │   └── SecondCtrl.js
│   │   ├── directives
│   │   │   └── directive1.js
│   │   ├── filters
│   │   │   ├── filter1.js
│   │   │   └── filter2.js
│   │   └── services
│   │       ├── service1.js
│   │       └── service2.js
│   └── about
│       ├── controllers
│       │   └── ThirdCtrl.js
│       ├── directives
│       │   ├── directive2.js
│       │   └── directive3.js
│       ├── filters
│       │   └── filter3.js
│       └── services
│           └── service3.js
├── partials
├── lib
└── test


命名規範:
  • 當目錄里有多個單詞時, 使用 lisp-case 語法,項目中的變數一般會採用駝峰命名法:
app
 ├── app.js
 └── my-complex-module
     ├── controllers
     ├── directives
     ├── filters
     └── services

  • 在創建指令時,合適的做法是將相關的文件放到同一目錄下 (如:模板文件, CSS/SASS 文件, JavaScript文件)。如果你在整個項目周期都選擇這種組織方式,
app
└── directives
    ├── directive1
    │   ├── directive1.html
    │   ├── directive1.js
    │   └── directive1.sass
    └── directive2
        ├── directive2.html
        ├── directive2.js
        └── directive2.sass
標記:

保持標簽的簡潔並把AngularJS的標簽放在標準HTML屬性後面。這樣提高了代碼可讀性。標準HTML屬性和AngularJS的屬性沒有混到一起,提高了代碼的可維護性。

<form class="frm" ng-submit="login.authenticate()">
  <div>
    <input class="ipt" type="text" placeholder="name" require ng-model="user.name">
  </div>
</form>

命名約定:
元素命名風格實例用途
Modules lowerCamelCase angularApp  
Controllers Functionality + 'Ctrl' AdminCtrl  
Directives lowerCamelCase userInfo  
Filters lowerCamelCase userFilter  
Services UpperCamelCase User constructor
Services lowerCamelCase dataFactory others

tips:

  • 使用:
    • $timeout 替代 setTimeout
    • $interval instead of setInterval
    • $window 替代 window
    • $document 替代 document
    • $http 替代 $.ajax
 

 


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 十、屬性優先順序 十一、註釋 11.1 <!-- ... --> 同HTML/XML的註釋 11.2 thymeleaf解析器註釋 thymeleaf解析的時候會被註釋,靜態打開時會顯示 單行 <!--/* ... */--> 多行時: <!--/*--> ... ... <!--/*--> 11.3 ...
  • 閱讀本文需要有React的基礎知識,可以在React 入門實例教程和React中文官網進行基礎學習。 沒有React基礎也可以學習本文,本文主要不是學習React,而是gulp+browserify進行模塊化開發。 1.創建項目和環境搭建 我們可以先創建一個文件夾叫react_item,作為項目的根 ...
  • 數據綁定這塊兒沒啥說的,簡單兩個例子帶過了。 Hello World: <!DOCTYPE html> <html ng-app> <head> <title>Simple app</title> <script src="https://ajax.googleapis.com/ajax/libs/ ...
  • 直接貼代碼先看 HTML: CSS: Javascript: 效果圖: PS: jQ和圖片路徑自己載入! ...
  • 這個時候,首先調用Alien構造函數運行,創建一個空對象alien,把構造函數中的this綁定到alien上,然後運行Actor.call(alien,scene,0,0)產生了alien.id=++Actor.nextID,然後添加其它私有屬性,但當又遇到id這個屬性的時候,alien.id=++... ...
  • 1.Promise介紹 Promise最早是社區提出和實現,後面ES6將其寫入標準,並原生提供Promise對象,是一種非同步編程的解決方案,具體的概念大家可以去查看相關的資料。傳統上處理非同步都是以callback回調函數的方式完成,但是當回調嵌套的太多,便會使程式很難理解,如下所示 如果後面還有基於 ...
  • 樣子有點戳,別見怪!O(∩_∩)O哈哈~ ...
  • 塊級元素:div, p(段落), form(表單), ul(無序列表), li(列表項), ol(有序列表), dl(定義列表), hr(水平分割線), menu(菜單列表), table(表格)... 特點:1、塊級元素會獨占一行,其寬度自動填滿其父元素寬度。 2、可以設置width,height ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...