https://github.com/pisaiah/ui
My UI Widget library for V
https://github.com/pisaiah/ui
cross-platform-gui gui linux mac ui ui-library v vlang vlang-library wasm widget widget-toolkit windows
Last synced: about 2 months ago
JSON representation
My UI Widget library for V
- Host: GitHub
- URL: https://github.com/pisaiah/ui
- Owner: pisaiah
- License: mit
- Created: 2021-12-09T15:10:01.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-10-30T05:36:11.000Z (8 months ago)
- Last Synced: 2024-10-30T08:37:46.855Z (8 months ago)
- Topics: cross-platform-gui, gui, linux, mac, ui, ui-library, v, vlang, vlang-library, wasm, widget, widget-toolkit, windows
- Language: V
- Homepage: https://discord.gg/NruVtYBf5g
- Size: 5.61 MB
- Stars: 97
- Watchers: 7
- Forks: 7
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-electron-alternatives - ui - platform GUI library for V. Inspired by the syntax of Java's Swing. (👓 Alternatives to the [Electron.js](https://electronjs.org) ⚛ / V)
README
Cross-platform GUI library for V. Inspired by the syntax of Java's Swing/FX & Fluent/WinUI3 Style.
Example: *([examples/demo/](examples/demo/demo.v))*
## Example
```v
fn main() {
mut window := ui.Window.new(
title: 'My App'
width: 640
height: 480
)
// Create Button
mut btn := ui.Button.new(text: 'My Button')
btn.subscribe_event('mouse_up', on_click_event)
// Add Button to Window & Run
window.add_child(btn)
window.gg.run()
}
fn on_click_event(e &ui.MouseEvent) {
println('Button clicked!')
}
```
## Install
Install via VPM:
```
v install https://github.com/pisaiah/ui
```
then
```v
import iui as ui
```
## Components, Containers, & Layouts
| Components | Containers | Panel Layouts |
| ------------- | ----------- | ------------- |
| Button | Window | Flow Layout |
| Checkbox | Panel | Border Layout |
| Hyperlink | Tabbox | Box Layout |
| Image | Modal | Grid Layout |
| InternalFrame | Page | Card Layout |
| Label | ButtonGroup | |
| Menubar | ScrollView | |
| MenuItem | Splitview | |
| NavPaneItem | TitleGroup | |
| ProgressBar | Popup | |
| Selectbox | DesktopPane | |
| Slider | NavPane | |
| Switch | | |
| Textbox | | |
| TextField | | |
| Treeview | | |
- Components are the elements of the UI (buttons, inputs, etc).
- Containers are components that are designed to contain other components (known as children).
- Layouts define how the Panel container positions it's children.
More details about Layout: [A Visual Guide to Layout Managers - docs.oracle.com](https://docs.oracle.com/javase/tutorial/uiswing/layout/visual.html)
## Themes
Light:
- Default, Minty, Ocean, Seven.
Dark:
- Dark (with Blue/Red/Green/or RGB Accent), Seven Dark.
## Included Examples
BorderLayout DemoInternal FramesNavigation Pane
Border Layout Demo
Internal Frames
Navigation Pane
NotepadCalculatorClockVideo Player
See: Notepad
Calculator
Clock
Video Player (requires libmpv)
Mines(Tic Tac Toe)^2Snake
Code: 1-Minesweeper
Demo: Play online (via WASM)
2-Tic-Tac-Toe-Squared
Play online (WASM)
3-Snake
## Used in
- [Vide](https://github.com/pisaiah/vide)
- [Verminal](https://github.com/pisaiah/verminal)
- [vPaint](https://github.com/pisaiah/vpaint) - Demo: [https://vpaint.app](https://vpaint.app)
## License
This project is licensed under MIT OR Boost.
Veasel *(v mascot)* on a Swing