EmptyState Component — sgcHTML | eSeGeCe

EmptyState

TsgcHTMLComponent_EmptyState — das Panel, das ein Grid, eine Liste oder ein Suchergebnis anzeigt, wenn keine Zeilen vorhanden sind: ein Icon oder ein Bild, ein Titel, eine Beschreibung und bis zu zwei Buttons, in Delphi, C++ Builder und .NET.

TsgcHTMLComponent_EmptyState

Setzen Sie Icon, Title und Description und lesen Sie dann die HTML-Eigenschaft; sie erzeugt gar kein Skript, daher lässt sie sich so oft wie nötig als Out-of-Band-Fragment senden.

Komponentenklasse

TsgcHTMLComponent_EmptyState

Rendert

Ein einzelnes Platzhalter-<div>, kein Skript

Sprachen

Delphi, C++ Builder, .NET

Sagen Sie, dass hier nichts ist, aber richtig

Icon akzeptiert eine CSS-Icon-Klasse oder Inline-SVG-Markup, das nach einer schmalen Sicherheitsprüfung unverändert ausgegeben wird; binden Sie niemals Benutzereingaben daran — binden Sie nicht vertrauenswürdigen Text stattdessen an Title und Description, die beide stets HTML-kodiert werden.

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

Wichtige Eigenschaften & Methoden

Die Member, die Sie am häufigsten verwenden.

Icon / ImageURL

CSS-Icon-Klasse oder Inline-SVG (bereinigt, bei Ablehnung verworfen); ImageURL hat Vorrang vor Icon, wenn beide gesetzt sind.

Title / Description

Stets HTML-kodiert, das sichere Paar zum Binden von Datenbank- oder benutzerseitig eingegebenem Text.

ActionCaption / ActionHref / ActionStyle

Der primäre Call-to-Action-Button, gestaltet über das gemeinsame TsgcHTMLButtonStyle-Enum, Standard bsPrimary.

SecondaryActionCaption / SecondaryActionHref

Ein zweiter Button, stets im Outline-Stil, ohne eigene Style-Eigenschaft.

Compact

Engerer Innenabstand für einen kleinen eingebetteten Bereich (ein Widget, ein Tabellenkörper) statt einer ganzen Seite/Sektion.

Build

Klassenfunktion: erzeugt eine temporäre Instanz, setzt Title/Description, rendert und gibt sie in einem einzigen Aufruf wieder frei.

Weiter entdecken

Online-HilfeVollständige API-Referenz und Verwendungshandbuch für diese Komponente.
Alle sgcHTML-KomponentenDurchsuchen Sie die vollständige Funktionsmatrix von über 80 Komponenten.
Kostenlose Testversion herunterladenDie 30-Tage-Testversion enthält die 60.HTML-Demoprojekte.
PreiseSingle-, Team- und Site-Lizenzen mit vollständigem Quellcode.
Bestes Preis-Leistungs-Verhältnis: All-AccessAlle eSeGeCe-Produkte, inklusive Premium-Support, ab €1,059 pro Jahr.
All-Access-Preise ansehen

Bereit loszulegen?

Laden Sie die kostenlose Testversion herunter und beginnen Sie, Web-UIs in Delphi, C++ Builder und .NET zu erstellen.