Files
help365/platform/modal_window.html
koziavin 00717a92fb
All checks were successful
Deploy Static Site / deploy (push) Successful in 6m6s
update
2025-05-29 16:42:45 +04:00

217 lines
22 KiB
HTML
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html lang="en">
<head>
<title>Modal window</title>
<meta name="generator" content="Help+Manual" />
<meta name="keywords" content="" />
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Modal window is a widget that opens a window for working with app items in BRIX. There are two types of modal windows:" />
<meta name="picture" content="" />
<meta property="og:type" content="website" />
<meta property="og:title" content="Full documentation for BRIX365 platform. Low-code developer guide. User guide. Admin guide. Developer guide." />
<meta property="og:url" content="https://brix365.com/en/help" />
<meta property="og:image" content="" />
<link rel="icon" href="favicon.png" type="image/png" />
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet" />
<link rel="stylesheet" href="./jquery-ui.min.css" />
<link rel="stylesheet" href="default.css" />
<link rel="stylesheet" href="./search-yandex.css" />
<link rel="stylesheet" href="./article.css" />
<link rel="stylesheet" href="./glossary.css" />
<link rel="stylesheet" href="./theme.css" />
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="helpman_settings.js"></script>
<script type="text/javascript" src="helpman_topicinit.js"></script>
<script type="text/javascript" src="highlight.js"></script>
<script type="text/javascript">
$(document).ready(function(){highlight();});
</script>
</head>
<body>
<script>!function(e,t,c,n,r,a,m){e.ym=e.ym||function(){(e.ym.a=e.ym.a||[]).push(arguments)},e.ym.l=1*new Date;for(var s=0;s<document.scripts.length;s++)if(document.scripts[s].src===n)return;a=t.createElement(c),m=t.getElementsByTagName(c)[0],a.async=1,a.src=n,m.parentNode.insertBefore(a,m)}(window,document,"script","https://mc.yandex.ru/metrika/tag.js"),ym(83179930,"init",{clickmap:!0,trackLinks:!0,accurateTrackBounce:!0,webvisor:!0})</script><noscript><div><img alt=""src=https://mc.yandex.ru/watch/83179930 style=position:absolute;left:-9999px></div></noscript>
<header class="header elma-365">
<div class="container">
<a class="header__logo" href="https://brix365.com/en/help">
<img src="./logo-en.svg" alt="header logo">
</a>
<!-- <div class="hero__search-form" id="search-panel">
<form class="search-form" onsubmit="ym(83180416,'reachGoal','poisk')">
<label class="search-form__label">
<span id="reset-search" class="search__icon"></span>
<input class="search-form__input" type="text">
</label>
<input class="search-form__submit" type="submit" value="Submit">
</form>
</div> -->
<div class="hero__search-form" id="search-panel"> <form class="search-form"> <label class="search-form__label"> <span id="reset-search" class="search__icon"></span> <input class="search-form__input" type="text"> </label> <input class="search-form__submit" type="submit" value="Submit"> </form> </div>
<div class="hero__search">
<a href="#" id="search-icon" class="hero__search-icon">
<img src="search-icon-white.svg" alt="search string">
</a>
<a href="#" id="side-menu-icon" class="hero__side-icon">
<img src="side_menu.svg" alt="side menu">
</a>
</div>
<div class="header__navi">
<ul class="header__list"><li><span class="solution-select"><span class="solution-select__selected"></span><svg width="7" height="4" viewBox="0 0 7 4" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M1 1L3.5 3.5L6 1" stroke="white" stroke-linecap="round" stroke-linejoin="round"/></svg><ul class="solution-select__list"><li><a class="project-link" href="https://brix365.com/en/help/platform/get-trial.html">Platform</a></li><li><a class="project-link" href="https://brix365.com/en/help/ecm/ecm-functions.html">ECM</a></li><li><a class="project-link" href="https://brix365.com/en/help/crm/crm_overview.html">CRM</a></li><li><a class="project-link" href="https://brix365.com/en/help/service/service-functions.html">Service</a></li><li><a class="project-link" href="https://brix365.com/en/help/projects/projects-functions.html">Projects</a></li><li><a class="project-link" href="https://brix365.com/en/help/business_solutions/-elma365-store.html">Business Solutions</a></li></ul></span></li><li><a href="https://api.brix365.com/en/" target="_blank">API</a></li><li><a href="https://tssdk.brix365.com/" target="_blank">SDK</a></li></ul>
</div>
</div>
</header>
<main class="main container">
<aside class="sidebar" id="sidebar">
<div class="sidebar__header">
<a class="header__logo" href="https://brix365.com/en/help">
<img src="./logo-light-en.svg">
</a>
<span class="sidebar__close elma-365-close" id="close"></span>
</div>
<div class="sidebar__wrapper" id="side-menu">
</div>
</aside>
<article class="article" id="article">
<div class="article-inner">
<div class="content">
<header class="article__header">
<div class="article__bread" style="display:flex; gap:10px;">
<span id="subcategory" class="search-res__item-category search-res__item-category_subcategory subcategory article__badge"></span>
<div class="topic__breadcrumbs">
<p>Low-code designer &gt; <a href="interface_settings.html">Set up interfaces</a> &gt; Widget types &gt; <a href="360028901811.html">Element layout</a> / Modal window</p>
</div>
</div>
<div class="topic__title"><h1 class="p_Heading1"><span class="f_Heading1">Modal window</span></h1>
</div>
</header>
<section class="article__content">
<div class="scroll-top-inner">
<a href="#h1-article" class="scroll-top"></a>
</div>
<!-- Placeholder for topic body. -->
<p style="line-height: 1.20;"><span style="font-weight: bold;">Modal window</span> is a widget that opens a window for working with app items in BRIX. There are two types of modal windows:</p>
<ul style="list-style-type:disc">
<li style="line-height: 1.20;">Default modal window. It is added to all the app forms by default and displays app item pages, for example, the creation page.</li><li style="line-height: 1.20;">Child modal window. It is added to forms manually and is triggered by a certain action or condition.</li></ul>
<p style="line-height: 1.20;">Lets take a closer look at both of them.</p>
<h2 class="p_Heading2"><span class="f_Heading2">Default modal window</span></h2>
<p style="line-height: 1.20;">The default modal window is built into all the app forms and cannot be deleted. It opens the forms for creating, editing, or viewing an app item.</p>
<p style="line-height: 1.20; margin: 16px 0 0 0;">In its settings you can change how the <a href="right-side-panel.html" class="topiclink">Sidebar</a> is displayed. To do that, click on any free space on the modeling canvas. The <span style="font-weight: bold;">Modal window</span> label appears in the top-right corner. Click on the gear icon to open the settings.</p>
<p style="line-height: 1.20; margin: 16px 0 0 0;"><img alt="main_modal" width="861" height="418" style="margin:0;width:861px;height:418px;border:none" src="main_modal.png"/></p>
<h3 class="p_Heading3"><span class="f_Heading3">Main tab</span></h3>
<h3 style="line-height: 1.20;"><img alt="main_modal_settings" width="514" height="221" style="margin:0;width:514px;height:221px;border:none" src="main_modal_settings.png"/></h3>
<p style="line-height: 1.20;">Use the <span style="font-weight: bold;">Show sidebar</span> option to show or hide the side panel on the form. Alternatively, you can bind this field to a context variable so that the sidebar is shown only with a specific variable value. To do that, click <img alt="right_panel_3" title="right_panel_3" width="29" height="25" style="margin:0;width:29px;height:25px;border:none" src="right_panel_3.png"/> and select the variable from the context. To learn more, see <a href="common_widget_settings.html#bind-app" class="topiclink">System widget settings</a>.</p>
<p style="line-height: 1.20;"><span style="font-size: 13px; color: #000000;">&nbsp;</span></p>
<h3 class="p_Heading3"><span class="f_Heading3">Events tab</span></h3>
<p style="text-align: justify; line-height: 1.20; margin: 7px 0 16px 0;">On this tab, you can set the widgets behavior when you hover over it and move the cursor outside its borders. To learn more, see <a href="common_widget_settings.html" class="topiclink">System widget settings</a>.</p>
<h3 class="p_Heading3"><span class="f_Heading3">System tab</span></h3>
<p style="text-align: justify; line-height: 1.20; margin: 7px 0 16px 0;">Here you can configure settings that are the same for any widget: its visibility, access to it, content loading, etc. Read more in the <a href="common_widget_settings.html" class="topiclink">System widget settings</a> article.</p>
<p style="text-align: justify; line-height: 1.20; margin: 7px 0 16px 0;">The <span style="font-weight: bold;">Side panel HTML styles</span> field is also available for the <span style="font-weight: bold;">Modal Window</span> widget. You can use it to customize the CSS style for the sidebar, for example, to set its width.</p>
<p style="text-align: justify; line-height: 1.20; margin: 7px 0 16px 0;">To complete settings up the widget, click <span style="font-weight: bold;">Save</span>.</p>
<p style="text-align: justify; line-height: 1.20; margin: 7px 0 16px 0;">To make the changes available to users, click <span style="font-weight: bold;">Save</span> and <span style="font-weight: bold;">Publish</span> in the designers toolbar.</p>
<h2 class="p_Heading2"><span class="f_Heading2">Child modal window</span></h2>
<p class="p_Normal">This widget opens a second modal window over the default one when a certain action takes place, for example, the user clicks a button.</p>
<p class="p_Normal" style="background: #ffffff; margin: 11px 0 16px 0;">To place the widget on the form, drag it from the right pane of the <a href="interface_designer.html" class="topiclink">interface designer</a> to the modeling canvas, or click <span style="font-weight: bold;">+Widget</span>. You can learn more in <a href="360029250931.html" class="topiclink">Form template</a>. Then manage the settings in the opened window.</p>
<h3 class="p_Heading3"><span class="f_Heading3">Main tab</span></h3>
<p class="p_Normal" style="background: #ffffff; margin: 7px 0 0 0;"><img alt="modal_child_settings" width="687" height="323" style="margin:0;width:687px;height:323px;border:none" src="modal_child_settings.png"/></p>
<ul style="list-style-type:disc">
<li style="line-height: 1.20;"><span style="font-weight: bold;">Header</span>. Enter the header that will be displayed in the window. You can bind this field with a <a href="360009707032.html#string" class="topiclink">String</a> variable created on the <a href="designer-tabs.html#context" class="topiclink">Context</a> tab in the interface designer. To do that, first click <img alt="right_panel_3" title="right_panel_3" width="31" height="27" style="margin:0;width:31px;height:27px;border:none" src="right_panel_3.png"/>, then click <span style="font-weight: bold;">&lt;Not defined&gt; </span>and select the variable from the list. Its value will be displayed in the modal header.</li><li style="line-height: 1.20;"><span style="font-weight: bold;">Show sidebar</span>. Enable this option to show the right-side panel on the form. Click <img alt="right_panel_3" title="right_panel_3" width="28" height="24" style="margin:0;width:28px;height:24px;border:none" src="right_panel_3.png"/> to bind the field with a <a href="360009707032.html#yes-no-switch" class="topiclink">Yes/No switch</a> variable and show or hide the side panel according to the variables value.</li><li style="line-height: 1.20;"><span style="font-weight: bold;">Size</span><span style="font-weight: bold; color: #ff0000;">*</span>. Select the size of the modal window.</li><li style="line-height: 1.20;"><span style="font-weight: bold;">Show window</span>. Check this option if you want the modal window to be shown on the form by default. Click <img alt="right_panel_3" title="right_panel_3" width="28" height="24" style="margin:0;width:28px;height:24px;border:none" src="right_panel_3.png"/> to bind the field with a <a href="360009707032.html#yes-no-switch" class="topiclink">Yes/No switch</a> variable and show or hide the modal window according to the variables value.</li></ul>
<p style="line-height: 1.20;"><span style="font-size: 13px; color: #000000;">&nbsp;</span></p>
<h3 style="line-height: 1.20;"><span style="font-weight: bold; color: #0a141e;">Events tab</span></h3>
<h3 style="line-height: 1.20;"><img alt="modal_events_tab" width="627" height="289" style="margin:0;width:627px;height:289px;border:none" src="modal_events_tab.png"/></h3>
<p style="text-align: justify; line-height: 1.20; background: #ffffff; margin: 7px 0 16px 0;">On this tab, you can customize the widgets behavior by selecting functions from scripts that will be called when various events occur. <span style="font-weight: bold;">On mouse enter handler</span> and <span style="font-weight: bold;">On mouse leave handler</span> are available for any widget. Find out more in <a href="common_widget_settings.html" class="topiclink">System widget settings</a>.</p>
<p style="text-align: justify; line-height: 1.20; margin: 7px 0 16px 0;">For a child modal window, you can also configure the <span style="font-weight: bold;">On window close handler</span>. For example, if filtering for a report is set in a modal window, you can update the data on the form when the window is closed.</p>
<h3 style="line-height: 1.20;"><span style="font-weight: bold; color: #0a141e;">System tab</span></h3>
<p style="text-align: justify; line-height: 1.20; margin: 7px 0 7px 0;">Here you can configure settings that are the same for any widget: its visibility, access to it, content loading, etc. Read more in the <a href="common_widget_settings.html" class="topiclink">System widget settings</a> article.</p>
<p style="text-align: justify; line-height: 1.20; margin: 7px 0 7px 0;">The <span style="font-weight: bold;">Side panel HTML styles</span> field is also available for the <span style="font-weight: bold;">Modal Window</span> widget. You can use it to customize the CSS style for the sidebar, for example, to set its width.</p>
<p style="text-align: justify; line-height: 1.20; margin: 7px 0 7px 0;">To finish the setup, click <span style="font-weight: bold;">Save</span>. To make the changes available to users, click <span style="font-weight: bold;">Save</span> and <span style="font-weight: bold;">Publish</span> in the top toolbar of the interface designer.</p>
<h2 class="p_Heading2"><span class="f_Heading2">Example</span></h2>
<p style="line-height: 1.20; background: #ffffff; margin: 7px 0 7px 0;"><span style="font-family: Inter;">In the example below, the </span><span style="font-family: Inter; font-weight: bold;">Modal Window</span><span style="font-family: Inter;"> widget is used to quickly open the file upload form. When a user hovers over the corresponding field, a pop-up for file upload appears.</span></p>
<p style="line-height: 1.20; margin: 7px 0 7px 0;"><img alt="ModW 2" width="1216" height="588" style="margin:0;width:1216px;height:588px;border:none" src="hmfile_hash_9e537ac1.gif"/></p>
<div class="bottom-nav">
<a id="prev-link" class="topic__navi_prev" href="form_menu_card.html">
<span class="bottom-nav__arrow bottom-nav__arrow--prev"></span> <span
class="bottom-nav__link">form_menu_card.html</span>
</a>
<a id="next-link" class="topic__navi_next" href="navigator.html">
<span class="bottom-nav__link">navigator.html</span> <span
class="bottom-nav__arrow bottom-nav__arrow--next"></span>
</a>
</div>
<!-- добавляет на страницу строку блок Была ли статья полезной? -->
<div class="feedback" id="feedback"><div class="feedback-help"><span><b>Was this helpful?</b></span><form action="" method="POST" class="feedback-form" id="feedback-form"><div class="feedback__popup feedback__popup-response" id="feedback__popup_thx" style="display: none;">Thanks for your feedback!</div><div class="feedback__popup" id="feedback__popup_why" style="display: none;"><div class="feedback__popup-header">Please specify why:</div><input type="radio" name="category" id="bad_recommendation" value="bad_recommendation"><label for="bad_recommendation">Recommendations did not help me</label><input type="radio" name="category" id="difficult_text" value="difficult_text"><label for="difficult_text">Article is hard to understand</label><input type="radio" name="category" id="no_answer" value="no_answer"><label for="no_answer">Didn`t answer my question</label><input type="radio" name="category" id="bad_header" value="bad_header"><label for="bad_header">Content does not match the topic</label><input type="radio" name="category" id="other_reason" value="other_reason"><label for="other_reason">Other</label></div><div class="feedback__popup" id="feedback__popup-other" style="display: none;"><div class="feedback__popup-header">How we can improve it?</div><textarea class="feedback__textarea" name="other" id=""></textarea><input type="submit" class="feedback__other-btn" value="Submit"></div><div class="feedback-form__btn-group"><input type="radio" name="useful" id="feedback__useful_yes" value="true"><label for="feedback__useful_yes"><img src="like.svg" class="small-img" alt="like"><spanclass="feedback-form__btn-group_yes-btn">Yes</spanclass="feedback-form__btn-group_yes-btn"></label><input type="radio" name="useful" id="feedback__useful_no" value="false"><label for="feedback__useful_no"><img src="dislike.svg" class="small-img" alt="dislike"><spanclass="feedback-form__btn-group_no-btn">No</spanclass="feedback-form__btn-group_no-btn"></label></div><select name="category"><option disabled="">Please specify why</option><option value="bad_recommendation" selected="">Recommendations did not help me</option><option value="difficult_text">Article is hard to understand</option><option value="no_answer">Didn`t answer my question</option><option value="bad_header">Content does not match the topic</option><option value="other_reason">Other</option></select><input type="submit"></form></div><div class="found_typo"><p style="margin: 0px; margin-top: 16px !important;"><span><b>Found a typo?</b></span> Select it and press <i>Ctrl+Enter</i> to send us feedback</p></div></div>
</section>
</div>
<aside class="article__sidebar" style="display:none">
<input type="checkbox" />
<div class="article__arrow"></div>
<div class="table-of-contents elma365-right" id="toc2Content">
<h3 class="h3-toc">In this topic</h3>
<nav id="toc2"></nav>
</div>
</aside>
</div>
</article>
</main>
<footer class="footer">
<div class="footer-container">
<div class="footer-mobile">
<ul class="footer-mobile__list"><li><a href="https://brix365.com/en/" target="_blank">BRIX</a></li><li><a href="https://tssdk.brix365.com/en/latest/" target="_blank">SDK</a></li><li><a href="https://api.brix365.com/en/" target="_blank">API</a></li></ul><ul class="footer-mobile__list"><li><a href="https://brix365.com/en/help/platform/get-trial.html">Platform</a></li><li><a href="https://brix365.com/en/help/ecm/ecm-functions.html">ECM</a></li><li><a href="https://brix365.com/en/help/service/service-functions.html">Service</a></li><li><a href="https://brix365.com/en/help/projects/projects-functions.html">Projects</a></li></ul>
</div>
<div class="footer-wrap">
<div><span class="mobile-question-popup">Send feedback</span><form method="POST" action class="question__popup question-xs" id="question__popup"><div class="question-wrap"><span class="close"></span><span class="title">Ask a question</span><label for="help_question" style="display: none;"></label><textarea name="help_question" id="help_question"></textarea><input type="submit" value="Send"></div></form><div class="hidden fade-in question-success-xs">Sent</div></div>
<div class="footer-flex-b">
<span class="footer-copy">&copy; 2025 BRIX</span>
<ul class="footer-list">
<li class="footer-item">
<a href="#" class="arrow-top" style="display: block;"></a>
</li>
</ul>
</div>
</div>
</div>
</footer>
<iframe name="hmnavigation" style="display:none!important"></iframe>
<script src="./jquery-ui.js"></script>
<!--script src="//cdn.jsdelivr.net/npm/featherlight@1.7.14/release/featherlight.min.js" type="text/javascript" charset="utf-8"></script-->
<script src="./jquery.tocify.min.js"></script>
<script src="./TypoReporter.min.js"></script>
<script src="./google-search.js"></script>
<script src="./main.js"></script>
</body>
</html>