Komponent EmptyState — sgcHTML | eSeGeCe

EmptyState

TsgcHTMLComponent_EmptyState — panel wyświetlany przez siatkę, listę lub wynik wyszukiwania, gdy nie ma żadnych wierszy: ikona lub obraz, tytuł, opis i do dwóch przycisków, w Delphi, C++ Builder i .NET.

TsgcHTMLComponent_EmptyState

Ustaw Icon, Title i Description, a następnie odczytaj właściwość HTML; komponent w ogóle nie generuje skryptu, więc można go bezpiecznie wysyłać jako fragment poza pasmem (out-of-band) tak często, jak potrzebuje tego strona.

Klasa komponentu

TsgcHTMLComponent_EmptyState

Renderuje

Pojedynczy element zastępczy <div>, bez skryptu

Języki

Delphi, C++ Builder, .NET

Powiedz poprawnie, że nic tu nie ma

Icon przyjmuje klasę ikony CSS lub wbudowany znacznik SVG, generowany dosłownie po wąskiej kontroli bezpieczeństwa; nigdy nie wiąż z nim danych wejściowych użytkownika końcowego — zamiast tego wiąż niezaufany tekst z Title i Description, oba zawsze kodowane do 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.");

Kluczowe właściwości i metody

Składniki, po które sięgasz najczęściej.

Icon / ImageURL

Klasa ikony CSS lub wbudowany SVG (sanityzowany, odrzucany w razie niezgodności); ImageURL ma pierwszeństwo przed Icon, gdy oba są ustawione.

Title / Description

Zawsze kodowane do HTML, bezpieczna para do wiązania z danymi z bazy lub tekstem podanym przez użytkownika.

ActionCaption / ActionHref / ActionStyle

Główny przycisk wezwania do działania, stylizowany za pomocą wspólnego wyliczenia TsgcHTMLButtonStyle, domyślnie bsPrimary.

SecondaryActionCaption / SecondaryActionHref

Drugi przycisk, zawsze w stylu obrysowym, bez własnej właściwości stylu.

Compact

Mniejsze odstępy dla małego, osadzonego obszaru (widżetu, ciała tabeli) zamiast całej strony/sekcji.

Build

Funkcja klasowa: tworzy, ustawia Title/Description, renderuje i zwalnia tymczasową instancję w jednym wywołaniu.

Poznawaj dalej

Pomoc onlinePełna dokumentacja API i przewodnik użytkowania tego komponentu.
Wszystkie komponenty sgcHTMLPrzejrzyj pełną matrycę funkcji 80+ komponentów.
Pobierz bezpłatną wersję próbną30-dniowa wersja próbna zawiera projekty demonstracyjne 60.HTML.
CennikLicencje Single, Team i Site z pełnym kodem źródłowym.
Najkorzystniejsza oferta: All-AccessWszystkie produkty eSeGeCe, ze wsparciem Premium w cenie, już od €1,059 rocznie.
Zobacz cennik All-Access

Gotowy, aby zacząć?

Pobierz bezpłatną wersję próbną i zacznij budować interfejsy webowe w Delphi, C++ Builder i .NET.