CORE/apex/workspace_files/global.js

//
// WAIT FOR ELEMENT TO EXIST
//
var wait_for_element = function(search, start, fn, disconnect) {
    var ob  = new MutationObserver(function(mutations) {
        if ($(search).length) {
            fn(search, start);
            if (disconnect) {
                observer.disconnect();  // keep observing
            }
        }
    });
    //
    ob.observe(document.getElementById(start), {
        childList: true,
        subtree: true
    });
};



//
// WHEN PAGE LOADS
//
var apex_page_loaded = function() {
    //
    // WAIT FOR SUCCESS MESSAGE
    //
    const search    = '#APEX_SUCCESS_MESSAGE.u-visible > .t-Body-alert > #t_Alert_Success';
    const start     = 'APEX_SUCCESS_MESSAGE';

    //
    // INTERACTIVE GRIDS - look for css change on Edit button and apply it to Save button
    //
    var observer = new MutationObserver(function(mutations) {
        mutations.forEach(function(mutation) {
            var $target = $(mutation.target);
            if ($target.hasClass('is-active')) {
                var $save = $target.parent().parent().find('button.a-Button.a-Toolbar-item.js-actionButton[data-action="save"]');
                $save.addClass('is-active');
                //observer.disconnect();  // remove observer when fired
            }
        });
    });
    //
    $.each($('div.a-Toolbar-toggleButton.js-actionCheckbox.a-Toolbar-item[data-action="edit"] > label'), function(i, el) {
        // assign unique ID + apply tracker/observer
        $el = $(el);
        $el.attr('id', 'OBSERVE_' + $el.attr('for'));
        observer.observe($el[0], {
            attributes: true
        });
    });

    //
    // SHOW NOTIFICATIONS
    //
    var item_success        = 'P0_MESSAGE_SUCCESS';
    var item_error          = 'P0_MESSAGE_ERROR';
    var item_alert          = 'P0_MESSAGE_ALERT';
    // confirm
    var item_callback       = 'P0_MESSAGE_CALLBACK';  // contains function name
    //
    var item_success_value  = apex.item(item_success).getValue();
    var item_error_value    = apex.item(item_error).getValue();
    var item_alert_value    = apex.item(item_alert).getValue();
    var item_callback_value = apex.item(item_callback).getValue();

    // catch error close event
    apex.message.setThemeHooks({
        beforeShow: function(pMsgType, pElement$) {  // beforeShow, beforeHide
            //if (pMsgType === apex.message.TYPE.ERROR) {  // SUCCESS, ERROR
            if (pMsgType === apex.message.TYPE.SUCCESS) {
                setTimeout(() => {
                    apex.message.hidePageSuccess();  // hide message
                }, 3000);
            }
            console.log('MESSAGE:', pMsgType, pElement$);
        },
        beforeHide: function(pMsgType, pElement$) {  // beforeShow, beforeHide
            //if (pMsgType === apex.message.TYPE.ERROR) {  // SUCCESS, ERROR
            //}
        }
    });

    // hide message already created on page
    setTimeout(() => {
        apex.message.hidePageSuccess();  // hide message
    }, 3000);

    // show notifications based on page zero items
    if (item_error_value.length) {
        // show error/warning
        apex.message.showErrors([{
            type:       apex.message.TYPE.ERROR,
            location:   ['page'],
            message:    item_error_value,
            unsafe:     false
        }]);
    }
    else if (item_success_value.length) {
        // show success
        apex.message.showPageSuccess(item_success_value);
    }

    // show alert
    if (item_alert_value.length) {
        apex.message.alert(item_alert_value, function() {
            console.log('ALERT CLOSED');
            //
            if (item_callback_value.length) {
                console.log('CALLBACK INITIATED:', item_callback_value);
                new Function(item_callback_value)();
            }
        });
    }
};



//
// INTERACTIVE GRIDS - fold (hide) requested group (Control Break)
//
var fold_grid_group = function(grid_id, group_name, group_value) {
    (function loop(i) {
        setTimeout(function() {
            var $x = $('#' + grid_id + ' table tbody tr:first button');
            if ($x) {
                var $b = $x.parent().find('.a-GV-controlBreakLabel');
                if ($b.find('.a-GV-breakLabel').text().includes(group_name) && $b.find('.a-GV-breakValue').text().includes(group_value)) {
                    $x.click();
                    $x.blur();
                    $(window).scrollTop(0);
                    return;
                }
            }
            if (--i) loop(i);
        }, 1000)
    })(10);
};



//
// COMMON TOOLBAR FOR ALL GRIDS
//
// just put following code in Region - Attributes - JavaScript Initialization Code
// and assign Static ID to region
/*
function(config) {
    return unified_ig_toolbar(config);
}
*/
var unified_ig_toolbar = function(config) {
    var $ = apex.jQuery;
    var toolbarData = $.apex.interactiveGrid.copyDefaultToolbar();
    var toolbarGroup = toolbarData.toolbarFind('actions4');
    //var actionsGroup = toolbarData.toolbarFind('actions1');

    // show refresh button before save button
    // https://docs.oracle.com/en/database/oracle/application-express/20.1/aexjs/interactiveGrid.html#actions-section
    toolbarGroup.controls.push({
        type            : 'BUTTON',
        action          : 'refresh',
        icon            : 'fa fa-refresh',
        iconBeforeLabel : true,
        label           : ' '  // how to get rid of the space and show just icon?
    });

    // only for developers
    if ($('#apexDevToolbar.a-DevToolbar')) {
        // add a filter button after the actions menu
        toolbarGroup.controls.push({
            type            : 'BUTTON',
            action          : 'save-report',
            label           : 'Save as Default',
            icon            : ''  // no icon
        });

        // add row button as a plus sign without text
        addrowAction                    = toolbarData.toolbarFind('selection-add-row'),
        addrowAction.icon               = 'fa fa-plus';
        addrowAction.iconBeforeLabel    = true;
        addrowAction.label              = ' ';
        addrowAction.hot                = false;
    }
    //
    config.toolbarData = toolbarData;
    //
    return config;
};



//
// SHOW/HIDE SEARCH FIELDS
//
var show_search_fields = function() {
    $('.t-HeroRegion-col.t-HeroRegion-col--content .HIDDEN').removeClass('HIDDEN');
    //
    $('.SEARCH_FIELDS').show();
    $('#BUTTON_SHOW_SEARCH').hide();
    $('#BUTTON_CLOSE_SEARCH').show();
    $('.SEARCH_FIELDS').find('input')[0].focus();
};
//
var hide_search_fields = function() {
    $('.SEARCH_FIELDS').hide();
    $('#BUTTON_CLOSE_SEARCH').hide();
    $('#BUTTON_SHOW_SEARCH').show().focus();
};