.open(options)

打开对话窗口，在每次调用时创建新的对话框实例。接受对象作为唯一的参数。

参数选项Options:

template {String}

对话框模板可以通过所给路径加载外部html模板或type="text/ng-template"的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：

gulp-angular-templatecache
gulp-ng-html2js
grunt-html2js
broccoli-html2js

plain {Boolean}

默认为false，如果为true则允许使用纯字符串作为模板。

ngDialog.open({
    template: 'my template',
    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.}

（可选）给控制器注入依赖关系映射。如果这些依赖关系中的任何一个都是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
});

scope.closeThisDialog(value)

.closeThisDialog（value）方法被注入到传递的$ scope中。这可以直接关闭弹出的对话框，例如：

传递给此函数的任何值将附加到该对话框对象上。对于使用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。
如果同时打开其中的几个，状态变更将关闭所有打开的对话框。

closeByDocument {Boolean}

通过点击覆盖背景关闭对话框，默认为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:'\
                Are you sure you want to close the parent dialog?\
                \
                    \
                    \
                ',
            plain: true
        });

        // NOTE: return the promise from openConfirm
        return nestedConfirmDialog;
    }
});

trapFocus {Boolean}

如果为true，则可确保聚焦的元素保持在对话框内以符合可访问性建议。默认值为true。

preserveFocus {Boolean}

如果为true，则关闭对话框后将焦点恢复到启动它的元素上。旨在改善键盘辅助功能。默认为true。

ariaAuto {Boolean}

如果为true，则自动为任何未指定的辅助功能属性选择适当的值。默认为true。

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:

open（）方法返回一个具有一些有用属性的对象。

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的值。


    Some message

返回值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或模板文件的路径。
例如：

可以选择使用ng-dialog-bind-to-controller将通过参数参数定义的范围绑定到控制器。
有关bindToController的更多信息点击此处。
指令包含另外一个但非常有用的选项，它是一个名为ng-dialog-close-previous的属性。允许自动关闭以前打开的对话框。

ngDialog中文API

.open(options)

参数选项Options:

template {String}

plain {Boolean}

controller {String} | {Array} | {Object}

controllerAs {String}

resolve {Object.}

scope {Object}

scope.closeThisDialog(value)

data {String | Object | Array}

className {String}

appendClassName {String}

disableAnimation {Boolean}

overlay {Boolean}

showClose {Boolean}

closeByEscape {Boolean}

closeByNavigation {Boolean}

closeByDocument {Boolean}

appendTo {String}

cache {Boolean}

name {String} | {Number}

onOpenCallback {String} | {Function}

preCloseCallback {String} | {Function}

trapFocus {Boolean}

preserveFocus {Boolean}

ariaAuto {Boolean}

ariaRole {String}

ariaLabelledById {String}

ariaLabelledBySelector {String}

ariaDescribedById {String}

ariaDescribedBySelector {String}

width {Number | String}

height {Number | String}

返回值Returns:

id {String}

close(value) {Function}

closePromise {Promise}

.setDefaults(options)

.openConfirm(options)

参数选项Options:

scope.confirm()

返回值Returns：

.isOpen(id)

.close(id, value)

.closeAll(value)

.getOpenDialogs()

.setForceHtmlReload({Boolean})

.setForceBodyReload({Boolean})

.setOpenOnePerName({Boolean})

指令Directive

你可能感兴趣的:(ngDialog中文API)