Syxis.TagHelpers 0.1.0-beta.18

Syxis.TagHelpers

Biblioteca de controles Razor para ASP.NET Core MVC.

Instalación

Instale la versión publicada o use una referencia al proyecto durante el desarrollo:

dotnet add package Syxis.TagHelpers --version 0.1.0-beta.17

<ProjectReference Include="..\Syxis.TagHelpers\Syxis.TagHelpers.csproj" />

Registre los Tag Helpers en Views/_ViewImports.cshtml:

@addTagHelper *, Syxis.TagHelpers

Incluya todos los recursos en el <head> del layout:

<sx-assets profile="all" />

También puede cargar únicamente un perfil:

<sx-assets profile="forms" />
<sx-assets profile="navigation" />
<sx-assets profile="custom" include="datepicker,select,modal" />

sx-assets resuelve vendors, orden, duplicados y hashes de caché. Consulte docs/assets.md para perfiles, exclusiones, CSP y carga separada de estilos o scripts.

Compatibilidad y versiones

El paquete incluye ensamblados para net8.0 y net10.0, símbolos portables y Source Link. Los cambios de cada versión se encuentran en CHANGELOG.md.

Primer control

<sx-input asp-for="Correo"
          label="Correo electrónico"
          placeholder="nombre@empresa.com"
          autocomplete="email" />

El control obtiene automáticamente nombre, identificador, valor, tipo y reglas de validación desde el modelo.

DataTable en modo servidor

private static readonly DataTableDefinition<Usuario> Table =
    new DataTableDefinition<Usuario>()
        .SearchBy(x => x.Nombre)
        .SortBy("id", x => x.Id)
        .SortBy("nombre", x => x.Nombre)
        .DefaultSort("id")
        .FilterText("nombre", x => x.Nombre);

[HttpGet("/api/usuarios")]
public IActionResult Get([FromQuery] DataTableRequest request) =>
    Json(Table.CreateResponse(_users, request));

Principios

• Integración nativa con asp-for y ModelState.
• HTML codificado mediante APIs de ASP.NET Core.
• Accesibilidad como requisito.
• CSS y JavaScript distribuidos como static web assets.
• Inicialización JavaScript idempotente.
• API consistente entre controles.

Color personalizable

<section data-syxis-color="violet">
  <sx-input asp-for="Nombre" />
  <sx-button text="Guardar" />
</section>

<sx-button text="Publicar" data-syxis-gradient="sunset" />

Incluye diez paletas, ocho degradados y variables de acento configurables globalmente, por sección o por control. Consulte docs/theme.md.

Iconos Lucide

<sx-icon name="circle-check" size="20" />
<sx-button text="Guardar" icon="save" />

Lucide 1.23.0 se distribuye como asset local y se carga con los perfiles estándar. Consulte docs/icons.md para accesibilidad, personalización y contenido dinámico.

Licencia

Syxis.TagHelpers se distribuye bajo la licencia MIT.