DocumentaçãoAEM 6.4Guia do Forms

Criação de componentes de layout personalizados para formulários adaptáveis creating-custom-layout-components-for-adaptive-forms

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • User
CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

Pré-requisitos prerequisite

Conhecimento sobre layouts, que permite criar/usar um layout personalizado. Consulte Alterar o layout do painel.

Componente de layout do painel de formulário adaptável adaptive-form-panel-layout-component

O componente Layout do painel de formulário adaptável controla a maneira como os componentes de formulário adaptáveis são posicionados em um painel em relação à interface do usuário.

Criação de um layout de painel personalizado creating-a-custom-panel-layout

  1. Navegar até o local /crx/de.
  2. Copiar um layout de painel do local /libs/fd/af/layouts/panel (por exemplo, tabbedPanelLayout) a /apps (por exemplo, /apps/af-custom-layout).
  3. Renomeie o layout copiado para o customPanelLayout. Alterar as propriedades dos nós qtip e jcr:description. Por exemplo, altere para Custom layout - Toggle tabs.

Instantâneo CRX DE Layout do Painel Personalizado

NOTE
Configuração da propriedade guideComponentTypeao valor fd/af/layouts/panel determina que o layout é um layout de painel.

  1. Renomear o arquivo tabbedPanelLayout.jsp no novo layout para customPanelLayout.jsp.

  2. Para introduzir novos estilos e comportamentos, crie uma biblioteca de clientes no etc nó . Por exemplo, no local /etc/af-custom-layout-clientlib, crie o nó client-library. Deixe o nó ter a propriedade de categorias af.panel.custom. Ele tem os seguintes arquivos .css e .js:

    code language-css 
    /** CSS defining new styles used by custom layout **/

.menu-nav {
    background-color: rgb(198, 38, 76);
    height: 30px;
 width: 30px;
 font-size: 2em;
 color: white;
    -webkit-transition: -webkit-transform 1s;  /* For Safari 3.1 to 6.0 */
 transition: transform 1s;
}

.tab-content {
 border: 1px solid #08b1cf;
}

.custom-navigation {
    -webkit-transition: width 1s, height 1s, -webkit-transform 1s;  /* For Safari 3.1 to 6.0 */
 transition: width 1s, height 1s, transform 1s;
}

.panel-name {
    padding-left: 30px;
    font-size: 20px;
}

@media (min-width: 992px) {
 .nav-close {
  width: 0px;
    }
}

@media (min-width: 768px) and (max-width: 991px) {
 .nav-close {
  height: 0px;
    }
}

@media (max-width: 767px) {
 .menu-nav, .custom-navigation {
     display: none;
    }
}
    code language-none 
    /** function for toggling the navigators **/
var toggleNav = function () {

    var nav = $('.custom-navigation');
    if (nav) {
        nav.toggleClass('nav-close');
    }
}

/** function to populate the panel title **/
$(window).on('load', function() {
    if (window.guideBridge) {
        window.guideBridge.on("elementNavigationChanged",
        function (evntName, evnt) {
                    var activePanelSom = evnt.newText,
                        activePanel = window.guideBridge._guideView.getView(activePanelSom);
                    $('.panel-name').html(activePanel.$itemNav.find('a').html());
                }
        );
    }
});

  3. Para aprimorar a aparência e o comportamento, é possível incluir uma client library.

    Além disso, atualize os caminhos dos scripts incluídos em arquivos .jsp. Por exemplo, atualize o customPanelLayout.jsp como segue:

    code language-none 
    <%-- jsp encapsulating navigator container and panel container divs --%>

<%@include file="/libs/fd/af/components/guidesglobal.jsp"%>
<cq:includeClientLib categories="af.panel.custom"/>
<div>
    <div class="row">
        <div class="col-md-2 col-sm-2 hidden-xs menu-nav glyphicon glyphicon-align-justify" onclick="toggleNav();"></div>
        <div class="col-md-10 col-sm-10 hidden-xs panel-name"></div>
    </div>
    <div class="row">
        <div class="col-md-2 hidden-xs guide-tab-stamp-list custom-navigation">
            <cq:include script = "/apps/af-custom-layout/customPanelLayout/defaultNavigatorLayout.jsp" />
        </div>
        <div  class="col-md-10">
            <c:if test="${fn:length(guidePanel.description) > 0}">
                <div class="<%=GuideConstants.GUIDE_PANEL_DESCRIPTION%>">
                    ${guide:encodeForHtml(guidePanel.description,xssAPI)}
                        <cq:include script="/libs/fd/af/components/panel/longDescription.jsp"/>
                </div>
            </c:if>
            <cq:include script = "/apps/af-custom-layout/customPanelLayout/panelContainer.jsp"/>
        </div>
    </div>
