Composant EmptyState — sgcHTML | eSeGeCe

EmptyState

TsgcHTMLComponent_EmptyState — le panneau qu'une grille, une liste ou un résultat de recherche affiche lorsqu'il n'a aucune ligne : une icône ou une image, un titre, une description et jusqu'à deux boutons, en Delphi, C++ Builder et .NET.

TsgcHTMLComponent_EmptyState

Définissez Icon, Title et Description, puis lisez la propriété HTML ; il n'émet aucun script, il est donc sûr de le pousser en tant que fragment hors-bande aussi souvent qu'une page en a besoin.

Classe du composant

TsgcHTMLComponent_EmptyState

Produit

Un unique <div> d'espace réservé, aucun script

Langages

Delphi, C++ Builder, .NET

Dites qu'il n'y a rien ici, correctement

Icon accepte une classe d'icône CSS ou du balisage SVG en ligne, émis tel quel après un contrôle de sécurité restreint ; ne liez jamais une saisie d'utilisateur final à cette propriété — liez plutôt le texte non fiable à Title et Description, tous deux toujours encodés en 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.");

Propriétés & méthodes clés

Les membres que vous utilisez le plus souvent.

Icon / ImageURL

Classe d'icône CSS ou SVG en ligne (assaini, rejeté si invalide) ; ImageURL l'emporte sur Icon quand les deux sont définis.

Title / Description

Toujours encodés en HTML, la paire sûre à lier à des données de base ou à du texte fourni par l'utilisateur.

ActionCaption / ActionHref / ActionStyle

Le bouton d'action principal, stylé via l'énumération partagée TsgcHTMLButtonStyle, par défaut bsPrimary.

SecondaryActionCaption / SecondaryActionHref

Un second bouton, toujours de style contour, sans propriété de style qui lui soit propre.

Compact

Un espacement plus resserré pour une petite zone intégrée (un widget, un corps de tableau) plutôt qu'une page ou section entière.

Build

Fonction de classe : construit, définit Title/Description, rend puis libère une instance temporaire en un seul appel.

Continuez l'exploration

Aide en ligneRéférence API complète et guide d'utilisation pour ce composant.
Tous les composants sgcHTMLParcourez la matrice complète des fonctionnalités de plus de 80 composants.
Télécharger la version d'essai gratuiteLa version d'essai de 30 jours fournit les projets de démonstration 60.HTML.
TarifsLicences Single, Team et Site avec code source complet.
Meilleur rapport qualité-prix : All-AccessTous les produits eSeGeCe, Support Premium inclus, à partir de €1,059/an.
Voir les tarifs All-Access

Prêt à démarrer ?

Téléchargez la version d'essai gratuite et commencez à créer des interfaces web en Delphi, C++ Builder et .NET.