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.