AGENT SKILL

tsql-queryblock

Componente React QueryBlock de TailwindSQL. Trigger: Cuando usás el componente QueryBlock en React.

License 许可
Apache-2.0
最近更新
2026-08-26
Stars
★ 1
Forks
0

01 前言 Front Matter

name
tsql-queryblock
license
Apache-2.0
metadata
{ "author": "gentleman-programming", "version": "1.0" }
description
Componente React QueryBlock de TailwindSQL. Trigger: Cuando usás el componente QueryBlock en React.

03 SKILL.md 正文

QueryBlock - Componente Principal

import { QueryBlock } from "../tailwindsql.config";

function UsersPage() {
  return (
    <QueryBlock query="select-all from-[User]">
      {(users) => (
        <ul>
          {users.map(user => (
            <li key={user.id}>{user.name}</li>
          ))}
        </ul>
      )}
    </QueryBlock>
  );
}

Props

Prop Tipo Requerido Descripción
query string Sí Query TailwindSQL
adapter function No* Función que ejecuta SQL
children function Sí Render function
fallback ReactNode No Loading state
loadingDelay number No Delay antes de mostrar loading

*Si no se pasa, usa el adapter global configurado.

Render Function

// children es una función que recibe los datos
{(users) => <ul>{users.map(u => <li>{u.name}</li>)}</ul>}

// Con estado de loading
{(users, isLoading, error) => (
  <>
    {isLoading && <Spinner />}
    {error && <Error msg={error.message} />}
    <ul>{users.map(u => <li>{u.name}</li>)}</ul>
  </>
)}

Configuración Global

// tailwindsql.config.ts
import { configTailwindSQL } from "@repo/tailwindsql";
import { executeSQL } from "./app/actions";

export const { QueryBlock } = configTailwindSQL({
  adapter: executeSQL,
  loadingDelay: 200,  // ms
  defaultFallback: <div>Cargando...</div>
});

Docs

04 同仓库更多 Skills