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

[ gui, library, mit ] [ Propose Tags ]

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


[Skip to Readme]

Modules

[Index] [Quick Jump]

Flags

Manual Flags

NameDescriptionDefault
examples

Whether to build the example executables. Off by default because they are not usually wanted.

Disabled

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

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, 0.2.1.0, 0.2.1.1, 0.3.0.0, 0.3.0.1, 0.3.1.0, 0.3.1.1, 0.3.1.2
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.1.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 2023-04-16T13:51:32Z
Distributions
Executables example-resizing-cells, example-big-grid, example-basic
Downloads 365 total (29 in the last 30 days)
Rating 2.0 (votes: 1) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2023-04-16 [all 1 reports]

Readme for monomer-hagrid-0.3.0.0

[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 build --flag monomer-hagrid:examples
`stack path --local-install-root`/bin/example-basic          # Demo of the basic functionality.
`stack path --local-install-root`/bin/example-big-grid       # Demo of a grid with over 10000 rows.
`stack path --local-install-root`/bin/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')