Componente EmptyState — sgcHTML | eSeGeCe

EmptyState

TsgcHTMLComponent_EmptyState — o painel que um grid, uma lista ou um resultado de busca exibe quando não há linhas: um ícone ou uma imagem, um título, uma descrição e até dois botões, em Delphi, C++ Builder e .NET.

TsgcHTMLComponent_EmptyState

Defina Icon, Title e Description, depois leia a propriedade HTML; ele não emite script algum, então é seguro enviá-lo como fragmento out-of-band com a frequência que a página precisar.

Classe do componente

TsgcHTMLComponent_EmptyState

Renderiza

Uma única <div> de espaço reservado, sem script

Linguagens

Delphi, C++ Builder, .NET

Diga que não há nada aqui, com propriedade

Icon aceita uma classe de ícone CSS ou markup SVG inline, emitido literalmente após uma verificação de segurança restrita; nunca vincule entrada do usuário final a ele — vincule texto não confiável a Title e Description, ambos sempre codificados em HTML.

uses
  sgcHTML_Enums, sgcHTML_Component_EmptyState;

var
  oEmpty: TsgcHTMLComponent_EmptyState;
begin
  oEmpty := TsgcHTMLComponent_EmptyState.Create(nil);
  try
    oEmpty.Icon := 'bi bi-inbox';
    oEmpty.Title := 'No results';
    oEmpty.Description := 'Try a different search, or clear your filters.';
    oEmpty.ActionCaption := 'Clear filters';
    oEmpty.ActionHref := '/orders';
    oEmpty.ActionStyle := bsPrimary;

    WebModule.Response := oEmpty.HTML;
  finally
    oEmpty.Free;
  end;
end;

// Or the one-line static helper for the simple case:
WebModule.Response := TsgcHTMLComponent_EmptyState.Build('No results', 'Try a different search.');
// includes: sgcHTML_Component_EmptyState.hpp

TsgcHTMLComponent_EmptyState *oEmpty = new TsgcHTMLComponent_EmptyState(NULL);
try
{
  oEmpty->Icon = "bi bi-inbox";
  oEmpty->Title = "No results";
  oEmpty->Description = "Try a different search, or clear your filters.";
  oEmpty->ActionCaption = "Clear filters";
  oEmpty->ActionHref = "/orders";
  oEmpty->ActionStyle = bsPrimary;

  String html = oEmpty->HTML;
}
__finally
{
  delete oEmpty;
}

// Or the one-line static helper for the simple case:
String html2 = TsgcHTMLComponent_EmptyState::Build("No results", "Try a different search.");
using esegece.sgcWebSockets;

var empty = new TsgcHTMLComponent_EmptyState();
empty.Icon = "bi bi-inbox";
empty.Title = "No results";
empty.Description = "Try a different search, or clear your filters.";
empty.ActionCaption = "Clear filters";
empty.ActionHref = "/orders";
empty.ActionStyle = ButtonStyle.bsPrimary;

string html = empty.HTML;

// Or the one-line static helper for the simple case:
string html2 = TsgcHTMLComponent_EmptyState.Build("No results", "Try a different search.");

Principais propriedades & métodos

Os membros que você usa com mais frequência.

Icon / ImageURL

Classe de ícone CSS ou SVG inline (sanitizado, descartado em caso de rejeição); ImageURL prevalece sobre Icon quando ambos estão definidos.

Title / Description

Sempre codificados em HTML, o par seguro para vincular a texto de banco de dados ou fornecido pelo usuário.

ActionCaption / ActionHref / ActionStyle

O botão principal de chamada para ação, estilizado através do enum compartilhado TsgcHTMLButtonStyle, padrão bsPrimary.

SecondaryActionCaption / SecondaryActionHref

Um segundo botão, sempre com estilo outline, sem propriedade de estilo própria.

Compact

Espaçamento mais reduzido para uma pequena área embutida (um widget, o corpo de uma tabela) em vez de uma página/seção inteira.

Build

Função de classe: constrói, define Title/Description, renderiza e libera uma instância temporária em uma única chamada.

Continue explorando

Ajuda onlineReferência completa da API e guia de uso para este componente.
Todos os Componentes sgcHTMLExplore a matriz completa de recursos com mais de 80 componentes.
Baixar Versão de Avaliação GratuitaA avaliação de 30 dias inclui os projetos de demonstração 60.HTML.
PreçosLicenças Single, Team e Site com código-fonte completo.
Melhor custo-benefício: All-AccessTodos os produtos da eSeGeCe, com Suporte Premium incluído, a partir de €1,059/ano.
Ver preços do All-Access

Pronto para Começar?

Baixe a versão de avaliação gratuita e comece a construir UIs web em Delphi, C++ Builder e .NET.