Componente EmptyState — sgcHTML | eSeGeCe

EmptyState

TsgcHTMLComponent_EmptyState — el panel que muestra una cuadrícula, una lista o un resultado de búsqueda cuando no tiene filas: un icono o una imagen, un título, una descripción y hasta dos botones, en Delphi, C++ Builder y .NET.

TsgcHTMLComponent_EmptyState

Define Icon, Title y Description, y luego lee la propiedad HTML; no emite ningún script, por lo que es seguro enviarlo como fragmento out-of-band tantas veces como necesite una página.

Clase del componente

TsgcHTMLComponent_EmptyState

Genera

Un único <div> de marcador de posición, sin script

Lenguajes

Delphi, C++ Builder, .NET

Indica correctamente que aquí no hay nada

Icon acepta una clase de icono CSS o marcado SVG en línea, emitido tal cual tras una comprobación de seguridad reducida; nunca vincules a él la entrada del usuario final — vincula en su lugar el texto no confiable a Title y Description, ambos siempre codificados 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.");

Propiedades y métodos clave

Los miembros que más vas a usar.

Icon / ImageURL

Clase de icono CSS o SVG en línea (saneado, se descarta si se rechaza); ImageURL prevalece sobre Icon cuando se definen ambos.

Title / Description

Siempre codificados en HTML, el par seguro para vincular a texto de base de datos o proporcionado por el usuario.

ActionCaption / ActionHref / ActionStyle

El botón principal de llamada a la acción, estilizado mediante la enumeración compartida TsgcHTMLButtonStyle, por defecto bsPrimary.

SecondaryActionCaption / SecondaryActionHref

Un segundo botón, siempre con estilo outline, sin propiedad de estilo propia.

Compact

Relleno más ajustado para un área incrustada pequeña (un widget, el cuerpo de una tabla) en lugar de una página o sección completa.

Build

Función de clase: construye, define Title/Description, renderiza y libera una instancia temporal en una sola llamada.

Sigue explorando

Ayuda en líneaReferencia completa de la API y guía de uso para este componente.
Todos los componentes de sgcHTMLExplora la matriz completa de más de 80 componentes.
Descargar prueba gratuitaLa prueba de 30 días incluye los proyectos de demostración 60.HTML.
PreciosLicencias Single, Team y Site con código fuente completo.
La mejor opción: All-AccessTodos los productos de eSeGeCe, con Premium Support incluido, desde €1,059 al año.
Ver precios de All-Access

¿Listo para empezar?

Descarga la prueba gratuita y añade paneles de estado vacío a tu aplicación web en Delphi, C++ Builder o .NET.