使用 AngularJS 从零构建大型应用

<div class="panel-heading media clearfix">
<div class="media-body">
<h1 class="media-heading"> 

  • 0、导言
  • 1、准备工作
  • 2、构建框架
  • 3、丰富你的directives
  • 4、公用的services
  • 5、用controllers组织业务
  • 导言

    纵览线上各种AngularJS教程,大部分都是基础与一些技巧分析。 如果你已经能运行你的ng-app,但又找不到实际案例可以参考。那么本文应该对您有所帮助。 本文将以电商产品: 其中的 作为的实际案例,裸奔展示如何从零构建 “自以为大型的” AngularJS应用。 应用基于AngularJS 1.2.24版本。

    准备工作

    1、我们使用了以类型优先的目录结构。 ├── js │   ├── app.js │   ├── directives.js │   ├── services.js │   ├── controllers │   │   ├── BaseController.js // controller基类 │   │   ├── Customer.js // 顾客管理 │   │   ├── Product.js // 商品管理 │   │   ├── Order.js // 订单管理 │   │   ├── Domain.js // 域名管理 │   │   ├── Payment.js // 收款方式 │   │   └── ... // 其他各种controller │   ├── directives │   │   ├── ysBtn.js // 按钮组件 │   │   ├── ysCalendar.js // 日历组件 │   │   ├── ysImgeditor.js // 图片编辑器 │   │   ├── ysPopWindow.js // 模态弹窗组件 │   │   └── ... // 其他各种组件 │   └── services │   │   ├── Graphic.js // 图片文件处理service │   │   ├── Popup.js // 弹层service │   │   ├── Uri.js // 与Uri相关操作service ($http等ajax操作封装于此) │   │  └── ... // 其他各种service │   ├── config │   │   ├── Navigation.js // 主导航配置 │   │   ├── Route.js // 路由配置 │   │   ├── RouteProvider.js // 配置$routeProvider │   │   ├── OnRootScope.js // 为$rootScope配置$onRootScope方法 │   │   ├── SceDelegate.js // 配置$sceDelegateProvider │   │   ├── Uri.js // 后端服务API配置 │   │   └── ... // 其他各种config ├── lib │   ├── bower_components │   │   ├── angular │   │   │   ├── angular.min.js │   │   │   └── ... │   │   ├── angular-route │   │   ├── angular-sanitize │   │   ├── angular-route │   │   └── ... // 其他bower管理的lib │   ├── URI.min.js │   ├── class.js │   └── ... // 其他手动管理的lib ├── img ├── css └── html // controllers对应的views的模板

    2、使用less作为css的预处理器。 3、使用bower管理依赖的JS库。 4、使用grunt作为项目打包工具。 5、使用fiddler4作为http请求调试工具。 6、为了可以使用庞大的jquery插件库,我们也引入了jquery。 7、controllers、directives、services 等部分的设计参考自:

    准备了半天,访问如下的index页面,angular 的应用是时候跑起来了。

    应用代码展示

    一个实际的案例看起来总是要比教程复杂些。下面是项目启动后店铺后台的概貌。

    店铺后台

    什么?不是说好的从零开始构建吗?怎么就跑起来了? 好吧,请把上面这个预览图当做设计稿。我们开始构建框架。

    构建框架

    根据设计,从结构上将页面划分为

    顶部

    导航 内容
    导航的点击会改变浏览器当前的url,内容区域渲染对应模块的内容。

    下面开始配置angularJS,来达到上面的目标。 在 js/app.js 配置 YeeshopManager 这个 module,并将它的引用赋值到全局变量YeeshopManagerModule,方便后续继续对其进行配置。

    配置module

    为了方便管理众多directives与services。我们分别创建了 js/directives.js 集合所有directives的module - YeeshopManager.directives

    配置directives

    js/services.js 集合所有services的module - YeeshopManager.services

    配置services

    接下来,配置应用为不同路径的请求调用对应的 controller与模板 在 config/Route.js 中先定义好的规则

    配置Route.js

    在 config/RouteProvider.js 中配置 $routeProvider

    配置$routeProvider

    当我们使用 #/guide 路径访问店铺后台的新手引导页面的时候,

    ngview

    ngRoute将为这个index文件上带有ng-view的节点渲染对应的模板 guide.html 并且运行对应的 GuideController。

    结构上划分的三个区域对应的controller的关系 顶部 -> TopbarController 导航 -> ysNavigationController 内容 -> 由ngRoute动态的根据当前url和配置,加载对应模块的内容。 至此,大体的结构已经完成。

    每个Controller创建的$scope都能独立很好的运行,但有时$scope之间也需要通讯。这时,我们需要为$rootScope配置一个方法,来完成这个工作。

    在 config/OnRootScope.js 中配置 $rootScope

    配置rootScope

    使用$provide的decorator方法在$rootScope注册的时候,注入一个 $onRootScope 的方法。

    需要被通知的$scope调用 $onRootScope来监听事件'notification', 发出通知的controllers,directives,或 services中,只需要注入 $rootScope 服务。就可以很方便的进行通知。

    收到通知

    作为一款SAAS产品,支持商家自行绑定域名,让用户更好的记住您的域名和品牌。

    angularJS构建的应用程序,需要将静态资源部署在CDN上,来保证用户访问的快速流畅。 那么,如果我绑定了 ,店铺后台的地址就会是 , 这时CDN静态资源的地址会是形如 。 当应用的host 和引用资源的host 不一致时, angular会告诉你 Error: [$sce:insecurl],资源因安全策略而加载失败。

    配置资源白名单$sceDelegateProvider.resourceUrlWhitelist,允许angular跨域请求指定的url的资源。

    白名单

    至此,我们完成对YeeshopManagerModule的配置。

    丰富你的directives

    框架构建完成了,参考第二节中的设计稿,接下来我们需要为系统添加各种UI组件。比如图标、按钮、下拉菜单、弹窗。依照angularJS创始人Misko Hevery设计的初衷: “构建UI应该是声明式的。” 那么,我们也设计自己的规则,来声明UI组件:

    图标 按钮 下拉菜单 弹窗 ……

    完成了以上的思(yi)考(yin),我们着手来声明图标组件。

    声明图标组件

    声明完成后,我们在模板里面进行调用。

    
    

    经过angularJS的编译之后输出的节点与实际效果。

    图标效果

    对于这个通用的自定义标签,我们习惯用“组件”来称呼他。在angularJS中,称为一个directive。官方文档中的定义请

    使用强大的directive。我们可以将系统中需要复用的所有组件、甚至一个复用的行为全部抽象出来。当你需要使用的时候,你只是需要声明他。 例如,一个旋转的图标:

    
    

    项目早期规划的directive

    展示

    按照需求增加了水印编辑器directive

    水印编辑器

    方便商户编辑图片,增加了图片编辑器directive

    图片编辑器

    这时候,前端工程师的问题就来了:“还有多少directives?”

    暴走

    答:纵观整个项目的生命周期,所有的directive不可能在初始便全部设计并构建好。请在项目进行的过程中,按需的增加或修改、丰富你的directive,不断提升你构建view的效率。

    依照上文构建与调用directive的经验。在实际项目中,我们在模块中需要10个ico,那么我们便在其模板中调用十次的标签。

    那么前端工程师的问题又来了:“如果模块的交互需要弹窗,难不成我要先算好有多少个?然后全部先在模块里面声明,并使用ng-show="false"全部隐藏起来?”

    暴走

    Don't worry.不要被 限制了您的思维。换一个姿势 Thinking in jquery。 当我们需要一个弹窗的时候,按照往常的做法,便是在你页面架构预设好的位置(例如页面底部),插入弹窗的dom结构。 没错,弹窗还是这样实现,不同的是。我们插入的是弹窗的directive。 类似以下(简化代码未测试,仅为示例):

    ')($scope));
    

    我们通过动态插入directive解决了上面这个问题。但我总不能每个模块都写弹窗dom的插入吧。 这个时候,我们需要service。

    公用的services

    各种services为店铺后台提供了统一的api接口调用,图像处理,弹层处理,实用工具等。 通过上面的目录,我们可以看到services文件夹下,有定义$Popup的Popup.js。 (简化代码未测试,仅为示例)

    service代码

    注入到您所需的模块后,愉快的调用吧!

    用controllers组织业务

    一切就绪,开始堆业务代码!

    用controllers图片

    <div class="fluidbox-wrap" style="z-index: 990;">

    <img style="opacity: 1;" src="https://www.jb51.cc/res/2019/02-08/14/e85ef62a58a41e7096ecae09a94ffe43.png" alt="用controllers代码">

    裸奔展示到此结束~有劳看官,若有任何错漏~烦请指正~

    转:http://ruby-china.org/topics/24111

      </div>

    相关文章

    ANGULAR.JS:NG-SELECTANDNG-OPTIONSPS:其实看英文文档比看中...
    AngularJS中使用Chart.js制折线图与饼图实例  Chart.js 是...
    IE浏览器兼容性后续前言 继续尝试解决IE浏览器兼容性问题,...
    Angular实现下拉菜单多选写这篇文章时,引用文章地址如下:h...
    在AngularJS应用中集成科大讯飞语音输入功能前言 根据项目...
    Angular数据更新不及时问题探讨前言 在修复控制角标正确变...