Help: Embedded Browser: Make 'needModal' workaround more robust

See https://github.com/eclipse-platform/eclipse.platform.swt/issues/2006

Author: sratz

ua/org.eclipse.help.ui/src/org/eclipse/help/ui/internal/browser/embedded/EmbeddedBrowser.java

@@ -36,6 +36,7 @@
 import org.eclipse.osgi.util.NLS;
 import org.eclipse.swt.SWT;
 import org.eclipse.swt.browser.Browser;
+import org.eclipse.swt.browser.BrowserFunction;
 import org.eclipse.swt.browser.LocationAdapter;
 import org.eclipse.swt.browser.LocationEvent;
 import org.eclipse.swt.browser.LocationListener;
@@ -166,16 +167,13 @@ public void controlResized(ControlEvent e) {
 		shell.open();
 		//browser.setUrl("about:blank");
 
+		addNeedModalBrowserFunction(browser);
+		addResetNeedModalLocationListener(browser);
+
 		browser.addLocationListener(new LocationAdapter() {
 
 			@Override
 			public void changing(LocationEvent e) {
-				// hack to know when help webapp needs modal window
-				modalRequestTime = 0;
-				if (e.location != null
-						&& e.location.startsWith("javascript://needModal")) { //$NON-NLS-1$
-					modalRequestTime = System.currentTimeMillis();
-				}
 				if (!e.doit && e.location != null
 						&& e.location.startsWith("https://")) { //$NON-NLS-1$
 					try {
@@ -224,6 +222,30 @@ public void changing(LocationEvent e) {
 			}
 		});
 	}
+
+	// hack to know when help webapp needs modal window
+	// use a browser function to be more robust
+	// see also https://github.com/eclipse-platform/eclipse.platform.swt/issues/2006
+	private void addNeedModalBrowserFunction(Browser browser) {
+		browser.getDisplay().asyncExec(() -> {
+			if (browser.isDisposed()) {
+				return;
+			}
+			new BrowserFunction(browser, "needModal") { //$NON-NLS-1$
+				@Override
+				public Object function(Object[] arguments) {
+					super.function(arguments);
+					modalRequestTime = System.currentTimeMillis();
+					return null;
+				}
+			};
+		});
+	}
+
+	private void addResetNeedModalLocationListener(Browser browser) {
+		LocationListener.changingAdapter(e -> modalRequestTime = 0);
+	}
+
 	private static void initializeShell(Shell s) {
 		s.setText(initialTitle);
 		final Image[] shellImages = createImages();

ua/org.eclipse.help.webapp/advanced/navActions.js

@@ -193,7 +193,7 @@ function quickSearch(quickSearchType, errorMsg) {		//search this topic and all s
 		}		
 		// move the dialog just a bit higher than the middle
 		if (t-50 > 0) t = t-50;
-	  	window.location="javascript://needModal";  
+		top.needModal();
 	  	// Defect 593 ends
 
 		var quickSearchWindow = window.open("quickSearch.jsp" + parameters, "QuickSearch", "location=no, status=no,resizable=yes,height="+h+",width="+w +",left="+l+",top="+t);		

ua/org.eclipse.help.webapp/advanced/searchScoped.jsp

@@ -183,7 +183,7 @@ if (data.isIE()){
 	// move the dialog just a bit higher than the middle
 	if (t-50 > 0) t = t-50;
 	
-	window.location="javascript://needModal";
+	top.needModal();
 	advancedDialog = window.open("workingSetManager.jsp?workingSet="+encodeURIComponent(workingSet), "advancedDialog", "resizable=yes,height="+h+",width="+w+",left="+l+",top="+t );
 	advancedDialog.focus(); 
 }

ua/org.eclipse.help.webapp/advanced/searchSimple.jsp

@@ -144,7 +144,7 @@ function saveSelectedBooks(books)
 
 function openAdvanced()
 {
-	window.location="javascript://needModal";
+	top.needModal();
 	advancedDialog = window.open("advanced.jsp?searchWord="+encodeURIComponent(document.getElementById("searchWord").value), "advancedDialog", "resizable=yes,height="+h+",width="+w );
 	advancedDialog.focus(); 
 }

ua/org.eclipse.help.webapp/advanced/views.jsp

@@ -89,7 +89,7 @@ if (data.isIE()){
 	// move the dialog just a bit higher than the middle
 	if (t-50 > 0) t = t-50;
 	
-	window.location="javascript://needModal";
+	top.needModal();
 	confirmShowAllDialog = window.open("confirmShowAll.jsp", "confirmShowAllDialog", "resizable=no,height="+h+",width="+w+",left="+l+",top="+t );
 	confirmShowAllDialog.focus(); 
 }
@@ -112,7 +112,7 @@ if (data.isIE()){
 	// move the dialog just a bit higher than the middle
 	if (t-50 > 0) t = t-50;
 	
-	window.location="javascript://needModal";
+	top.needModal();
 	selectScopeDialog = window.open("selectScope.jsp", "selectScopeDialog", "resizable=no,height="+h+",width="+w+",left="+l+",top="+t );
 	selectScopeDialog.focus(); 
 }

ua/org.eclipse.help.webapp/advanced/workingSetManager.jsp

@@ -224,7 +224,7 @@ function newWorkingSet() {
 	%>
 	// move the dialog just a bit higher than the middle
 	if (t-50 > 0) t = t-50;
-	window.location="javascript://needModal";
+	top.needModal();
 	workingSetDialog = window.open("workingSet.jsp?operation=add&workingSet="+encodeURIComponent(getWorkingSet()), "workingSetDialog", "resizable=yes,height="+h+",width="+w +",left="+l+",top="+t);
 	workingSetDialog.focus(); 
 }
@@ -247,7 +247,7 @@ function editWorkingSet() {
 	// move the dialog just a bit higher than the middle
 	if (t-50 > 0) t = t-50;
 		
-	window.location="javascript://needModal";
+	top.needModal();
 	workingSetDialog = window.open("workingSet.jsp?operation=edit&workingSet="+encodeURIComponent(getWorkingSet()), "workingSetDialog", "resizable=no,height="+h+",width="+w+",left="+l+",top="+t );
 	workingSetDialog.focus(); 
 }