ionic之AngularJS扩展动态组件

时间:2022-02-24 15:32:56

目录: 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()也被调动三次后才隐藏。