GUI: A UI frame work for the V language based on the rendering algorithm of Clay

16 hours ago 2

A UI frame work for the V language based on the rendering algorithm of Clay.

It’s early days so little is working. Try it and send feedback.

Pure V
Immediate mode rendering
Thread safe view updates
Declarative, flex-box style layout syntax

import gui // GUI uses a view generator (a function that returns a View) to // render the contents of the Window. As the state of the app // changes, either through user actions or business logic, GUI // calls the view generator to build a new view. The new view is // used to render the contents of the window. // // There are several advantages to this approach. // - The view is simply a function of the model (state). // - No data binding or other observation mechanisms required. // - No worries about synchronizing with the UI thread. // - No need to remember to undo previous UI states. struct App { pub mut: clicks int } fn main() { mut window := gui.window( state: &App{} width: 300 height: 300 on_init: fn (mut w gui.Window) { // Call update_view() any where in your // business logic to change views. w.update_view(main_view) } ) window.run() } // The view generator set in update_view() is called on // every user event (mouse move, click, resize, etc.). fn main_view(window &gui.Window) gui.View { w, h := window.window_size() app := window.state[App]() return gui.column( width: w height: h h_align: .center v_align: .middle sizing: gui.fixed_fixed content: [ gui.text(text: 'Welcome to GUI'), gui.button( content: [gui.text(text: '${app.clicks} Clicks')] on_click: fn (_ &gui.ButtonCfg, mut e gui.Event, mut w gui.Window) { mut app := w.state[App]() app.clicks += 1 } ), ] ) }

GUI is a flex-box style UI framework written in V, with declarative syntax and performance. It aspires to be a useful framework with a short a learning curve.

Let V do it for you!

v install https://github.com/mike-ward/gui

The README.md in the examples folder describes how to build GUI programs. Don’t fret, it’s a one-liner.

If you’re new to GUI, start with the get-started.v example. It explains the basics of view generators, state models and event handling. Some of the other examples like two-panel.v and test-layout.v were used to test the layout engine during development and are not meant as examples of how to write an app (they’re fun to run however).

The Makefile at the root of the project builds documentation from the source code. Type make doc to produce the documention and make read to open the documention in the browser. make doc incorporates the hand written documentation below making it a handy one-stop page.

There is also some hand written documentation in the /doc folder labled 01 Introduction.md, 02 Getting Started.md, etc. The doc_viewer.v example can be used to read them or use a browser. It’s a work in progress.

I plan to create a capable, robust and fairly complete UI framework. As to timelines, who knows. I’m making this up as I go along. Currently, this is the only project I’m working on, so expect frequent updates.

Current state of the project can be found at: Progress Reports and Feedback

Read Entire Article

GUI: A UI frame work for the V language based on the rendering algorithm of Clay

Related

Mysterious link between Earth's magnetism and oxygen baffles...

Politics and Polarization on Bluesky

Laser-Based Compute Promises to Light the Way to Faster Phys...