monomer-hagrid: A datagrid widget for the Monomer library.

[ gui, library, mit, program ] [ Propose Tags ]

A configurable Monomer widget that shows a scrollable grid of data.


[Skip to Readme]

Modules

[Index] [Quick Jump]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.1.0.0, 0.2.0.0, 0.2.0.1
Change log ChangeLog.md
Dependencies base (>=4.7 && <5), containers (<0.7), data-default-class (<0.2), ilist (<0.5), lens (<5.2), monomer (>=1.5.0.0 && <1.6), monomer-hagrid, random (<1.3), text (<1.3), time (<1.12) [details]
License MIT
Author
Maintainer garethdanielsmith@gmail.com
Category GUI
Home page https://github.com/Dretch/monomer-hagrid#readme
Bug tracker https://github.com/Dretch/monomer-hagrid/issues
Source repo head: git clone https://github.com/Dretch/monomer-hagrid
Uploaded by garethdanielsmith at 2022-12-28T21:12:00Z
Distributions NixOS:0.2.0.1
Executables example-resizing-cells, example-big-grid, example-basic
Downloads 53 total (13 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2022-12-28 [all 1 reports]

Readme for monomer-hagrid-0.2.0.1

[back to package description]

Monomer-Hagrid

A datagrid widget for the Monomer library.

Example hagrid widget screenshot

Current Status

  • Somewhat buggy and incomplete. Don't build your business on this.

Current Features

  • Vertical and horizontal scrolling.
  • Resizable columns.
  • Column sorting, with a customizable sort key.
  • Configurable column alignment (left or right).
  • Custom widgets for each cell, to override the standard label.
  • Custom width/height padding for each cell, configured per column.
  • Scrolling to a particular row when sent a message.
  • Custom footer widgets on the bottom of each column.
  • Efficient implementation that only inflates visible widgets, scaling to at least 10000 rows.

Definite Future Goals

  • Better documention.
  • Better tests.
  • Prettier appearance.

Possible Future Goals

  • Explore providing an API where current sort/column widths/etc are stored in the parent model and updated by hagrid via a lens. This may remove some complexity around merging and the specification of initial sorts/column widths.

API Documentation

See the generated docs on Hackage.

To build and run examples

stack run example-basic             # Demo of the basic functionality.
stack run example-big-grid          # Demo of a grid with over 10000 rows.
stack run example-resizing-cells    # Demo where the cells are constantly changing size.

Contribution Guide

  • This is "free as in mattress" software!
  • You are welcome to open an issue with bug reports or feature requests, but you may not get a response.
  • Unsolicited pull requests will likely be ignored.

To format the source code

# This needs at least ormolu 0.5.0.0 to avoid breaking dot-record syntax
ormolu --mode inplace $(find . -name '*.hs')