跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
设计与 UI

fluig-scaffolding-layout

Gera o esqueleto de um Layout WCM do Fluig — a view FreeMarker (.ftl) que define as regiões/áreas onde os widgets são posicionados, usando o grid responsivo do Style Guide. Use quando o desenvolvedor pedir para criar/iniciar um novo layout (template de página) do Fluig a partir de um nome ou propósito.

totvs · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add totvs/fluig-agent-skills --skill fluig-scaffolding-layout

技能说明


name: fluig-scaffolding-layout description: Gera o esqueleto de um Layout WCM do Fluig — a view FreeMarker (.ftl) que define as regiões/áreas onde os widgets são posicionados, usando o grid responsivo do Style Guide. Use quando o desenvolvedor pedir para criar/iniciar um novo layout (template de página) do Fluig a partir de um nome ou propósito. argument-hint: 'nome e/ou propósito do layout a ser gerado (ex.: "layout de duas colunas para o portal")'

Scaffolding de Layout (WCM)

Esta skill gera o esqueleto de um Layout WCM do Fluig; ela não duplica convenções — os arquivos de context/ são a fonte de verdade, referenciada abaixo.

Objetivo

Produzir, com responsabilidade única, o esqueleto de um Layout WCM do Fluig na estrutura oficial de pastas/arquivos: o descritor application.info (application.type=layout), a view FreeMarker (layout.ftl) que reproduz a estrutura HTML rígida de portal e declara os slots/regiões onde os widgets são encaixados, e os arquivos .properties de i18n.

Quando Usar

  • Ao criar um novo layout (template de página) do Fluig a partir do zero.
  • Quando o desenvolvedor fornece um nome/propósito e quer um ponto de partida correto (view com regiões) seguindo as convenções oficiais.
  • Quando é preciso garantir, desde o início, uso do grid do Style Guide, i18n nos textos visíveis e ausência de cores fixas.

Diferenças Críticas em Relação a um Widget

Layout e widget compartilham a estrutura WAR, mas o descritor e a view diferem. Atenção a estes pontos para não confundir os dois:

ItemWidgetLayout
application.typewidgetlayout
Template principalview.file=view.ftllayout.file=layout.ftl
Slot padrão—layout.defaultSlot=<Slot> (obrigatório)
Slots pré-configurados—slot.<Nome>=<código-widget> (opcional)
Flag no construtorapplication.uiwidgetapplication.uilayout
Responsivo—application.responsiveLayout=true
Renderização da áreaconteúdo próprio<@wcm.renderSlot id="..." /> por slot

Entradas Esperadas

EntradaDescriçãoObrigatória
Nome do layoutIdentificador em Inglês do layout (ex.: PortalTwoColumns)sim
Propósito/estruturaQuantas regiões/colunas e como o conteúdo se distribuinão
Chaves i18nChaves de tradução para títulos/textos visíveis do layoutnão

Contexto de Referência (Fonte de Verdade)

Leia antes de executar — não reproduza o conteúdo aqui:

  • architecture.md — modelo conceitual do Layout (template de página que define slots/regiões para widgets; view FreeMarker renderizada no servidor) e a estrutura oficial de pastas/arquivos do layout (descritor application.info, layout.ftl, .properties de i18n).
  • style-guide.md — grid responsivo (.container/.row/.col-*), componentes e variáveis CSS de tema (var(--fs-color-*)) para estruturar a página.
  • conventions.md — i18n (${i18n.getTranslation('chave')}) para textos visíveis e demais convenções públicas de código.

Estrutura de Saída

O layout gerado segue a estrutura oficial (fonte de verdade em architecture.md). O descritor application.info é obrigatório (com application.type=layout); a layout.ftl declara os slots/regiões. Use <code> como o código do layout (minúsculo).

<layout>/
├── pom.xml                                # quando o projeto usa Maven ou sob pedido
└── src/main/
    ├── resources/
    │   ├── application.info              # descritor (application.type=layout)
    │   ├── <code>.properties             # i18n base
    │   ├── <code>_pt_BR.properties        # i18n pt-BR
    │   ├── <code>_en_US.properties        # i18n en-US
    │   ├── <code>_es.properties           # i18n es
    │   └── layout.ftl                     # view do layout (declara os slots)
    └── webapp/
        ├── WEB-INF/{web.xml, jboss-web.xml}
        └── resources/
            ├── css/responsive_layout.css  # CSS padrão de responsividade (obrigatório)
            ├── css/<code>.css             # CSS próprio do layout (opcional)
            └── images/icon.png            # ícone

No application.info, declare layout.file=layout.ftl e layout.defaultSlot (slot padrão). Ponto de partida público: archetype Maven layout-wcm.

responsive_layout.css é padrão: todo layout inclui um responsive_layout.css em webapp/resources/css/, que cuida da responsividade das regiões/slots (container queries + media queries; empilha colunas em telas estreitas, com fallback .not-supports-container-queries). O descritor declara dois recursos CSS, nesta ordem: application.resource.css.1 aponta para a folha global do Fluig (/portal/resources/css/wcm_responsive_layout.css, caminho do portal) e application.resource.css.2 para o responsive_layout.css padrão do layout. Um <code>.css próprio (opcional) entra como recurso adicional. Conteúdo de referência em architecture.md.

A pasta WEB-INF traz web.xml e jboss-web.xml (com context-root = /<application.code>); o pom.xml aparece quando o projeto usa Maven ou sob pedido. Os blocos de referência desses arquivos vivem em architecture.md.

Em um projeto Fluig Studio, o layout fica em wcm/layout/<nome> (ver a seção "Estrutura de um Projeto Fluig Studio" em architecture.md).

pom.xml (quando o projeto usa Maven ou sob pedido)

Quando for necessário gerar o pom.xml, use a estrutura abaixo como ponto de partida — ajustando groupId/artifactId/version/name/description ao artefato. O empacotamento é war e o finalName usa ${project.artifactId}. A referência canônica completa está em architecture.md.

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<project xmlns="http://maven.apache.org/POM
阅读完整来源 ↗