render.gno

 1package avl_pager_params
 2
 3import (
 4	"gno.land/p/demo/avl"
 5	"gno.land/p/demo/avl/pager"
 6	"gno.land/p/demo/seqid"
 7	"gno.land/p/demo/ufmt"
 8	"gno.land/p/moul/realmpath"
 9)
10
11// We'll keep some demo data in an AVL tree to showcase pagination.
12var (
13	items     *avl.Tree
14	idCounter seqid.ID
15)
16
17func init() {
18	items = avl.NewTree()
19	// Populate the tree with 15 sample items for demonstration.
20	for i := 1; i <= 15; i++ {
21		id := idCounter.Next().String()
22		items.Set(id, "Some item value: "+id)
23	}
24}
25
26func Render(path string) string {
27	// 1) Parse the incoming path to split route vs. query.
28	req := realmpath.Parse(path)
29	//    - req.Path contains everything *before* ? or $ (? - query params, $ - gnoweb params)
30	//    - The remaining part (page=2, size=5, etc.) is not in req.Path.
31
32	// 2) If no specific route is provided (req.Path == ""), we’ll show a “home” page
33	//    that displays a list of configs in paginated form.
34	if req.Path == "" {
35		return renderHome(path)
36	}
37
38	// 3) If a route *is* provided (e.g. :SomeKey),
39	//    we will interpret it as a request for a specific page.
40	return renderConfigItem(req.Path)
41}
42
43// renderHome shows a paginated list of config items if route == "".
44func renderHome(fullPath string) string {
45	// Create a Pager for our config tree, with a default page size of 5.
46	p := pager.NewPager(items, 5, false)
47
48	// MustGetPageByPath uses the *entire* path (including query parts: ?page=2, etc.)
49	page := p.MustGetPageByPath(fullPath)
50
51	// Start building the output (plain text or markdown).
52	out := "# AVL Pager + Render paths\n\n"
53	out += `This realm showcases how to maintain a paginated list while properly parsing render paths. 
54You can see how a single page can include a paginated element (like the example below), and how clicking 
55an item can take you to a dedicated page for that specific item.
56
57No matter how you browse through the paginated list, the introductory text (this section) remains the same.
58
59`
60
61	out += ufmt.Sprintf("Showing page %d of %d\n\n", page.PageNumber, page.TotalPages)
62
63	// List items for this page.
64	for _, item := range page.Items {
65		// Link each item to a details page: e.g. ":Config01"
66		out += ufmt.Sprintf("- [Item %s](/r/docs/avl_pager_params:%s)\n", item.Key, item.Key)
67	}
68
69	// Insert pagination controls (previous/next links, etc.).
70	out += "\n" + page.Picker(fullPath) + "\n\n"
71	out += "### [Go back to r/docs](/r/docs)"
72
73	return out
74}
75
76// renderConfigItem shows details for a single item, e.g. ":item001".
77func renderConfigItem(itemName string) string {
78	value, ok := items.Get(itemName)
79	if !ok {
80		return ufmt.Sprintf("**No item found** for key: %s", itemName)
81	}
82
83	out := ufmt.Sprintf("# Item %s\n\n%s\n\n", itemName, value.(string))
84	out += "[Go back](/r/docs/avl_pager_params)"
85	return out
86}