CardInfoRowUtil.java

  1. package com.hack23.cia.web.impl.ui.application.views.common.pagemode;

  3. import com.hack23.cia.web.impl.ui.application.views.common.labelfactory.LabelFactory;
  4. import com.hack23.cia.web.impl.ui.application.views.common.sizing.ContentRatio;
  5. import com.vaadin.icons.VaadinIcons;
  6. import com.vaadin.server.Responsive;
  7. import com.vaadin.server.Sizeable.Unit;
  8. import com.vaadin.shared.ui.ContentMode;
  9. import com.vaadin.ui.HorizontalLayout;
  10. import com.vaadin.ui.Label;
  11. import com.vaadin.ui.Panel;
  12. import com.vaadin.ui.VerticalLayout;

  14. /**
  15.  * The Class CardInfoRowUtil.
  16.  */
  17. public class CardInfoRowUtil {

  19.     /** The Constant CARD_TENURE. */
  20.     public static final String CARD_TENURE = "card-tenure";

  22.     /** The Constant CARD_EXPERIENCE. */
  23.     public static final String CARD_EXPERIENCE = "card-experience-section";

  25.     /** The Constant CARD_INFO_VALUE. */
  26.     public static final String CARD_INFO_VALUE = "card-info-value";

  28.     /** The Constant CARD_INFO_ICON. */
  29.     public static final String CARD_INFO_ICON = "card-info-icon";

  31.     /** The Constant METRIC_LABEL. */
  32.     public static final String METRIC_LABEL = "metric-label";

  34.     /**
  35.      * Creates the page header.
  36.      *
  37.      * @param panel           the panel
  38.      * @param panelContent    the panel content
  39.      * @param header          the header
  40.      * @param pageHeader      the page header
  41.      * @param pageDescription the page description
  42.      */
  43.     public static final void createPageHeader(final Panel panel, final VerticalLayout panelContent, final String header,
  44.             final String pageHeader, final String pageDescription) {
  45.         panel.setCaption(header);
  46.         LabelFactory.createHeader2Label(panelContent, pageHeader);
  47.         final Label descriptionLabel = new Label(pageDescription);
  48.         descriptionLabel.addStyleName("itembox");
  49.         Responsive.makeResponsive(descriptionLabel);
  50.         descriptionLabel.setWidth(100, Unit.PERCENTAGE);
  51.         panelContent.addComponent(descriptionLabel);
  52.         panelContent.setExpandRatio(descriptionLabel, ContentRatio.SMALL);
  53.     }

  55.     /**
  56.      * Adds an info row to the parent layout if value is not null or empty.
  57.      *
  58.      * @param parent  the parent layout
  59.      * @param caption the caption
  60.      * @param value   the value
  61.      * @param icon    the icon
  62.      */
  63.     public static final void addInfoRowIfNotNull(final VerticalLayout parent, final String caption, final String value,
  64.             final VaadinIcons icon) {
  65.         if (value != null && !value.trim().isEmpty() && !"null".equalsIgnoreCase(value)) {
  66.             parent.addComponent(CardInfoRowUtil.createInfoRow(caption, value, icon));
  67.         }
  68.     }

  70.     /**
  71.      * Creates a simple info row (caption and value) with optional icon.
  72.      *
  73.      * @param caption the field caption
  74.      * @param value   the field value
  75.      * @param icon    a VaadinIcons icon
  76.      * @return a HorizontalLayout representing the info row
  77.      */
  78.     public static final HorizontalLayout createInfoRow(final String caption, final String value,
  79.             final VaadinIcons icon) {
  80.         return CardInfoRowUtil.createInfoRow(caption, value, icon, null);
  81.     }

  83.     /**
  84.      * Creates a row displaying a caption and value, with optional icon and tooltip.
  85.      *
  86.      * @param caption the field caption
  87.      * @param value   the field value
  88.      * @param icon    a VaadinIcons icon for better visual cue
  89.      * @param tooltip optional tooltip to provide more info
  90.      * @return a HorizontalLayout representing the info row
  91.      */
  92.     public static final HorizontalLayout createInfoRow(final String caption, final String value, final VaadinIcons icon,
  93.             final String tooltip) {
  94.         final HorizontalLayout layout = new HorizontalLayout();
  95.         layout.setSpacing(true);
  96.         layout.addStyleName("metric-label");
  97.         layout.setWidthUndefined();

  99.         if (icon != null) {
  100.             final Label iconLabel = new Label(icon.getHtml(), ContentMode.HTML);
  101.             iconLabel.addStyleName("card-info-icon");
  102.             if (tooltip != null && !tooltip.isEmpty()) {
  103.                 iconLabel.setDescription(tooltip);
  104.             }
  105.             layout.addComponent(iconLabel);
  106.         }

  108.         final Label captionLabel = new Label(caption);
  109.         captionLabel.addStyleName("card-info-caption");
  110.         if (tooltip != null && !tooltip.isEmpty()) {
  111.             captionLabel.setDescription(tooltip);
  112.         }

  114.         final Label valueLabel = new Label(value != null ? value : "");
  115.         valueLabel.addStyleName("card-info-value");

  117.         layout.addComponents(captionLabel, valueLabel);
  118.         return layout;
  119.     }

  121.     /**
  122.      * Creates a section layout with a title and consistent styling.
  123.      *
  124.      * @param title the section title
  125.      * @return the vertical layout configured for the section
  126.      */
  127.     public static VerticalLayout createSectionLayout(final String title) {
  128.         final VerticalLayout layout = new VerticalLayout();
  129.         layout.setSpacing(true);
  130.         layout.setMargin(true);
  131.         layout.addStyleName("card-details-column");
  132.         layout.setWidth("100%");

  134.         final Label header = new Label(title);
  135.         header.addStyleName("card-section-title");
  136.         layout.addComponent(header);

  138.         // Add some vertical padding after the header
  139.         final Label padding = new Label();
  140.         padding.setHeight("10px");
  141.         layout.addComponent(padding);

  143.         return layout;
  144.     }

  146.     /**
  147.      * Creates the metric row.
  148.      *
  149.      * @param icon          the icon
  150.      * @param linkComponent the link component
  151.      * @param description   the description
  152.      * @param valueText     the value text
  153.      * @return the horizontal layout
  154.      */
  155.     public static final HorizontalLayout createMetricRow(final VaadinIcons icon,
  156.             final com.vaadin.ui.Component linkComponent, final String description, final String valueText) {
  157.         final HorizontalLayout layout = new HorizontalLayout();
  158.         layout.setSpacing(true);
  159.         layout.addStyleName("metric-label");
  160.         layout.setWidthUndefined();

  162.         final Label iconLabel = new Label(icon.getHtml(), ContentMode.HTML);
  163.         iconLabel.setDescription(description);

  165.         // Value displayed outside of the link
  166.         Label valueLabel = null;
  167.         if (valueText != null && !valueText.isEmpty()) {
  168.             valueLabel = new Label(valueText);
  169.             valueLabel.addStyleName("metric-value");
  170.         }

  172.         layout.addComponent(iconLabel);
  173.         layout.addComponent(linkComponent);
  174.         if (valueLabel != null) {
  175.             layout.addComponent(valueLabel);
  176.         }

  178.         return layout;
  179.     }

  181.     /**
  182.      * Creates the card header.
  183.      *
  184.      * @param cardContent the card content
  185.      * @param titleText   the title text
  186.      */
  187.     public static final void createCardHeader(final VerticalLayout cardContent, final String titleText) {
  188.         // Card Header
  189.         final HorizontalLayout headerLayout = new HorizontalLayout();
  190.         headerLayout.setSpacing(true);
  191.         headerLayout.setWidth("100%");
  192.         headerLayout.addStyleName("card-header-section");

  194.         final Label titleLabel = new Label(titleText, ContentMode.HTML);
  195.         titleLabel.addStyleName("card-title");
  196.         titleLabel.setWidthUndefined();
  197.         headerLayout.addComponent(titleLabel);

  199.         cardContent.addComponent(headerLayout);

  201.         // Divider line
  202.         final Label divider = new Label("<hr/>", ContentMode.HTML);
  203.         divider.addStyleName("card-divider");
  204.         divider.setWidth("100%");
  205.         cardContent.addComponent(divider);
  206.     }

  208.     /**
  209.      * Creates a standard stats container.
  210.      *
  211.      * @return the vertical layout configured for the stats container
  212.      */
  213.     public static final VerticalLayout createStatsContainer() {
  214.         final VerticalLayout layout = new VerticalLayout();
  215.         layout.setSpacing(false);
  216.         layout.addStyleName("card-stats-container");
  217.         layout.setWidth("100%");
  218.         return layout;
  219.     }

  221.     /**
  222.      * Creates the standard row.
  223.      *
  224.      * @return the horizontal layout
  225.      */
  226.     public static HorizontalLayout createStandardRow() {
  227.         final HorizontalLayout layout = new HorizontalLayout();
  228.         layout.setSpacing(true);
  229.         layout.setWidthUndefined();
  230.         return layout;
  231.     }

  233.     /**
  234.      * Creates the icon label.
  235.      *
  236.      * @param icon    the icon
  237.      * @param tooltip the tooltip
  238.      * @return the label
  239.      */
  240.     public static Label createIconLabel(final VaadinIcons icon, final String tooltip) {
  241.         final Label iconLabel = new Label(icon.getHtml(), ContentMode.HTML);
  242.         iconLabel.addStyleName(CARD_INFO_ICON);
  243.         if (tooltip != null) {
  244.             iconLabel.setDescription(tooltip);
  245.         }
  246.         return iconLabel;
  247.     }

  249. }
Created with JaCoCo 0.8.12.202403310830