
理解问题背景
在angularjs应用开发中,常见需求之一是从一个独立打开的弹出窗口(例如,用于选择地图坐标、文件等)向父窗口传递数据,并更新父窗口中由ng-model绑定的表单元素。开发者通常会尝试通过以下步骤实现:
- 在子窗口中获取父窗口的DOM元素。
- 通过angular.element()获取元素的AngularJS封装。
- 调用controller('ngModel').$setViewValue()来设置ng-model的视图值。
- 调用scope().$apply()或$rootScope().$apply()来触发AngularJS的脏检查循环,使模型更新反映到视图。
然而,实践中会发现,尽管输入框的显示值可能已经改变,但其背后的ng-model绑定的数据模型却没有同步更新。这是因为AngularJS的ngModelController默认监听特定的DOM事件(如input、change、blur等)来感知视图的变化并更新模型。当通过JavaScript直接修改元素的value属性时,这些DOM事件并不会自动触发。
解决方案:手动触发Input事件
要解决ng-model不同步的问题,关键在于在程序化更新DOM元素的值之后,显式地触发一个input事件。这会模拟用户在输入框中键入内容的行为,从而激活ngModelController的监听机制,使其重新评估输入框的值并更新绑定的模型。
以下是实现这一功能的JavaScript代码示例:
function SetLatLng() {
// 检查父窗口是否存在且未关闭
if (!window.opener || window.opener.closed) {
return;
}
// 获取父窗口中对应的经纬度输入框元素
var txtLat = window.opener.document.getElementById(latId);
var txtLng = window.opener.document.getElementById(lngId);
// 获取弹出窗口中选择的经纬度值
var lat = document.getElementById('latitude').value;
var lng = document.getElementById('longitude').value;
// 更新纬度输入框的ng-model
if (txtLat) {
// 1. 在AngularJS的scope上下文中执行操作
window.opener.angular.element(txtLat).scope().$apply(function () {
// 2. 通过ngModelController.$setViewValue更新ng-model的视图值
// 这会更新ng-model的内部状态,但可能不会立即触发DOM到模型的同步
window.opener.angular.element(txtLat).controller('ngModel').$setViewValue(lat);
});
// 3. 关键步骤:手动触发'input'事件,通知AngularJS DOM值已改变
txtLat.dispatchEvent(new Event('input'));
}
// 更新经度输入框的ng-model
if (txtLng) {
window.opener.angular.element(txtLng).scope().$apply(function () {
window.opener.angular.element(txtLng).controller('ngModel').$setViewValue(lng);
});
txtLng.dispatchEvent(new Event('input'));
}
// 关闭当前弹出窗口
window.close();
}代码解析与关键概念
- window.opener: 这是一个DOM属性,允许子窗口引用打开它的父窗口。这是实现跨窗口通信的基础。
- document.getElementById(id): 用于在父窗口的DOM中查找目标输入元素。
- angular.element(domElement): 这是AngularJS的jqLite或jQuery封装,用于获取DOM元素的AngularJS包装器。通过这个包装器,我们可以访问元素的AngularJS特定方法,如scope()和controller()。
-
scope().$apply(function(){...}):
- scope(): 获取与DOM元素关联的AngularJS作用域。
- $apply(): 这是一个核心AngularJS方法,用于在AngularJS的执行上下文中运行表达式或函数。它会触发AngularJS的脏检查循环,确保所有数据绑定和观察者都被更新。当在AngularJS外部(例如,通过原生JavaScript或第三方库)修改数据时,必须调用$apply()来通知AngularJS进行更新。
-
controller('ngModel').$setViewValue(value):
- controller('ngModel'): 获取绑定到该元素的ngModelController实例。ngModelController是AngularJS处理表单输入和数据绑定的核心控制器。
- $setViewValue(value): 这是ngModelController的一个方法,用于设置视图(即DOM元素)的当前值。调用此方法会更新ngModelController的内部视图值,并根据需要更新模型(如果值发生变化且通过了验证器)。然而,它本身并不会触发DOM事件。
-
element.dispatchEvent(new Event('input')):
- new Event('input'): 创建一个类型为input的新DOM事件。
- dispatchEvent(): 在指定的DOM元素上派发(触发)一个事件。
- 为什么这是关键? ngModelController默认监听input事件来感知用户输入,从而更新绑定的模型。当我们通过$setViewValue程序化地更新值时,并没有用户输入行为,因此input事件不会自动触发。手动触发此事件,就模拟了用户输入,告诉ngModelController:“嘿,这个输入框的值变了,请检查并更新你的模型!”
注意事项与最佳实践
- 作用域的选择:在跨窗口操作时,通常应该使用window.opener.angular.element(element).scope().$apply()来确保在正确的AngularJS作用域上执行更新。避免直接使用$rootScope().$apply(),因为它会触发整个应用的脏检查,可能导致性能问题。
- 事件类型:对于文本输入框,input事件通常是最佳选择,因为它会在每次值改变时触发。对于其他类型的元素(如select),可能需要触发change事件。
- 错误处理:在实际应用中,应添加更健壮的错误处理机制,例如检查window.opener是否存在、txtLat或txtLng是否找到,以及AngularJS是否已加载等。
- AngularJS版本:此方法适用于AngularJS 1.x版本。对于Angular(Angular 2+),数据绑定机制有所不同,通常通过服务或事件发射器进行组件间通信。
- 避免直接DOM操作:在AngularJS中,通常推荐通过数据绑定来更新视图,而不是直接操作DOM。但在某些特定场景,如跨窗口通信或与非AngularJS库集成时,可能需要结合使用DOM操作和AngularJS的API。
总结
在AngularJS中从弹出窗口更新父窗口的ng-model,仅仅使用$setViewValue和$apply是不够的。关键在于理解ngModelController的工作原理:它依赖于DOM事件来感知视图变化。因此,在程序化地设置ng-model的视图值并调用$apply之后,务必通过dispatchEvent(new Event('input'))手动触发一个input事件,以确保AngularJS能够正确地捕获到这一变化并同步更新其内部数据模型。这一方法提供了一种健壮且可靠的跨窗口数据同步方案。










