ionic之AngularJS扩展动态组件

目录： 1. 模态对话框 : $ionicModal 2. 上拉菜单 : $ionicActionSheet 3. 弹出框 : $ionicPopup 4. 浮动框 : $ionicPopover 5. 载入指示器 : $ionicLoading 6. 背景幕 : $ionicBackdrop

1. 模态对话框 : $ionicModal

模态对话框 : $ionicModal 模态对话框常用来供用户进行选择或编辑，在模态对话框关闭之前，其他 的用户交互行为被阻止。

在ionic中使用模态对话框有三个步骤：

1.声明对话框模板

使用ion-modal-view指令声明对话框模板，对话框模板通常置入 script内以构造内联模板：

<script id="a.html" type="text/ng-template"> <ion-modal-view> </ion-modal-view> </script>

2.创建对话框对象

服务$ionicModal有两个方法用来创建对话框对象：

• fromTemplate(templateString,options) - 使用字符串模板
• fromTemplateUrl(templateUrl,options) - 使用内联模板 这两个方法返回的都是一个对话框对象。

3.操作对话框对象

对象框对象有以下方法用于显示、隐藏或删除对话框：

• show() - 显示对话框
• hide() - 隐藏对话框
• remove() - 移除对话框
• isShown() - 对话框是否可视？

2. 上拉菜单 : $ionicActionSheet

上拉菜单是一个自屏幕底部向上滑出的菜单，通常用来让用户做出选择。

ionic的上拉菜单由三种按钮组成，点击任何按钮都自动关闭上拉菜单：

取消按钮 - 取消按钮总是位于菜单的底部，用户点击该按钮将关闭。一个上拉菜单 最多有一个取消按钮。 危险选项按钮 - 危险选项按钮文字被标红以明显提示。一个上拉菜单最多有一个 危险选项按钮。 自定义按钮 - 用户定义的任意数量的按钮。 在ionic中使用上拉菜单需要遵循以下步骤：

1.定义上拉菜单选项

使用一个JSON对象定义上拉菜单选项，包括以下字段：

• titleText - 上拉菜单的标题文本
• buttons - 自定义按钮数组。每个按钮需要一个描述对象，其text字段用于按钮显示
• cancelText - 取消按钮的文本。如果不设置此字段，则上拉菜单中不出现取消按钮
• destructiveText - 危险选项按钮的文本。如果不设置此字段，则上拉菜单中不出现危险选项按钮
• buttonClicked - 自定义按钮的回调函数，当用户点击时触发
• cancel - 取消按钮回调函数，当用户点击时触发
• destructiveButtonClicked - 危险选项按钮的回调函数，当用户点击时触发
• cancelOnStateChange - 当切换到新的视图时是否关闭此上拉菜单。默认为true
• cssClass - 附加的CSS样式类名称

2.创建上拉菜单

$ionicActionSheet服务的show()方法用来创建上拉菜单，返回一个函数，调用该 返回函数可以关闭此菜单。

3.弹出框 : $ionicPopup

弹出框通常用于提醒、警告等，在用户响应之前其他交互行为不能继续。与模态 对话框覆盖整个屏幕空间不同，弹出框通常仅占据一部分屏幕空间。

在ionic中，使用$ionicPopup服务管理弹出框：

$ionicPopup.show(options)
.then(function(){
//这个函数在弹出框关闭时被调用
});

show()方法返回的是一个promise对象，当弹出框关闭后，该对象被解析，这意味着 then()方法指定的参数函数此时将被调用。

show()方法的参数options是一个JSON对象，可以包括以下字段：

• title - 弹出框标题文本
• subTitle - 弹出框副标题文本
• template - 弹出框内容的字符串模板
• templateUrl - 弹出框内容的内联模板URL
• scope - 要关联的作用域对象
• buttons - 自定义按钮数组。按钮总是被置于弹出框底部
• cssClass - 附加的CSS样式类

简化的特定弹出框

除了show()方法，$ionicPopup还针对一些特定场景提供了简化的方法，这些方法不需要 自定义按钮，只需要设置title和template即可：

• alert(options) - 警告弹出框，仅包含一个按钮供关闭弹出框
• confirm(options) - 确认弹出框，包含一个取消按钮和一个确认按钮
• prompt(options) - 输入提示弹出框，包含一个文本输入框、一个取消按钮和一个确认按钮

4.浮动框 : $ionicPopover

浮动框通常用以非侵入的方式提供当前视图的额外信息。

在ionic中使用浮动框的几个步骤：

1.声明模板

需要首先利用ion-popover-view指令声明一个模板内容：

<ion-popover-view>
<!--模板内容-->
</ion-popover-view>

2.创建浮动框对象

使用$ion-popover服务的以下方法创建浮动框对象：

• fromTemplate(templateString,options) - 使用模板字符串构造浮动框
• fromTemplateurl(templateUrl,options) - 使用内联模板构造浮动框

注意：这两个方法返回的都是promise对象，在浮动框对象被构造 成功后得到解析，这时可以获取浮动框对象：

$ionicPopover.fromTemplate(...)
.then(function(popover){
//popover参数是浮动框对象
});

3.操作浮动框对象

浮动框对象提供以下方法：

show() - 显示浮动框 hide() - 关闭浮动框 remove() - 移除浮动框 isShown() - 浮动框是否处于显示状态？

5.载入指示器 : $ionicLoading

当进行耗时的操作时，可以使用载入指示器提示用户操作进行中，并暂时阻止交互。 载入指示器通常会叠加一个半透明的幕布层以便阻止用户的交互。

在ionic中，使用$ionicLoading服务操作载入指示器：

• show(options) - 显示载入指示器
• hide() - 隐藏载入指示器

显示参数

show()方法的options参数是一个JSON对象，可以包含如下字段：

• template - 模板字符串
• templateUrl - 内联模板的Url
• scope - 要绑定的作用域对象
• noBackdrop - 是否隐藏背景幕
• hideOnStateChange - 当切换到新的视图时，是否隐藏载入指示器
• delay - 显示载入指示器之前要延迟的时间，以毫秒为单位，默认为0，即不延迟
• duration - 载入指示器持续时间，以毫秒为单位。时间到后载入指示器自 动隐藏。默认情况下， 载入指示器保持显示状态，知道显示的调用hide()方法

参数配置服务 : $ionicLoadingConfig

如果要在多处都使用载入指示器，统一对options参数进行配置是一个更好的方法，这样 在应用时直接调用show()方法而不必传递参数了。这通过定义一个constant provider来实现：

angular.module("ezApp", ["ionic"])
.constant("$ionicLoadingConfig",{
template : "default loading template ..."
})

$ionicLoading服务会通过注入器查找这个常量，如果存在就使用其值作为参数进行显示。

6.背景幕 : $ionicBackdrop

在浮动框、载入指示器中我们已经接触过背景幕。它是一个覆盖全屏的半透明图层，用来 阻止用户的交互行为。

我们可以使用*$ionicBackdrop*服务单独地使用背景幕：

• retain() - 保持背景幕
• release() - 释放背景幕 为什么不是show()和hide()呢？

在UI中可能有多个指令/元素都使用背景幕，为每个指令都创建单独的背景幕是不明智的。

事实上，$ionicBackdrop服务在DOM中只保留有一个背景幕。每次当使用retain()方法时， 只是给背景幕加一次锁，release()方法只是给背景幕解一次锁。如果retain()被调用三次， 背景幕将一直显示，直到release()也被调动三次后才隐藏。