✨ (base) Añade ListView y ListFilter para listados

- ListView: botones, mensajes, tabla y paginador en orden fijo;
  anuncia el número de resultados a los lectores de pantalla.
- ListFilter: filtros en fila con "Filtrar" y "Limpiar", envío
  automático opcional y marcas de cambios sin aplicar.
- pagetop-htmx: hx_pager::boost() y hx_filter::boost(); cancelan
  las peticiones solapadas y atenúan el listado mientras carga,
  con estilos sólo en las páginas con listado.
- Usuarios y roles migrados al nuevo patrón.
This commit is contained in:
Manuel Cillero 2026-11-10 22:49:40 +01:00
parent 0f71eba7ab
commit d8493291e4
28 changed files with 1264 additions and 144 deletions

View file

@ -0,0 +1,126 @@
use pagetop::prelude::*;
// **< ListFilter >*********************************************************************************
#[pagetop::test]
async fn renders_a_get_form_with_its_fields_and_the_button() {
let mut filter = ListFilter::new()
.with_filter_action("/items")
.with_field(form::input::Field::search().with_name("q"));
let html = filter.render(&mut Context::default()).await.into_string();
assert!(html.starts_with("<form"), "{html}");
assert!(html.contains(r#"class="list-filter""#), "{html}");
assert!(html.contains(r#"action="/items""#), "{html}");
assert!(
!html.contains("method="),
"a GET form needs no method: {html}"
);
assert!(html.contains(r#"name="q""#), "{html}");
assert!(html.contains(r#"type="submit""#), "{html}");
}
#[pagetop::test]
async fn keeps_the_language_of_the_action_in_a_hidden_field() {
// A GET form drops the query of its action, so the language must travel as a field.
let mut filter =
ListFilter::new().with_filter_action(RoutePath::new("/items").with_param("lang", "es-ES"));
let html = filter.render(&mut Context::default()).await.into_string();
assert!(html.contains(r#"type="hidden""#), "{html}");
assert!(html.contains(r#"name="lang""#), "{html}");
assert!(html.contains(r#"value="es-ES""#), "{html}");
}
#[pagetop::test]
async fn the_button_label_can_be_changed() {
let mut filter = ListFilter::new()
.with_filter_action("/items")
.with_submit(Lc::n("Search"));
let html = filter.render(&mut Context::default()).await.into_string();
assert!(html.contains("Search"), "{html}");
}
#[pagetop::test]
async fn by_default_it_applies_with_the_button() {
let mut filter = ListFilter::new().with_filter_action("/items");
let html = filter.render(&mut Context::default()).await.into_string();
assert!(!html.contains("onchange"), "{html}");
assert!(!html.contains("<noscript>"), "{html}");
}
#[pagetop::test]
async fn auto_submit_applies_on_change_and_keeps_the_button_only_without_javascript() {
let mut filter = ListFilter::new()
.with_filter_action("/items")
.with_auto_submit(true);
let html = filter.render(&mut Context::default()).await.into_string();
assert!(
html.contains(r#"onchange="this.requestSubmit()""#),
"{html}"
);
assert!(
html.contains(r#"<noscript><button type="submit""#),
"{html}"
);
}
#[pagetop::test]
async fn the_reset_link_goes_back_to_the_list_with_no_filters() {
let mut filter = ListFilter::new().with_filter_action("/items");
let html = filter.render(&mut Context::default()).await.into_string();
let link = html
.find("<a")
.map(|start| &html[start..])
.expect("reset link");
assert!(link.contains(r#"href="/items""#), "{html}");
// Not intercepted by libraries that load only part of the page, so the fields are emptied too.
assert!(link.contains(r#"target="_top""#), "{html}");
}
#[pagetop::test]
async fn the_reset_link_can_be_removed() {
let mut filter = ListFilter::new()
.with_filter_action("/items")
.with_reset(false);
let html = filter.render(&mut Context::default()).await.into_string();
assert!(!html.contains("<a"), "{html}");
}
#[pagetop::test]
async fn with_the_button_it_marks_pending_changes() {
let mut cx = Context::default();
let mut filter = ListFilter::new().with_filter_action("/items");
let html = filter.render(&mut cx).await.into_string();
let assets = cx.render_assets().into_string();
// The script marks changed fields; the hidden status announces them to screen readers.
assert!(
assets.contains("/pagetop/js/list-filter.min.js"),
"{assets}"
);
assert!(
html.contains(r#"class="list-filter-status visually-hidden""#),
"{html}"
);
assert!(html.contains(r#"role="status""#), "{html}");
assert!(html.contains("data-pending="), "{html}");
}
#[pagetop::test]
async fn auto_submit_has_nothing_pending_to_mark() {
let mut cx = Context::default();
let mut filter = ListFilter::new()
.with_filter_action("/items")
.with_auto_submit(true);
let html = filter.render(&mut cx).await.into_string();
let assets = cx.render_assets().into_string();
assert!(!assets.contains("list-filter.min.js"), "{assets}");
assert!(!html.contains("list-filter-status"), "{html}");
}

View file

@ -0,0 +1,86 @@
use pagetop::prelude::*;
// **< ListView >***********************************************************************************
fn pager() -> Pager {
Pager::new()
.with_base_path("/items")
.with_current_page(1)
.with_items_per_page(10)
.with_total_items(50)
}
fn table() -> Table {
Table::new()
.with_column(Lc::n("Name"))
.with_empty(Lc::n("No items"))
}
#[pagetop::test]
async fn renders_its_id_and_class() {
let mut list = ListView::new().with_id("item-list").with_table(table());
let html = list.render(&mut Context::default()).await.into_string();
assert!(html.starts_with("<div"), "{html}");
assert!(html.contains(r#"id="item-list""#), "{html}");
assert!(html.contains(r#"class="list-view""#), "{html}");
}
#[pagetop::test]
async fn renders_the_parts_in_a_fixed_order() {
// Added in reverse order on purpose: the output order must not depend on it.
let mut list = ListView::new()
.with_pager(pager())
.with_table(table())
.with_action(Button::anchor(Lc::n("New item"), "/items/new"));
let mut cx = Context::default();
cx.push_message(MessageLevel::Error, Lc::n("Something failed"));
let html = list.render(&mut cx).await.into_string();
let actions = html.find("list-view-actions").expect("actions");
let message = html.find("Something failed").expect("message");
let table = html.find("<table").expect("table");
let pager = html.find("<nav").expect("pager");
assert!(actions < message && message < table && table < pager);
}
#[pagetop::test]
async fn without_actions_there_is_no_actions_row() {
let mut list = ListView::new().with_table(table());
let html = list.render(&mut Context::default()).await.into_string();
assert!(!html.contains("list-view-actions"));
assert!(html.contains("No items"));
}
#[pagetop::test]
async fn it_carries_a_summary_of_the_results_and_its_script() {
let mut cx = Context::default();
let mut list = ListView::new().with_table(table()).with_pager(pager());
let html = list.render(&mut cx).await.into_string();
let assets = cx.render_assets().into_string();
// The total of the pager, not only the rows on this page.
assert!(html.contains(r#"data-summary="50 results""#), "{html}");
assert!(assets.contains("/pagetop/js/list-view.min.js"), "{assets}");
}
#[pagetop::test]
async fn without_a_pager_the_summary_counts_the_rows() {
let mut list = ListView::new().with_table(
table()
.with_row(table::Row::new().with_cell(Lc::n("A")))
.with_row(table::Row::new().with_cell(Lc::n("B"))),
);
let html = list.render(&mut Context::default()).await.into_string();
assert!(html.contains(r#"data-summary="2 results""#), "{html}");
let mut one =
ListView::new().with_table(table().with_row(table::Row::new().with_cell(Lc::n("A"))));
let html = one.render(&mut Context::default()).await.into_string();
assert!(html.contains(r#"data-summary="1 result""#), "{html}");
let mut none = ListView::new().with_table(table());
let html = none.render(&mut Context::default()).await.into_string();
assert!(html.contains(r#"data-summary="No results""#), "{html}");
}