EmptyState-component — sgcHTML | eSeGeCe

EmptyState

TsgcHTMLComponent_EmptyState — het paneel dat een grid, een lijst of een zoekresultaat toont wanneer er geen rijen zijn: een icoon of een afbeelding, een titel, een beschrijving en tot twee knoppen, in Delphi, C++ Builder en .NET.

TsgcHTMLComponent_EmptyState

Stel Icon, Title en Description in en lees dan de HTML-eigenschap; het genereert helemaal geen script, dus het is veilig om het zo vaak als een pagina nodig heeft als out-of-band fragment te pushen.

Componentklasse

TsgcHTMLComponent_EmptyState

Rendert

Eén enkele placeholder <div>, geen script

Talen

Delphi, C++ Builder, .NET

Zeg netjes dat er hier niets is

Icon accepteert een CSS-iconklasse of inline SVG-markup, ongewijzigd uitgevoerd na een beperkte veiligheidscontrole; bind nooit eindgebruikersinvoer eraan — bind niet-vertrouwde tekst in plaats daarvan aan Title en Description, die altijd HTML-geëncodeerd worden.

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.");

Belangrijkste eigenschappen en methoden

De members die je het vaakst gebruikt.

Icon / ImageURL

CSS-iconklasse of inline SVG (gesaneerd, verworpen bij afwijzing); ImageURL heeft voorrang op Icon wanneer beide zijn ingesteld.

Title / Description

Altijd HTML-geëncodeerd, het veilige paar om aan database- of gebruikersinvoer te binden.

ActionCaption / ActionHref / ActionStyle

De primaire call-to-action-knop, gestyled via de gedeelde TsgcHTMLButtonStyle-enum, standaard bsPrimary.

SecondaryActionCaption / SecondaryActionHref

Een tweede knop, altijd outline-gestyled, zonder eigen stijleigenschap.

Compact

Krappere padding voor een klein ingesloten gebied (een widget, een tabelbody) in plaats van een hele pagina/sectie.

Build

Klassefunctie: construeert, stelt Title/Description in, rendert en geeft een tijdelijke instantie vrij in één aanroep.

Blijf ontdekken

Online helpVolledige API-referentie en gebruikshandleiding voor dit onderdeel.
Alle sgcHTML-componentenBlader door de volledige functiematrix van 80+ componenten.
Download gratis proefversieDe proefversie van 30 dagen bevat de 60.HTML-demoprojecten.
PrijzenSingle-, Team- en Site-licenties met volledige broncode.
De beste deal: All-AccessElk eSeGeCe-product, inclusief Premium-ondersteuning, vanaf €1,059 per jaar.
Bekijk de All-Access-prijzen

Klaar om te beginnen?

Download de gratis proefversie en begin met het bouwen van web-UI's in Delphi, C++ Builder en .NET.