EmptyState Component — sgcHTML | eSeGeCe

EmptyState

TsgcHTMLComponent_EmptyState — il pannello che una griglia, un elenco o un risultato di ricerca mostra quando non ha righe: un’icona o un’immagine, un titolo, una descrizione e fino a due pulsanti, in Delphi, C++ Builder e .NET.

TsgcHTMLComponent_EmptyState

Imposta Icon, Title e Description, quindi leggi la proprietà HTML; non genera alcuno script, quindi è sicuro inviarlo come frammento out-of-band tutte le volte che una pagina ne ha bisogno.

Classe del componente

TsgcHTMLComponent_EmptyState

Renderizza

Un singolo <div> segnaposto, nessuno script

Linguaggi

Delphi, C++ Builder, .NET

Comunica correttamente che qui non c’è nulla

Icon accetta una classe icona CSS o markup SVG inline, emesso testualmente dopo un controllo di sicurezza limitato; non collegarci mai input dell’utente finale — collega invece il testo non attendibile a Title e Description, entrambi sempre codificati in 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.");

Proprietà e metodi principali

I membri che utilizzerai più spesso.

Icon / ImageURL

Classe icona CSS o SVG inline (sanificato, scartato se non valido); ImageURL prevale su Icon quando entrambi sono impostati.

Title / Description

Sempre codificati in HTML, la coppia sicura da collegare a testo proveniente da database o dall’utente.

ActionCaption / ActionHref / ActionStyle

Il pulsante di call-to-action principale, stilizzato tramite l’enum condiviso TsgcHTMLButtonStyle, predefinito bsPrimary.

SecondaryActionCaption / SecondaryActionHref

Un secondo pulsante, sempre in stile outline, senza una propria proprietà di stile.

Compact

Padding più ridotto per una piccola area incorporata (un widget, il corpo di una tabella) invece di un’intera pagina/sezione.

Build

Funzione di classe: costruisce, imposta Title/Description, renderizza e libera un’istanza temporanea in un’unica chiamata.

Continua a esplorare

Guida in lineaRiferimento API completo e guida all’uso per questo componente.
Tutti i componenti sgcHTMLEsplora la matrice completa delle funzionalità di oltre 80 componenti.
Scarica la Prova GratuitaLa prova di 30 giorni include i progetti demo 60.HTML.
PrezziLicenze Single, Team e Site con codice sorgente completo.
La scelta più conveniente: All-AccessTutti i prodotti eSeGeCe, con Supporto Premium incluso, a partire da €1,059/anno.
Vedi i prezzi All-Access

Pronto a Iniziare?

Scarica la versione di prova gratuita e inizia a creare interfacce web in Delphi, C++ Builder e .NET.