</div>

    O /apps/af-custom-layout/customPanelLayout/defaultNavigatorLayout.jsp arquivo:

    code language-none 
    <%-- jsp governing the navigation part --%>

<%@include file="/libs/fd/af/components/guidesglobal.jsp"%>
<%@ page import="com.adobe.aemds.guide.utils.StyleUtils" %>
<%-- navigation tabs --%>
<ul id="${guidePanel.id}_guide-item-nav-container" class="tab-navigators tab-navigators-vertical in"
    data-guide-panel-edit="reorderItems" role="tablist">
    <c:forEach items="${guidePanel.items}" var="panelItem">
        <c:set var="isNestedLayout" value="${guide:hasNestablePanelLayout(guidePanel,panelItem)}"/>
        <li id="${panelItem.id}_guide-item-nav" title="${guide:encodeForHtmlAttr(panelItem.navTitle,xssAPI)}" data-path="${panelItem.path}" role="tab" aria-controls="${panelItem.id}_guide-item">
            <c:set var="panelItemCss" value="${panelItem.cssClassName}"/>
            <% String panelItemCss = (String) pageContext.getAttribute("panelItemCss");%>
            <a data-guide-toggle="tab" class="<%= StyleUtils.addPostfixToClasses(panelItemCss, "_nav") %> guideNavIcon nested_${isNestedLayout}">${guide:encodeForHtml(panelItem.navTitle,xssAPI)}</a>
            <c:if test="${isNestedLayout}">
                <guide:initializeBean name="guidePanel" className="com.adobe.aemds.guide.common.GuidePanel"
                    resourcePath="${panelItem.path}" restoreOnExit="true">
                    <sling:include path="${panelItem.path}"
                                   resourceType="/apps/af-custom-layout/customPanelLayout/defaultNavigatorLayout.jsp"/>
                </guide:initializeBean>
            </c:if>
            <em></em>
        </li>
    </c:forEach>
</ul>

    O arquivo /apps/af-custom-layout/customPanelLayout/panelContainer.jsp:

    code language-none 
    <%-- jsp governing the panel content --%>

<%@include file="/libs/fd/af/components/guidesglobal.jsp"%>

<div id="${guidePanel.id}_guide-item-container" class="tab-content">
    <c:if test="${guidePanel.hasToolbar && (guidePanel.toolbarPosition == 'Top') }">
        <sling:include path="${guidePanel.toolbar.path}"/>
    </c:if>

<c:forEach items="${guidePanel.items}" var="panelItem">
    <div class="tab-pane" id="${panelItem.id}_guide-item" role="tabpanel">
        <c:set var="isNestedLayout" value="${guide:hasNestablePanelLayout(guidePanel,panelItem)}"/>
        <c:if test="${isNestedLayout}">
            <c:set var="guidePanelResourceType" value="/apps/af-custom-layout/customPanelLayout/panelContainer.jsp" scope="request"/>
        </c:if>
        <sling:include path="${panelItem.path}" resourceType="${panelItem.resourceType}"/>
    </div>
</c:forEach>
<c:if test="${guidePanel.hasToolbar && (guidePanel.toolbarPosition == 'Bottom')}">
    <sling:include path="${guidePanel.toolbar.path}"/>
</c:if>
</div>

  4. Abra um formulário adaptável no modo Criação. O layout do painel definido é adicionado à lista para configurar layouts de painel.

    O layout do Painel personalizado é exibido na lista de layout do painel Captura de tela do formulário adaptável, usando o layout personalizado do painel Captura de tela demonstrando a funcionalidade de alternância do layout personalizado

ZIP de amostra para um layout de painel personalizado e um formulário adaptável usando-o.

Obter arquivo

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da