newWin(url, title, target='') - Merciglobal Cloud ERP¶
This document explains the newWin() JavaScript utility function provided in Merciglobal Cloud ERP, which is used to open a new browser window or tab, depending on the specified parameters. It also handles scenarios where pop-ups might be blocked by the user's browser and informs the user accordingly.
Purpose¶
The newWin() function is designed to programmatically open a new window or tab for performing specific tasks or navigating to external/internal pages from within the Merciglobal ERP system interface.
Function Signature¶
newWin(url, title, target = '')
Parameters:¶
| Parameter | Type | Description |
|---|---|---|
url |
string | The URL to be opened in the new window. |
title |
string | Title or name assigned to the new window. |
target |
string | Optional target (_blank, custom name). Defaults to empty string. |
How It Works¶
- Utilizes
window.open()to attempt opening the desired URL. - Detects whether the pop-up window was successfully opened.
- If blocked by the browser, it shows a warning message to the user.
Successful Case:¶
If the browser allows pop-ups:
const win = window.open(url, target || title);
Blocked Case:¶
If the new window fails to open (most likely blocked by browser pop-up settings):
if (!win || win.closed || typeof win.closed == 'undefined') {
alert('Pop-up was blocked. Please allow pop-ups for this site.');
}
Example Usage¶
newWin('https://support.mercicloud.com', 'Merci Support');
Notes on Browser Behavior¶
- Many modern browsers block pop-ups triggered outside user interaction (like clicks).
- Ensure that
newWin()is called from a user-initiated event to avoid being blocked.
🛠️ Use Cases in Merciglobal Cloud ERP¶
- Opening external documentation
- Loading printable views or reports
- Previewing invoices or quotations
- Accessing third-party integrated systems
Always ensure that critical operations which rely on new windows being opened are paired with user interactions for better compatibility and user experience.