.open(options)
打开对话窗口,在每次调用时创建新的对话框实例。接受对象作为唯一的参数。
参数选项Options:
template {String}
对话框模板可以通过所给路径加载外部html模板或type=”text/ng-template”的script标签。
<script type="text/ng-template" id="templateId"> <h1>Template heading</h1> <p>Content goes here</p> </script>
ngDialog.open({ template: 'templateId' });
当然,还可以使用简单的字符串作为模板和plain选项。
tips:
并不一定要将外部html模板放在script标签中。可以将模板放在
$templateCache中:
angular.module('dialog.templates').run(['$templateCache',function($templateCache) {
$templateCache.put('templateId','template content');
}]);
然后可以将dialog.templates模块包含在主模块的依赖项中,并开始使用该模板作为templateId:
无需手动执行这些操作,可以使用插件。 它们可用于不同的构建系统,包括最受欢迎的Gulp / Grunt:
plain {Boolean}
默认为false,如果为true则允许使用纯字符串作为模板。
ngDialog.open({ template: '<p>my template</p>',plain: true });
controller {String} | {Array} | {Object}
controller是对话窗口的控制器。 控制器可以通过名称引用或直接内联来指定。
ngDialog.open({
template: 'externalTemplate.html',controller: 'SomeController'
});
//或者
ngDialog.open({
template: 'externalTemplate.html',controller: ['$scope','otherService',function($scope,otherService) {
// controller logic
}]
});
controllerAs {String}
可以选择为控制器指定controllerAs参数。 然后在你的模板里面,可以把这个控制器引用给controllerAs指定的值。
AngularJS团队目前推荐使用controllerAs语法。
resolve {Object.<String,Function>}
(可选)给控制器注入依赖关系映射。 如果这些依赖关系中的任何一个都是promises【这里的promise不知道怎么翻】,ngDialog将等待所有这些依赖关系解决,或者一个被拒绝,然后才能实例化控制器。
如果所有的promises都成功解决了,解决的promises值就会被注入。
映射对象如下:
- key – {String}: 要注入控制器的依赖项的名称。
- factory - {String | Function}:如果是String类型,那么它是一个服务的别名。如果是Function,那么它将使用$ injector.invoke进行注入,返回依赖关系。如果返回的是一个promises,则在将其值注入到控制器之前解决。
ngDialog.open({
controller: function Ctrl(dep) {/*...*/},resolve: {
dep: function depFactory() {
return 'dep value';
}
}
});
scope {Object}
将scope对象传递给对话框。如果使用具有单独的$scope服务的控制器,则此对象将被传递到$scope.$parent:
$scope.value = true;
ngDialog.open({
template: 'externalTemplate.html',className: 'ngdialog-theme-plain',scope: $scope
});
<script type="text/ng-template" id="externalTemplate.html">
<p>External scope: <code>{{value}}</code></p>
</script>
scope.closeThisDialog(value)
.closeThisDialog(value)方法被注入到传递的$ scope中。这可以直接关闭弹出的对话框,例如:
<div class="dialog-contents">
<input type="text"/>
<input type="button" value="OK" ng-click="checkInput() && closeThisDialog('Some value')"/>
</div>
传递给此函数的任何值将附加到该对话框对象上。 对于使用openConfirm()方法打开的对话框,这个值被用作reject reason。
data {String | Object | Array}
data表示任何要存储在控制器对话框范围内的可序列化数据。
($scope.ngDialogData)。 从版本0.3.6 $scope.ngDialogData保持对对象的引用,而不是复制它们。
className {String}
此选项用于控制对话框的外观,可以使用内置主题或创建自己的样式模式。
ngDialog.open({ template: 'templateId',className: 'ngdialog-theme-default' });
注意:如果没有提到className,对话框将无法正确显示。
appendClassName {String}
不同于className属性通过setDefaults()方法覆盖指定的任何默认类,appendClassName允许在任何默认值之上添加一个类。
ngDialogProvider.setDefaults({ className: 'ngdialog-theme-default' });
ngDialog.open({ template: 'template.html',appendClassName: 'ngdialog-custom' });
disableAnimation {Boolean}
如果为true,则对话框的动画将被禁用,默认为false。
overlay {Boolean}
如果为false,则在dialog框中隐藏重叠div,默认为true。
showClose {Boolean}
如果为false,则隐藏dialog框关闭按钮,默认为true。
closeByEscape {Boolean}
通过单击Esc键关闭对话框,默认为true。
如果同时打开几个对话框,单击Esc键将关闭所有打开的对话框。
closeByNavigation {Boolean}
关闭对话框的状态变更(history.back,$ state.go等),默认为false。 兼容ui-router和angular-router。如果需要在返回或更改状态时关闭对话框,应该将此值设置为true。 如果需要在应用中更改状态时,对话框保持打开状态,应该将此值设置为false。
如果同时打开其中的几个,状态变更将关闭所有打开的对话框。
通过点击覆盖背景关闭对话框,默认为true。
appendTo {String}
指定元素添加到对话框实例上,接受字符串选择器(例如#yourId,.yourClass)。 如果没有指定则默认将body添加到对话框。
cache {Boolean}
如果为false则禁用dialog缓存。 默认为true,用于开发目的。
name {String} | {Number}
给出一个对话框实例的名称。 如果打开了多个对话框,则识别特定对话框很有用。
onOpenCallback {String} | {Function}
在打开对话框后提供要调用的函数或函数的名称。可以使用此回调代替ngdialog.opened事件。当对话框附加到DOM并将要向用户显示时提供了一种注册hook的方法。
preCloseCallback {String} | {Function}
在关闭对话框之前提供要调用的函数或函数的名称。如果该选项中指定的回调函数返回false,则对话框将不会关闭。或者,如果回调函数返回一个解决的promise,对话框将被关闭。
preCloseCallback函数接收作为与.close(id,value)相同的参数值。
主要功能是能够弹出对话框。包含用户操作(例如编辑数据),能够在退出对话框时(例如通过转义键)确认是否丢弃未保存的更改。
此示例在preCloseCallback函数中使用带有window.confirm调用的内联函数:
ngDialog.open({
preCloseCallback: function(value) {
if (confirm('Are you sure you want to close without saving your changes?')) {
return true;
}
return false;
}
});
在另一个示例中,使用具有嵌套确认ngDialog的回调函数:
ngDialog.open({
preCloseCallback: function(value) {
var nestedConfirmDialog = ngDialog.openConfirm({
template:'\
<p>Are you sure you want to close the parent dialog?</p>\
<div class="ngdialog-buttons">\
<button type="button" class="ngdialog-button ngdialog-button-secondary" ng-click="closeThisDialog(0)">No</button>\
<button type="button" class="ngdialog-button ngdialog-button-primary" ng-click="confirm(1)">Yes</button>\
</div>',plain: true
});
// NOTE: return the promise from openConfirm
return nestedConfirmDialog;
}
});
trapFocus {Boolean}
如果为true,则可确保聚焦的元素保持在对话框内以符合可访问性建议。 默认值为true。
preserveFocus {Boolean}
如果为true,则关闭对话框后将焦点恢复到启动它的元素上。旨在改善键盘辅助功能。默认为true。
ariaAuto {Boolean}
如果为true,则自动为任何未指定的辅助功能属性选择适当的值。默认为true。
@H_736_404@ariaRole {String}指定应用于对话框元素的角色属性的值。默认值为null(未指定)。
ariaLabelledById {String}
指定应用于对话框元素的aria-labelledby属性的值。默认值为null(未指定)。
如果指定,则该值不会针对DOM进行验证。
ariaLabelledBySelector {String}
指定对象元素上由aria-labelledby属性引用的元素的CSS选择器。默认值为null(未指定)。
如果指定,则使用第一个匹配元素。
ariaDescribedById {String}
指定应用于对话框元素的aria描述的属性的值。默认值为null(未指定)。
如果指定,则该值不会针对DOM进行验证。
ariaDescribedBySelector {String}
指定对象元素上由aria描述的属性引用的元素的CSS选择器。默认值为null(未指定)。
如果指定,则使用第一个匹配元素。
width {Number | String}
此选项用来控制对话框的宽度。默认值为null(未指定)。
//宽度为400px
ngDialog.open({
template: 'template.html',width: 400 });
//自定义百分比宽度
ngDialog.open({
template: 'template.html',width: '40%' });
height {Number | String}
此选项用来控制对话框的高度。默认值为null(未指定)。
//高度为400px
ngDialog.open({
template: 'template.html',height: 400 });
//自定义百分比高度
ngDialog.open({
template: 'template.html',height: '40%' });
返回值Returns:
id {String}
这是刚刚创建的对话框的ID。 它是对话框的DOM元素上的ID。
close(value) {Function}
这是一个函数,它将关闭当前调用open()打开的对话框。 它需要一个可选的值来传递给接近的promise。
closePromise {Promise}
当对话框关闭时,将会解决promise。通过一个对象,包含:
- id-关闭对话框的ID
- value-关闭的对话框的值
- $dialog-此时已从DOM中删除的对话框元素
- remainingDialogs-其余的对话框仍然打开
如果对话框被其中一个内置机制(’$escape’,‘$closeButton’ 或者 ‘$document’.)关闭,value属性将是一个特殊的字符串。
var dialog = ngDialog.open({
template: 'templateId'
});
dialog.closePromise.then(function (data) {
console.log(data.id + ' has been dismissed.');
});
.setDefaults(options)
通过ngDialogProvider设置默认设置:
var app = angular.module('myApp',['ngDialog']);
app.config(['ngDialogProvider',function (ngDialogProvider) {
ngDialogProvider.setDefaults({
className: 'ngdialog-theme-default',plain: true,showClose: true,closeByDocument: true,closeByEscape: true
});
}]);
.openConfirm(options)
打开一个对话框,默认情况下,在对话窗口中点击转义或点击时,该对话框不会关闭。该函数返回根据对话框关闭方式解析或拒绝的promise。
参数选项Options:
这个方法的参数选项与.open()方法相同,并添加了一个额外的函数:
scope.confirm()
方法.confirm()也被注入到传递的$ scope中。使用此方法关闭对话框并解决打开模态时返回的promise。
该函数接受一个可选参数,该参数用作解析的promise的值。
<div class="dialog-contents">
Some message
<button ng-click="closeThisDialog()">Cancel</button>
<button ng-click="confirm()">Confirm</button>
</div>
返回值Returns:
如果使用.confirm()函数来关闭对话框可以解决的Angular promise对象,否则promise被拒绝。解析值和拒绝原因由传递给confirm()或closeThisDialog()调用的值定义。
.isOpen(id)
方法接受对话框的id,并返回一个布尔值,指示指定的对话框是否打开。
.close(id,value)
方法接受对话框的id作为字符串参数来关闭特定的对话窗口,如果没有指定id,它将关闭所有当前活动的模式(与.closeAll()相同的行为)。使用(或所有对话框promise)解决对话框promise的可选值。
.closeAll(value)
方法管理关闭页面上的所有活动模式。 使用可选值来解决所有的对话框promise。
.getOpenDialogs()
返回包含打开的对话框的ID的数组。
.setForceHtmlReload({Boolean})
在每个$ locationChangeSuccess事件上添加一个附加侦听器,并将html的更新版本转换为对话框。
在某些罕见的情况下,当应用依赖于DOM更改时,可能会有用,默认为false。
在ngDialogProvider中配置:
var app = angular.module('exampleApp',['ngDialog']);
app.config(function (ngDialogProvider) {
ngDialogProvider.setForceHtmlReload(true);
});
.setForceBodyReload({Boolean})
在每个$ locationChangeSuccess事件上添加额外的侦听器,并将更新版本的body转换为对话框。
在某些罕见的情况下,当应用依赖于DOM更改时,可能会有用,默认为false。
在ngDialogProvider中配置:
var app = angular.module('exampleApp',['ngDialog']);
app.config(function (ngDialogProvider) {
ngDialogProvider.setForceBodyReload(true);
});
.setOpenOnePerName({Boolean})
默认值:false
定义是否同时打开同名的对话框多次。 分配true可以防止打开第二个对话框。
在ngDialogProvider中配置:
var app = angular.module('exampleApp',['ngDialog']);
app.config(function (ngDialogProvider) {
ngDialogProvider.setOpenOnePerName(true);
});
一定要记得在打开对话框时添加“名称”。 如果对话框未打开,ngDialog’open’和’openConfirm’函数将返回undefined。
指令Directive
默认情况下,ngDialog模块提供ngDialog指令,可用作按钮,链接等属性。
几乎所有.open()选项也可以通过标签属性使用,唯一的区别是需要ng-template id或模板文件的路径。
例如:
<button type="button"
ng-dialog="templateId.html"
ng-dialog-class="ngdialog-theme-flat"
ng-dialog-controller="ModalCtrl"
ng-dialog-close-prevIoUs>
Open modal text
</button>
可以选择使用ng-dialog-bind-to-controller将通过参数参数定义的范围绑定到控制器。
有关bindToController的更多信息点击此处。 指令包含另外一个但非常有用的选项,它是一个名为ng-dialog-close-prevIoUs的属性。 允许自动关闭以前打开的对话框。