Interface de plugins
O arquivo plugin.css oferece componentes para páginas de plugins do Titan Continuum. A prévia inclui filtros, ordenação, tabela responsiva e detalhes de pacotes em uma interface para consulta de versões Android.
Executar a prévia
Na raiz do repositório, execute:
php -S 127.0.0.1:8000 -t titanArchitect-sdk/design
Abra a prévia no navegador. Se você baixou o SDK como ZIP, execute php -S 127.0.0.1:8000 -t design na pasta extraída.
painel.php gera a página a partir de seis registros demonstrativos. A tabela, as datas e os detalhes são renderizados pelo PHP. plugin.js ativa os filtros, a ordenação, a cópia do hash e a seleção de tema quando o navegador executa JavaScript. Todo o estado da interface é local. Apenas a preferência de tema é salva no navegador.
Usar os componentes no plugin
Sirva uma cópia de plugin.css junto aos recursos estáticos do plugin. Carregue a folha de estilos e envolva a interface em um elemento com a classe titan-plugin.
<link rel="stylesheet" href="./plugin.css">
<section class="titan-plugin" aria-labelledby="titulo-versoes">
<header class="tp-section-heading">
<h1 id="titulo-versoes">Versões dos aplicativos</h1>
</header>
<div class="tp-grid">
<article class="tp-panel">
<h2>Titan Trusted MDM</h2>
<p class="tp-caption">Versão disponível</p>
<p><code class="tp-version">2.1.5</code></p>
<details class="tp-disclosure">
<summary>Ver detalhes</summary>
<p class="tp-caption">Formato APK para dispositivos Android.</p>
</details>
</article>
</div>
</section>
| Componente | Classes e marcação |
|---|---|
| Layout | .tp-grid agrupa painéis. .tp-panel define superfície, espaçamento e borda. .tp-section-heading acomoda título e resumo. |
| Texto e versão | .tp-caption estiliza um texto auxiliar. .tp-version destaca um identificador curto. |
| Campos e ações | .tp-control agrupa o rótulo e o campo. .tp-field estiliza entradas e seletores. .tp-action estiliza botões e links. .tp-action--secondary é a variação neutra. |
| Estado | .tp-status aceita data-state="active", "validation" e "archived". Escreva o estado também no conteúdo do elemento. |
| Dados | .tp-table-wrap e .tp-table compõem a tabela. Em telas estreitas, .tp-cell-label mostra o nome do campo no cartão. Use a estrutura de tabela e os papéis ARIA da prévia para preservar a semântica quando as linhas mudarem de layout. |
| Detalhes | .tp-disclosure estiliza <details> e <summary>. O navegador gerencia expansão e foco. |
| Feedback | .tp-empty apresenta uma lista vazia. .tp-alert aceita data-kind="success" ou "warning". Use uma região de status para anunciar resultados de ações. |
| Acessibilidade | .tp-sr-only mantém um texto na árvore de acessibilidade. .tp-skip revela um link de salto ao receber foco. |
Os quatro componentes do kit anterior continuam disponíveis em .tp-panel, .tp-caption, .tp-grid e .tp-action. Os seletores de componentes começam em .titan-plugin. As classes .tp-preview-page e .tp-preview configuram a página autônoma e podem ficar fora da integração.
Temas
A folha herda o tema claro ou escuro do atributo data-bs-theme do Titan Continuum. Fora do Titan, segue a preferência do sistema. Para uma página autônoma com seletor próprio, aplique data-titan-theme="light" ou data-titan-theme="dark" no elemento .titan-plugin. Os valores de fallback alternam em navegadores com suporte a light-dark(). Em navegadores anteriores, o kit usa os tokens do host e valores claros de fallback.
Defina os tokens no elemento raiz do plugin para preservar o restante da interface.
| Tokens | Uso |
|---|---|
--titan-ui-text, --titan-ui-muted |
Texto principal e auxiliar |
--titan-ui-surface, --titan-ui-subtle, --titan-ui-line, --titan-ui-control-border |
Fundo, áreas secundárias, bordas de painéis e contorno dos campos |
--titan-primary, --titan-on-primary, --titan-focus |
Ação principal, seu texto e indicador de foco |
--titan-ui-radius, --titan-ui-control-radius, --titan-ui-control-height |
Raios e altura mínima de controles |
--titan-ui-gap, --titan-ui-panel-space, --titan-ui-page-width, --titan-ui-shadow |
Ritmo, largura e apresentação das superfícies |
--titan-ui-font, --titan-ui-title-size, --titan-ui-section-size |
Tipografia |
Versões publicadas pelo Titan
Em um plugin integrado, consulte a operação downloads.release_manifest pelo cliente PHP ou TypeScript do SDK. Declare a dependência titan.downloads e a permissão downloads.read_release no manifesto. Envie {"app":"mdm"} ou {"app":"coletor"} para receber release, que contém a versão ativa do aplicativo ou null. Os exemplos de integração mostram como validar o manifesto e comparar a versão publicada com a versão de um dispositivo.
O histórico, as datas, os estados e os hashes da prévia são sintéticos. Ao exibir dados reais, monte a interface com a resposta autorizada do SDK, escape o texto recebido antes de renderizar HTML e trate separadamente ausência de publicação e falha de comunicação.