glimmer-dsl-libui 0.4.10 → 0.4.11
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +12 -0
- data/README.md +671 -185
- data/VERSION +1 -1
- data/examples/basic_table_button.rb +54 -30
- data/examples/basic_table_button2.rb +34 -0
- data/examples/basic_table_color.rb +1 -1
- data/examples/editable_table.rb +1 -1
- data/examples/form_table.rb +21 -17
- data/examples/form_table2.rb +104 -85
- data/examples/form_table3.rb +113 -0
- data/examples/form_table4.rb +110 -0
- data/examples/form_table5.rb +94 -0
- data/examples/meta_example.rb +6 -4
- data/glimmer-dsl-libui.gemspec +0 -0
- data/lib/glimmer/dsl/libui/control_expression.rb +2 -1
- data/lib/glimmer/dsl/libui/shape_expression.rb +2 -2
- data/lib/glimmer/dsl/libui/string_expression.rb +2 -1
- data/lib/glimmer/libui/attributed_string.rb +3 -2
- data/lib/glimmer/libui/control_proxy/table_proxy.rb +88 -24
- data/lib/glimmer/libui/control_proxy.rb +4 -2
- data/lib/glimmer/libui/data_bindable.rb +8 -3
- data/lib/glimmer/libui/shape.rb +3 -2
- data/lib/glimmer-dsl-libui.rb +1 -0
- metadata +5 -1
data/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for LibUI 0.4.
|
|
1
|
+
# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for LibUI 0.4.11
|
|
2
2
|
## Prerequisite-Free Ruby Desktop Development GUI Library
|
|
3
3
|
[](http://badge.fury.io/rb/glimmer-dsl-libui)
|
|
4
4
|
[](https://gitter.im/AndyObtiva/glimmer?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
|
@@ -77,6 +77,127 @@ Mac | Windows | Linux
|
|
|
77
77
|
----|---------|------
|
|
78
78
|
 |  | 
|
|
79
79
|
|
|
80
|
+
Form Table
|
|
81
|
+
|
|
82
|
+
```ruby
|
|
83
|
+
require 'glimmer-dsl-libui'
|
|
84
|
+
|
|
85
|
+
class FormTable
|
|
86
|
+
Contact = Struct.new(:name, :email, :phone, :city, :state)
|
|
87
|
+
|
|
88
|
+
include Glimmer
|
|
89
|
+
|
|
90
|
+
attr_accessor :contacts, :name, :email, :phone, :city, :state, :filter_value
|
|
91
|
+
|
|
92
|
+
def initialize
|
|
93
|
+
@contacts = [
|
|
94
|
+
Contact.new('Lisa Sky', 'lisa@sky.com', '720-523-4329', 'Denver', 'CO'),
|
|
95
|
+
Contact.new('Jordan Biggins', 'jordan@biggins.com', '617-528-5399', 'Boston', 'MA'),
|
|
96
|
+
Contact.new('Mary Glass', 'mary@glass.com', '847-589-8788', 'Elk Grove Village', 'IL'),
|
|
97
|
+
Contact.new('Darren McGrath', 'darren@mcgrath.com', '206-539-9283', 'Seattle', 'WA'),
|
|
98
|
+
Contact.new('Melody Hanheimer', 'melody@hanheimer.com', '213-493-8274', 'Los Angeles', 'CA'),
|
|
99
|
+
]
|
|
100
|
+
end
|
|
101
|
+
|
|
102
|
+
def launch
|
|
103
|
+
window('Contacts', 600, 600) { |w|
|
|
104
|
+
margined true
|
|
105
|
+
|
|
106
|
+
vertical_box {
|
|
107
|
+
form {
|
|
108
|
+
stretchy false
|
|
109
|
+
|
|
110
|
+
entry {
|
|
111
|
+
label 'Name'
|
|
112
|
+
text <=> [self, :name] # bidirectional data-binding between entry text and self.name
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
entry {
|
|
116
|
+
label 'Email'
|
|
117
|
+
text <=> [self, :email]
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
entry {
|
|
121
|
+
label 'Phone'
|
|
122
|
+
text <=> [self, :phone]
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
entry {
|
|
126
|
+
label 'City'
|
|
127
|
+
text <=> [self, :city]
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
entry {
|
|
131
|
+
label 'State'
|
|
132
|
+
text <=> [self, :state]
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
button('Save Contact') {
|
|
137
|
+
stretchy false
|
|
138
|
+
|
|
139
|
+
on_clicked do
|
|
140
|
+
new_row = [name, email, phone, city, state]
|
|
141
|
+
if new_row.include?('')
|
|
142
|
+
msg_box_error(w, 'Validation Error!', 'All fields are required! Please make sure to enter a value for all fields.')
|
|
143
|
+
else
|
|
144
|
+
@contacts << Contact.new(*new_row) # automatically inserts a row into the table due to explicit data-binding
|
|
145
|
+
@unfiltered_contacts = @contacts.dup
|
|
146
|
+
self.name = '' # automatically clears name entry through explicit data-binding
|
|
147
|
+
self.email = ''
|
|
148
|
+
self.phone = ''
|
|
149
|
+
self.city = ''
|
|
150
|
+
self.state = ''
|
|
151
|
+
end
|
|
152
|
+
end
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
search_entry {
|
|
156
|
+
stretchy false
|
|
157
|
+
# bidirectional data-binding of text to self.filter_value with after_write option
|
|
158
|
+
text <=> [self, :filter_value,
|
|
159
|
+
after_write: ->(filter_value) { # execute after write to self.filter_value
|
|
160
|
+
@unfiltered_contacts ||= @contacts.dup
|
|
161
|
+
# Unfilter first to remove any previous filters
|
|
162
|
+
self.contacts = @unfiltered_contacts.dup # affects table indirectly through explicit data-binding
|
|
163
|
+
# Now, apply filter if entered
|
|
164
|
+
unless filter_value.empty?
|
|
165
|
+
self.contacts = @contacts.filter do |contact| # affects table indirectly through explicit data-binding
|
|
166
|
+
contact.members.any? do |attribute|
|
|
167
|
+
contact[attribute].to_s.downcase.include?(filter_value.downcase)
|
|
168
|
+
end
|
|
169
|
+
end
|
|
170
|
+
end
|
|
171
|
+
}
|
|
172
|
+
]
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
table {
|
|
176
|
+
text_column('Name')
|
|
177
|
+
text_column('Email')
|
|
178
|
+
text_column('Phone')
|
|
179
|
+
text_column('City')
|
|
180
|
+
text_column('State')
|
|
181
|
+
|
|
182
|
+
editable true
|
|
183
|
+
cell_rows <=> [self, :contacts] # explicit data-binding to Model Array
|
|
184
|
+
|
|
185
|
+
on_changed do |row, type, row_data|
|
|
186
|
+
puts "Row #{row} #{type}: #{row_data}"
|
|
187
|
+
end
|
|
188
|
+
}
|
|
189
|
+
}
|
|
190
|
+
}.show
|
|
191
|
+
end
|
|
192
|
+
end
|
|
193
|
+
|
|
194
|
+
FormTable.new.launch
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
Mac | Windows | Linux
|
|
198
|
+
----|---------|------
|
|
199
|
+
 |  | 
|
|
200
|
+
|
|
80
201
|
Area Gallery
|
|
81
202
|
|
|
82
203
|
```ruby
|
|
@@ -374,10 +495,20 @@ gem install glimmer-dsl-libui
|
|
|
374
495
|
Or install via Bundler `Gemfile`:
|
|
375
496
|
|
|
376
497
|
```ruby
|
|
377
|
-
gem 'glimmer-dsl-libui', '~> 0.4.
|
|
498
|
+
gem 'glimmer-dsl-libui', '~> 0.4.11'
|
|
499
|
+
```
|
|
500
|
+
|
|
501
|
+
Test that installation worked by running the [Meta-Example](#examples):
|
|
502
|
+
|
|
503
|
+
```
|
|
504
|
+
ruby -r glimmer-dsl-libui -e "require 'examples/meta_example'"
|
|
378
505
|
```
|
|
379
506
|
|
|
380
|
-
|
|
507
|
+
Mac | Windows | Linux
|
|
508
|
+
----|---------|------
|
|
509
|
+
 |  | 
|
|
510
|
+
|
|
511
|
+
Now to use [glimmer-dsl-libui](https://rubygems.org/gems/glimmer-dsl-libui), add `require 'glimmer-dsl-libui'` at the top, and then `include Glimmer` into the top-level main object for testing or into an actual class for serious usage.
|
|
381
512
|
|
|
382
513
|
Example (you may copy/paste in [`girb`](#girb-glimmer-irb)):
|
|
383
514
|
|
|
@@ -452,7 +583,7 @@ Keyword(Args) | Properties | Listeners
|
|
|
452
583
|
`about_menu_item` | None | `on_clicked`
|
|
453
584
|
`area` | `auto_draw_enabled` | `on_draw(area_draw_params)`, `on_mouse_event(area_mouse_event)`, `on_mouse_down(area_mouse_event)`, `on_mouse_up(area_mouse_event)`, `on_mouse_drag_started(area_mouse_event)`, `on_mouse_dragged(area_mouse_event)`, `on_mouse_dropped(area_mouse_event)`, `on_mouse_entered`, `on_mouse_exited`, `on_key_event(area_key_event)`, `on_key_down(area_key_event)`, `on_key_up(area_key_event)`
|
|
454
585
|
`arc(x_center as Numeric, y_center as Numeric, radius as Numeric, start_angle as Numeric, sweep as Numeric, is_negative as Boolean)` | `x_center` (`Numeric`), `y_center` (`Numeric`), `radius` (`Numeric`), `start_angle` (`Numeric`), `sweep` (`Numeric`), `is_negative` (Boolean) | None
|
|
455
|
-
`background_color_column
|
|
586
|
+
`background_color_column` | None | None
|
|
456
587
|
`bezier(c1_x as Numeric, c1_y as Numeric, c2_x as Numeric, c2_y as Numeric, end_x as Numeric, end_y as Numeric)` | `c1_x` (`Numeric`), `c1_y` (`Numeric`), `c2_x` (`Numeric`), `c2_y` (`Numeric`), `end_x` (`Numeric`), `end_y` (`Numeric`) | None
|
|
457
588
|
`button(text as String)` | `text` (`String`) | `on_clicked`
|
|
458
589
|
`button_column(name as String)` | `enabled` (Boolean) | None
|
|
@@ -616,159 +747,147 @@ Note that the `cell_rows` property declaration results in "implicit data-binding
|
|
|
616
747
|
- Inserting cell rows: Calling `Array#<<`, `Array#push`, `Array#prepend`, or any insertion/addition `Array` method automatically inserts rows in actual `table` control
|
|
617
748
|
- Changing cell rows: Calling `Array#[]=`, `Array#map!`, or any update `Array` method automatically updates rows in actual `table` control
|
|
618
749
|
|
|
619
|
-
|
|
620
|
-
|
|
621
|
-
```ruby
|
|
622
|
-
require 'glimmer-dsl-libui'
|
|
623
|
-
|
|
624
|
-
class FormTable
|
|
625
|
-
include Glimmer
|
|
626
|
-
|
|
627
|
-
attr_accessor :name, :email, :phone, :city, :state, :filter_value
|
|
628
|
-
|
|
629
|
-
def initialize
|
|
630
|
-
@data = [
|
|
631
|
-
['Lisa Sky', 'lisa@sky.com', '720-523-4329', 'Denver', 'CO'],
|
|
632
|
-
['Jordan Biggins', 'jordan@biggins.com', '617-528-5399', 'Boston', 'MA'],
|
|
633
|
-
['Mary Glass', 'mary@glass.com', '847-589-8788', 'Elk Grove Village', 'IL'],
|
|
634
|
-
['Darren McGrath', 'darren@mcgrath.com', '206-539-9283', 'Seattle', 'WA'],
|
|
635
|
-
['Melody Hanheimer', 'melody@hanheimer.com', '213-493-8274', 'Los Angeles', 'CA'],
|
|
636
|
-
]
|
|
637
|
-
end
|
|
638
|
-
|
|
639
|
-
def launch
|
|
640
|
-
window('Contacts', 600, 600) { |w|
|
|
641
|
-
margined true
|
|
642
|
-
|
|
643
|
-
vertical_box {
|
|
644
|
-
form {
|
|
645
|
-
stretchy false
|
|
646
|
-
|
|
647
|
-
entry {
|
|
648
|
-
label 'Name'
|
|
649
|
-
text <=> [self, :name]
|
|
650
|
-
}
|
|
651
|
-
|
|
652
|
-
entry {
|
|
653
|
-
label 'Email'
|
|
654
|
-
text <=> [self, :email]
|
|
655
|
-
}
|
|
656
|
-
|
|
657
|
-
entry {
|
|
658
|
-
label 'Phone'
|
|
659
|
-
text <=> [self, :phone]
|
|
660
|
-
}
|
|
661
|
-
|
|
662
|
-
entry {
|
|
663
|
-
label 'City'
|
|
664
|
-
text <=> [self, :city]
|
|
665
|
-
}
|
|
666
|
-
|
|
667
|
-
entry {
|
|
668
|
-
label 'State'
|
|
669
|
-
text <=> [self, :state]
|
|
670
|
-
}
|
|
671
|
-
}
|
|
672
|
-
|
|
673
|
-
button('Save Contact') {
|
|
674
|
-
stretchy false
|
|
675
|
-
|
|
676
|
-
on_clicked do
|
|
677
|
-
new_row = [name, email, phone, city, state]
|
|
678
|
-
if new_row.include?('')
|
|
679
|
-
msg_box_error(w, 'Validation Error!', 'All fields are required! Please make sure to enter a value for all fields.')
|
|
680
|
-
else
|
|
681
|
-
@data << new_row # automatically inserts a row into the table due to implicit data-binding
|
|
682
|
-
@unfiltered_data = @data.dup
|
|
683
|
-
self.name = '' # automatically clears name entry through explicit data-binding
|
|
684
|
-
self.email = ''
|
|
685
|
-
self.phone = ''
|
|
686
|
-
self.city = ''
|
|
687
|
-
self.state = ''
|
|
688
|
-
end
|
|
689
|
-
end
|
|
690
|
-
}
|
|
691
|
-
|
|
692
|
-
search_entry {
|
|
693
|
-
stretchy false
|
|
694
|
-
text <=> [self, :filter_value, # bidirectional data-binding of text to self.filter_value with after_write option
|
|
695
|
-
after_write: ->(filter_value) { # execute after write to self.filter_value
|
|
696
|
-
@unfiltered_data ||= @data.dup
|
|
697
|
-
# Unfilter first to remove any previous filters
|
|
698
|
-
@data.replace(@unfiltered_data) # affects table indirectly through implicit data-binding
|
|
699
|
-
# Now, apply filter if entered
|
|
700
|
-
unless filter_value.empty?
|
|
701
|
-
@data.filter! do |row_data| # affects table indirectly through implicit data-binding
|
|
702
|
-
row_data.any? do |cell|
|
|
703
|
-
cell.to_s.downcase.include?(filter_value.downcase)
|
|
704
|
-
end
|
|
705
|
-
end
|
|
706
|
-
end
|
|
707
|
-
}
|
|
708
|
-
]
|
|
709
|
-
}
|
|
710
|
-
|
|
711
|
-
table {
|
|
712
|
-
text_column('Name')
|
|
713
|
-
text_column('Email')
|
|
714
|
-
text_column('Phone')
|
|
715
|
-
text_column('City')
|
|
716
|
-
text_column('State')
|
|
717
|
-
|
|
718
|
-
cell_rows @data # implicit data-binding
|
|
719
|
-
|
|
720
|
-
on_changed do |row, type, row_data|
|
|
721
|
-
puts "Row #{row} #{type}: #{row_data}"
|
|
722
|
-
end
|
|
723
|
-
}
|
|
724
|
-
}
|
|
725
|
-
}.show
|
|
726
|
-
end
|
|
727
|
-
end
|
|
728
|
-
|
|
729
|
-
FormTable.new.launch
|
|
730
|
-
```
|
|
731
|
-
|
|
732
|
-
|
|
733
|
-
|
|
734
|
-
Learn more by checking out [examples](#examples).
|
|
735
|
-
|
|
736
|
-
### Area API
|
|
737
|
-
|
|
738
|
-
The `area` control is a canvas-like control for drawing paths that can be used in one of two ways:
|
|
739
|
-
- Declaratively via stable paths: useful for stable paths that will not change often later on. Simply nest `path` and figures like `rectangle` and all drawing logic is generated automatically. Path proxy objects are preserved across redraws assuming there would be relatively few stable paths (mostly for decorative reasons).
|
|
740
|
-
- Semi-declaratively via on_draw listener dynamic paths: useful for more dynamic paths that will definitely change very often. Open an `on_draw` listener block that receives an [`area_draw_params`](#area-draw-params) argument and nest `path` and figures like `rectangle` and all drawing logic is generated automatically. Path proxy objects are destroyed (thrown-away) at the end of drawing, thus having less memory overhead for drawing thousands of dynamic paths.
|
|
741
|
-
|
|
742
|
-
Note that when nesting an `area` directly underneath `window` (without a layout control like `vertical_box`), it is automatically reparented with `vertical_box` in between the `window` and `area` since it would not show up on Linux otherwise.
|
|
750
|
+
([explicit data-binding](#data-binding) supports everything available with implicit data-binding too)
|
|
743
751
|
|
|
744
|
-
|
|
752
|
+
Example (you may copy/paste in [`girb`](#girb-glimmer-irb)):
|
|
745
753
|
|
|
746
754
|
```ruby
|
|
747
755
|
require 'glimmer-dsl-libui'
|
|
748
756
|
|
|
749
757
|
include Glimmer
|
|
750
758
|
|
|
751
|
-
|
|
759
|
+
data = [
|
|
760
|
+
['Lisa Sky', 'lisa@sky.com', '720-523-4329', 'Denver', 'CO'],
|
|
761
|
+
['Jordan Biggins', 'jordan@biggins.com', '617-528-5399', 'Boston', 'MA'],
|
|
762
|
+
['Mary Glass', 'mary@glass.com', '847-589-8788', 'Elk Grove Village', 'IL'],
|
|
763
|
+
['Darren McGrath', 'darren@mcgrath.com', '206-539-9283', 'Seattle', 'WA'],
|
|
764
|
+
['Melody Hanheimer', 'melody@hanheimer.com', '213-493-8274', 'Los Angeles', 'CA'],
|
|
765
|
+
]
|
|
766
|
+
|
|
767
|
+
window('Contacts', 600, 600) { |w|
|
|
752
768
|
margined true
|
|
753
769
|
|
|
754
770
|
vertical_box {
|
|
755
|
-
|
|
756
|
-
|
|
757
|
-
|
|
758
|
-
|
|
759
|
-
|
|
771
|
+
form {
|
|
772
|
+
stretchy false
|
|
773
|
+
|
|
774
|
+
@name_entry = entry {
|
|
775
|
+
label 'Name'
|
|
760
776
|
}
|
|
761
|
-
|
|
762
|
-
|
|
763
|
-
|
|
764
|
-
|
|
765
|
-
|
|
766
|
-
|
|
767
|
-
|
|
768
|
-
|
|
769
|
-
|
|
770
|
-
|
|
771
|
-
|
|
777
|
+
|
|
778
|
+
@email_entry = entry {
|
|
779
|
+
label 'Email'
|
|
780
|
+
}
|
|
781
|
+
|
|
782
|
+
@phone_entry = entry {
|
|
783
|
+
label 'Phone'
|
|
784
|
+
}
|
|
785
|
+
|
|
786
|
+
@city_entry = entry {
|
|
787
|
+
label 'City'
|
|
788
|
+
}
|
|
789
|
+
|
|
790
|
+
@state_entry = entry {
|
|
791
|
+
label 'State'
|
|
792
|
+
}
|
|
793
|
+
}
|
|
794
|
+
|
|
795
|
+
button('Save Contact') {
|
|
796
|
+
stretchy false
|
|
797
|
+
|
|
798
|
+
on_clicked do
|
|
799
|
+
new_row = [@name_entry.text, @email_entry.text, @phone_entry.text, @city_entry.text, @state_entry.text]
|
|
800
|
+
if new_row.include?('')
|
|
801
|
+
msg_box_error(w, 'Validation Error!', 'All fields are required! Please make sure to enter a value for all fields.')
|
|
802
|
+
else
|
|
803
|
+
data << new_row # automatically inserts a row into the table due to implicit data-binding
|
|
804
|
+
@unfiltered_data = data.dup
|
|
805
|
+
@name_entry.text = ''
|
|
806
|
+
@email_entry.text = ''
|
|
807
|
+
@phone_entry.text = ''
|
|
808
|
+
@city_entry.text = ''
|
|
809
|
+
@state_entry.text = ''
|
|
810
|
+
end
|
|
811
|
+
end
|
|
812
|
+
}
|
|
813
|
+
|
|
814
|
+
search_entry { |se|
|
|
815
|
+
stretchy false
|
|
816
|
+
|
|
817
|
+
on_changed do
|
|
818
|
+
filter_value = se.text
|
|
819
|
+
@unfiltered_data ||= data.dup
|
|
820
|
+
# Unfilter first to remove any previous filters
|
|
821
|
+
data.replace(@unfiltered_data) # affects table indirectly through implicit data-binding
|
|
822
|
+
# Now, apply filter if entered
|
|
823
|
+
unless filter_value.empty?
|
|
824
|
+
data.filter! do |row_data| # affects table indirectly through implicit data-binding
|
|
825
|
+
row_data.any? do |cell|
|
|
826
|
+
cell.to_s.downcase.include?(filter_value.downcase)
|
|
827
|
+
end
|
|
828
|
+
end
|
|
829
|
+
end
|
|
830
|
+
end
|
|
831
|
+
}
|
|
832
|
+
|
|
833
|
+
table {
|
|
834
|
+
text_column('Name')
|
|
835
|
+
text_column('Email')
|
|
836
|
+
text_column('Phone')
|
|
837
|
+
text_column('City')
|
|
838
|
+
text_column('State')
|
|
839
|
+
|
|
840
|
+
editable true
|
|
841
|
+
cell_rows data # implicit data-binding to raw data Array of Arrays
|
|
842
|
+
|
|
843
|
+
on_changed do |row, type, row_data|
|
|
844
|
+
puts "Row #{row} #{type}: #{row_data}"
|
|
845
|
+
end
|
|
846
|
+
}
|
|
847
|
+
}
|
|
848
|
+
}.show
|
|
849
|
+
```
|
|
850
|
+
|
|
851
|
+
|
|
852
|
+
|
|
853
|
+
Learn more by checking out [examples](#examples).
|
|
854
|
+
|
|
855
|
+
### Area API
|
|
856
|
+
|
|
857
|
+
The `area` control is a canvas-like control for drawing paths that can be used in one of two ways:
|
|
858
|
+
- Declaratively via stable paths: useful for stable paths that will not change often later on. Simply nest `path` and figures like `rectangle` and all drawing logic is generated automatically. Path proxy objects are preserved across redraws assuming there would be relatively few stable paths (mostly for decorative reasons).
|
|
859
|
+
- Semi-declaratively via on_draw listener dynamic paths: useful for more dynamic paths that will definitely change very often. Open an `on_draw` listener block that receives an [`area_draw_params`](#area-draw-params) argument and nest `path` and figures like `rectangle` and all drawing logic is generated automatically. Path proxy objects are destroyed (thrown-away) at the end of drawing, thus having less memory overhead for drawing thousands of dynamic paths.
|
|
860
|
+
|
|
861
|
+
Note that when nesting an `area` directly underneath `window` (without a layout control like `vertical_box`), it is automatically reparented with `vertical_box` in between the `window` and `area` since it would not show up on Linux otherwise.
|
|
862
|
+
|
|
863
|
+
Here is an example of a declarative `area` with a stable path (you may copy/paste in [`girb`](#girb-glimmer-irb)):
|
|
864
|
+
|
|
865
|
+
```ruby
|
|
866
|
+
require 'glimmer-dsl-libui'
|
|
867
|
+
|
|
868
|
+
include Glimmer
|
|
869
|
+
|
|
870
|
+
window('Basic Area', 400, 400) {
|
|
871
|
+
margined true
|
|
872
|
+
|
|
873
|
+
vertical_box {
|
|
874
|
+
area {
|
|
875
|
+
path { # a stable path is added declaratively
|
|
876
|
+
rectangle(0, 0, 400, 400)
|
|
877
|
+
|
|
878
|
+
fill r: 102, g: 102, b: 204, a: 1.0
|
|
879
|
+
}
|
|
880
|
+
}
|
|
881
|
+
}
|
|
882
|
+
}.show
|
|
883
|
+
```
|
|
884
|
+
|
|
885
|
+
Mac | Windows | Linux
|
|
886
|
+
----|---------|------
|
|
887
|
+
 |  | 
|
|
888
|
+
|
|
889
|
+
Here is the same example using a semi-declarative `area` with `on_draw` listener that receives a [`area_draw_params`](#area-draw-params) argument and a dynamic path (you may copy/paste in [`girb`](#girb-glimmer-irb)):
|
|
890
|
+
|
|
772
891
|
```ruby
|
|
773
892
|
require 'glimmer-dsl-libui'
|
|
774
893
|
|
|
@@ -799,9 +918,9 @@ Check [examples/dynamic_area.rb](#dynamic-area) for a more detailed semi-declara
|
|
|
799
918
|
- `scroll_to(x as Numeric, y as Numeric, width as Numeric = main_window.width, height as Numeric = main_window.height)`: scrolls to `x`/`y` location with `width` and `height` viewport size.
|
|
800
919
|
- `set_size(width as Numeric, height as Numeric)`: set size of scrolling area, which must must exceed that of visible viewport in order for scrolling to be enabled.
|
|
801
920
|
|
|
802
|
-
Mac |Linux
|
|
803
|
-
|
|
804
|
-
  |  
|
|
921
|
+
Mac | Windows | Linux
|
|
922
|
+
----|---------|------
|
|
923
|
+
  |   |  
|
|
805
924
|
|
|
806
925
|
Check [examples/basic_scrolling_area.rb](#basic-scrolling-area) for a more detailed example.
|
|
807
926
|
|
|
@@ -1217,6 +1336,7 @@ Note that `area`, `path`, and nested shapes are all truly declarative, meaning t
|
|
|
1217
1336
|
- When destroying a control nested under a `horizontal_box` or `vertical_box`, it is automatically deleted from the box's children
|
|
1218
1337
|
- When destroying a control nested under a `form`, it is automatically deleted from the form's children
|
|
1219
1338
|
- When destroying a control nested under a `window` or `group`, it is automatically unset as their child to allow successful destruction
|
|
1339
|
+
- When destroying a control that has a data-binding to a model attribute, the data-binding observer registration is automatically deregistered
|
|
1220
1340
|
- For `date_time_picker`, `date_picker`, and `time_picker`, make sure `time` hash values for `mon`, `wday`, and `yday` are 1-based instead of [libui](https://github.com/andlabs/libui) original 0-based values, and return `dst` as Boolean instead of `isdst` as `1`/`0`
|
|
1221
1341
|
- Smart defaults for `grid` child properties are `left` (`0`), `top` (`0`), `xspan` (`1`), `yspan` (`1`), `hexpand` (`false`), `halign` (`:fill`), `vexpand` (`false`), and `valign` (`:fill`)
|
|
1222
1342
|
- The `table` control automatically constructs required `TableModelHandler`, `TableModel`, and `TableParams`, calculating all their arguments from `cell_rows` and `editable` properties (e.g. `NumRows`) as well as nested columns (e.g. `text_column`)
|
|
@@ -1491,6 +1611,7 @@ Learn more from data-binding usage in [Login](#login) (4 data-binding versions),
|
|
|
1491
1611
|
- `table` `progress_bar` column on Windows cannot be updated with a positive value if it started initially with `-1` (it ignores update to avoid crashing due to an issue in [libui](https://github.com/andlabs/libui) on Windows.
|
|
1492
1612
|
- It seems that [libui](https://github.com/andlabs/libui) does not support nesting multiple `area` controls under a `grid` as only the first one shows up in that scenario. To workaround that limitation, use a `vertical_box` with nested `horizontal_box`s instead to include multiple `area`s in a GUI.
|
|
1493
1613
|
- As per the code of [examples/basic_transform.rb](#basic-transform), Windows requires different ordering of transforms than Mac and Linux.
|
|
1614
|
+
- `scrolling_area#scroll_to` does not seem to work on Windows and Linux, but works fine on Mac
|
|
1494
1615
|
|
|
1495
1616
|
### Original API
|
|
1496
1617
|
|
|
@@ -3012,22 +3133,28 @@ Mac | Windows | Linux
|
|
|
3012
3133
|
New [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version (with explicit [data-binding](#data-binding)):
|
|
3013
3134
|
|
|
3014
3135
|
```ruby
|
|
3015
|
-
# frozen_string_literal: true
|
|
3016
|
-
|
|
3017
3136
|
require 'glimmer-dsl-libui'
|
|
3018
3137
|
|
|
3019
3138
|
class BasicTableButton
|
|
3139
|
+
BasicAnimal = Struct.new(:name, :sound)
|
|
3140
|
+
|
|
3141
|
+
class Animal < BasicAnimal
|
|
3142
|
+
def action
|
|
3143
|
+
'delete'
|
|
3144
|
+
end
|
|
3145
|
+
end
|
|
3146
|
+
|
|
3020
3147
|
include Glimmer
|
|
3021
3148
|
|
|
3022
|
-
attr_accessor :
|
|
3149
|
+
attr_accessor :animals
|
|
3023
3150
|
|
|
3024
3151
|
def initialize
|
|
3025
|
-
@
|
|
3026
|
-
|
|
3027
|
-
|
|
3028
|
-
|
|
3029
|
-
|
|
3030
|
-
|
|
3152
|
+
@animals = [
|
|
3153
|
+
Animal.new('cat', 'meow'),
|
|
3154
|
+
Animal.new('dog', 'woof'),
|
|
3155
|
+
Animal.new('chicken', 'cock-a-doodle-doo'),
|
|
3156
|
+
Animal.new('horse', 'neigh'),
|
|
3157
|
+
Animal.new('cow', 'moo'),
|
|
3031
3158
|
]
|
|
3032
3159
|
end
|
|
3033
3160
|
|
|
@@ -3040,17 +3167,19 @@ class BasicTableButton
|
|
|
3040
3167
|
button_column('Action') {
|
|
3041
3168
|
on_clicked do |row|
|
|
3042
3169
|
# Option 1: direct data deletion is the simpler solution
|
|
3043
|
-
# @
|
|
3170
|
+
# @animals.delete_at(row) # automatically deletes actual table row due to explicit data-binding
|
|
3044
3171
|
|
|
3045
|
-
# Option 2: cloning only to demonstrate table row deletion upon explicit setting of
|
|
3046
|
-
|
|
3047
|
-
|
|
3048
|
-
self.
|
|
3172
|
+
# Option 2: cloning only to demonstrate table row deletion upon explicit setting of animals attribute (cloning is not recommended beyond demonstrating this point)
|
|
3173
|
+
new_animals = @animals.clone
|
|
3174
|
+
new_animals.delete_at(row)
|
|
3175
|
+
self.animals = new_animals # automatically loses deleted table row due to explicit data-binding
|
|
3049
3176
|
end
|
|
3050
3177
|
}
|
|
3051
3178
|
|
|
3052
|
-
cell_rows <=> [self, :data] # explicit data-binding of table cell_rows to self.data
|
|
3053
3179
|
|
|
3180
|
+
cell_rows <= [self, :animals, column_attributes: {'Animal' => :name, 'Description' => :sound}]
|
|
3181
|
+
|
|
3182
|
+
# explicit unidirectional data-binding of table cell_rows to self.animals
|
|
3054
3183
|
on_changed do |row, type, row_data|
|
|
3055
3184
|
puts "Row #{row} #{type}: #{row_data}"
|
|
3056
3185
|
$stdout.flush
|
|
@@ -3299,7 +3428,7 @@ window('Animals', 500, 200) {
|
|
|
3299
3428
|
text_color_column('Sound')
|
|
3300
3429
|
checkbox_text_color_column('Description')
|
|
3301
3430
|
image_text_color_column('GUI')
|
|
3302
|
-
background_color_column
|
|
3431
|
+
background_color_column # must be the last column
|
|
3303
3432
|
|
|
3304
3433
|
cell_rows data
|
|
3305
3434
|
}
|
|
@@ -3341,7 +3470,7 @@ window('Animals', 500, 200) {
|
|
|
3341
3470
|
text_color_column('Sound')
|
|
3342
3471
|
checkbox_text_color_column('Description')
|
|
3343
3472
|
image_text_color_column('GUI')
|
|
3344
|
-
background_color_column
|
|
3473
|
+
background_color_column
|
|
3345
3474
|
|
|
3346
3475
|
cell_rows data
|
|
3347
3476
|
}
|
|
@@ -3483,9 +3612,9 @@ Run with this command if you installed the [Ruby gem](https://rubygems.org/gems/
|
|
|
3483
3612
|
ruby -r glimmer-dsl-libui -e "require 'examples/basic_scrolling_area'"
|
|
3484
3613
|
```
|
|
3485
3614
|
|
|
3486
|
-
Mac | Linux
|
|
3487
|
-
|
|
3488
|
-
  |  
|
|
3615
|
+
Mac | Windows | Linux
|
|
3616
|
+
----|---------|------
|
|
3617
|
+
  |   |  
|
|
3489
3618
|
|
|
3490
3619
|
New [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version:
|
|
3491
3620
|
|
|
@@ -3572,6 +3701,8 @@ BasicScrollingArea.new.launch
|
|
|
3572
3701
|
|
|
3573
3702
|
#### Basic Image
|
|
3574
3703
|
|
|
3704
|
+
Please note the caveats of [Area Image](#area-image) **(Alpha Feature)** with regards to this example.
|
|
3705
|
+
|
|
3575
3706
|
[examples/basic_image.rb](examples/basic_image.rb)
|
|
3576
3707
|
|
|
3577
3708
|
Run with this command from the root of the project if you cloned the project:
|
|
@@ -4822,9 +4953,9 @@ Run with this command if you installed the [Ruby gem](https://rubygems.org/gems/
|
|
|
4822
4953
|
ruby -r glimmer-dsl-libui -e "require 'examples/button_counter'"
|
|
4823
4954
|
```
|
|
4824
4955
|
|
|
4825
|
-
Mac | Linux
|
|
4826
|
-
|
|
4827
|
-
 | 
|
|
4956
|
+
Mac | Windows | Linux
|
|
4957
|
+
----|---------|------
|
|
4958
|
+
 |  | 
|
|
4828
4959
|
|
|
4829
4960
|
New [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version:
|
|
4830
4961
|
|
|
@@ -6263,8 +6394,8 @@ window('Editable animal sounds', 300, 200) {
|
|
|
6263
6394
|
text_column('Animal')
|
|
6264
6395
|
text_column('Description')
|
|
6265
6396
|
|
|
6266
|
-
cell_rows data
|
|
6267
6397
|
editable true
|
|
6398
|
+
cell_rows data
|
|
6268
6399
|
|
|
6269
6400
|
on_changed do |row, type, row_data| # fires on all changes (even ones happening through data array)
|
|
6270
6401
|
puts "Row #{row} #{type}: #{row_data}"
|
|
@@ -6302,7 +6433,359 @@ Mac | Windows | Linux
|
|
|
6302
6433
|
----|---------|------
|
|
6303
6434
|
   |    |   
|
|
6304
6435
|
|
|
6305
|
-
New [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version (with [data-binding](#data-binding)):
|
|
6436
|
+
New [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version (with explicit [data-binding](#data-binding)):
|
|
6437
|
+
|
|
6438
|
+
```ruby
|
|
6439
|
+
require 'glimmer-dsl-libui'
|
|
6440
|
+
|
|
6441
|
+
class FormTable
|
|
6442
|
+
Contact = Struct.new(:name, :email, :phone, :city, :state)
|
|
6443
|
+
|
|
6444
|
+
include Glimmer
|
|
6445
|
+
|
|
6446
|
+
attr_accessor :contacts, :name, :email, :phone, :city, :state, :filter_value
|
|
6447
|
+
|
|
6448
|
+
def initialize
|
|
6449
|
+
@contacts = [
|
|
6450
|
+
Contact.new('Lisa Sky', 'lisa@sky.com', '720-523-4329', 'Denver', 'CO'),
|
|
6451
|
+
Contact.new('Jordan Biggins', 'jordan@biggins.com', '617-528-5399', 'Boston', 'MA'),
|
|
6452
|
+
Contact.new('Mary Glass', 'mary@glass.com', '847-589-8788', 'Elk Grove Village', 'IL'),
|
|
6453
|
+
Contact.new('Darren McGrath', 'darren@mcgrath.com', '206-539-9283', 'Seattle', 'WA'),
|
|
6454
|
+
Contact.new('Melody Hanheimer', 'melody@hanheimer.com', '213-493-8274', 'Los Angeles', 'CA'),
|
|
6455
|
+
]
|
|
6456
|
+
end
|
|
6457
|
+
|
|
6458
|
+
def launch
|
|
6459
|
+
window('Contacts', 600, 600) { |w|
|
|
6460
|
+
margined true
|
|
6461
|
+
|
|
6462
|
+
vertical_box {
|
|
6463
|
+
form {
|
|
6464
|
+
stretchy false
|
|
6465
|
+
|
|
6466
|
+
entry {
|
|
6467
|
+
label 'Name'
|
|
6468
|
+
text <=> [self, :name] # bidirectional data-binding between entry text and self.name
|
|
6469
|
+
}
|
|
6470
|
+
|
|
6471
|
+
entry {
|
|
6472
|
+
label 'Email'
|
|
6473
|
+
text <=> [self, :email]
|
|
6474
|
+
}
|
|
6475
|
+
|
|
6476
|
+
entry {
|
|
6477
|
+
label 'Phone'
|
|
6478
|
+
text <=> [self, :phone]
|
|
6479
|
+
}
|
|
6480
|
+
|
|
6481
|
+
entry {
|
|
6482
|
+
label 'City'
|
|
6483
|
+
text <=> [self, :city]
|
|
6484
|
+
}
|
|
6485
|
+
|
|
6486
|
+
entry {
|
|
6487
|
+
label 'State'
|
|
6488
|
+
text <=> [self, :state]
|
|
6489
|
+
}
|
|
6490
|
+
}
|
|
6491
|
+
|
|
6492
|
+
button('Save Contact') {
|
|
6493
|
+
stretchy false
|
|
6494
|
+
|
|
6495
|
+
on_clicked do
|
|
6496
|
+
new_row = [name, email, phone, city, state]
|
|
6497
|
+
if new_row.include?('')
|
|
6498
|
+
msg_box_error(w, 'Validation Error!', 'All fields are required! Please make sure to enter a value for all fields.')
|
|
6499
|
+
else
|
|
6500
|
+
@contacts << Contact.new(*new_row) # automatically inserts a row into the table due to explicit data-binding
|
|
6501
|
+
@unfiltered_contacts = @contacts.dup
|
|
6502
|
+
self.name = '' # automatically clears name entry through explicit data-binding
|
|
6503
|
+
self.email = ''
|
|
6504
|
+
self.phone = ''
|
|
6505
|
+
self.city = ''
|
|
6506
|
+
self.state = ''
|
|
6507
|
+
end
|
|
6508
|
+
end
|
|
6509
|
+
}
|
|
6510
|
+
|
|
6511
|
+
search_entry {
|
|
6512
|
+
stretchy false
|
|
6513
|
+
# bidirectional data-binding of text to self.filter_value with after_write option
|
|
6514
|
+
text <=> [self, :filter_value,
|
|
6515
|
+
after_write: ->(filter_value) { # execute after write to self.filter_value
|
|
6516
|
+
@unfiltered_contacts ||= @contacts.dup
|
|
6517
|
+
# Unfilter first to remove any previous filters
|
|
6518
|
+
self.contacts = @unfiltered_contacts.dup # affects table indirectly through explicit data-binding
|
|
6519
|
+
# Now, apply filter if entered
|
|
6520
|
+
unless filter_value.empty?
|
|
6521
|
+
self.contacts = @contacts.filter do |contact| # affects table indirectly through explicit data-binding
|
|
6522
|
+
contact.members.any? do |attribute|
|
|
6523
|
+
contact[attribute].to_s.downcase.include?(filter_value.downcase)
|
|
6524
|
+
end
|
|
6525
|
+
end
|
|
6526
|
+
end
|
|
6527
|
+
}
|
|
6528
|
+
]
|
|
6529
|
+
}
|
|
6530
|
+
|
|
6531
|
+
table {
|
|
6532
|
+
text_column('Name')
|
|
6533
|
+
text_column('Email')
|
|
6534
|
+
text_column('Phone')
|
|
6535
|
+
text_column('City')
|
|
6536
|
+
text_column('State')
|
|
6537
|
+
|
|
6538
|
+
editable true
|
|
6539
|
+
cell_rows <=> [self, :contacts] # explicit data-binding to Model Array
|
|
6540
|
+
|
|
6541
|
+
on_changed do |row, type, row_data|
|
|
6542
|
+
puts "Row #{row} #{type}: #{row_data}"
|
|
6543
|
+
end
|
|
6544
|
+
}
|
|
6545
|
+
}
|
|
6546
|
+
}.show
|
|
6547
|
+
end
|
|
6548
|
+
end
|
|
6549
|
+
|
|
6550
|
+
FormTable.new.launch
|
|
6551
|
+
```
|
|
6552
|
+
|
|
6553
|
+
New [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version (with explicit [data-binding](#data-binding)):
|
|
6554
|
+
|
|
6555
|
+
```ruby
|
|
6556
|
+
require 'glimmer-dsl-libui'
|
|
6557
|
+
|
|
6558
|
+
class FormTable
|
|
6559
|
+
Contact = Struct.new(:name, :email, :phone, :city, :state)
|
|
6560
|
+
|
|
6561
|
+
include Glimmer
|
|
6562
|
+
|
|
6563
|
+
attr_accessor :contacts, :name, :email, :phone, :city, :state, :filter_value
|
|
6564
|
+
|
|
6565
|
+
def initialize
|
|
6566
|
+
@contacts = [
|
|
6567
|
+
Contact.new('Lisa Sky', 'lisa@sky.com', '720-523-4329', 'Denver', 'CO'),
|
|
6568
|
+
Contact.new('Jordan Biggins', 'jordan@biggins.com', '617-528-5399', 'Boston', 'MA'),
|
|
6569
|
+
Contact.new('Mary Glass', 'mary@glass.com', '847-589-8788', 'Elk Grove Village', 'IL'),
|
|
6570
|
+
Contact.new('Darren McGrath', 'darren@mcgrath.com', '206-539-9283', 'Seattle', 'WA'),
|
|
6571
|
+
Contact.new('Melody Hanheimer', 'melody@hanheimer.com', '213-493-8274', 'Los Angeles', 'CA'),
|
|
6572
|
+
]
|
|
6573
|
+
end
|
|
6574
|
+
|
|
6575
|
+
def launch
|
|
6576
|
+
window('Contacts', 600, 600) { |w|
|
|
6577
|
+
margined true
|
|
6578
|
+
|
|
6579
|
+
vertical_box {
|
|
6580
|
+
form {
|
|
6581
|
+
stretchy false
|
|
6582
|
+
|
|
6583
|
+
entry {
|
|
6584
|
+
label 'Name'
|
|
6585
|
+
text <=> [self, :name] # bidirectional data-binding between entry text and self.name
|
|
6586
|
+
}
|
|
6587
|
+
|
|
6588
|
+
entry {
|
|
6589
|
+
label 'Email'
|
|
6590
|
+
text <=> [self, :email]
|
|
6591
|
+
}
|
|
6592
|
+
|
|
6593
|
+
entry {
|
|
6594
|
+
label 'Phone'
|
|
6595
|
+
text <=> [self, :phone]
|
|
6596
|
+
}
|
|
6597
|
+
|
|
6598
|
+
entry {
|
|
6599
|
+
label 'City'
|
|
6600
|
+
text <=> [self, :city]
|
|
6601
|
+
}
|
|
6602
|
+
|
|
6603
|
+
entry {
|
|
6604
|
+
label 'State'
|
|
6605
|
+
text <=> [self, :state]
|
|
6606
|
+
}
|
|
6607
|
+
}
|
|
6608
|
+
|
|
6609
|
+
button('Save Contact') {
|
|
6610
|
+
stretchy false
|
|
6611
|
+
|
|
6612
|
+
on_clicked do
|
|
6613
|
+
new_row = [name, email, phone, city, state]
|
|
6614
|
+
if new_row.include?('')
|
|
6615
|
+
msg_box_error(w, 'Validation Error!', 'All fields are required! Please make sure to enter a value for all fields.')
|
|
6616
|
+
else
|
|
6617
|
+
@contacts << Contact.new(*new_row) # automatically inserts a row into the table due to implicit data-binding
|
|
6618
|
+
@unfiltered_contacts = @contacts.dup
|
|
6619
|
+
self.name = '' # automatically clears name entry through explicit data-binding
|
|
6620
|
+
self.email = ''
|
|
6621
|
+
self.phone = ''
|
|
6622
|
+
self.city = ''
|
|
6623
|
+
self.state = ''
|
|
6624
|
+
end
|
|
6625
|
+
end
|
|
6626
|
+
}
|
|
6627
|
+
|
|
6628
|
+
search_entry {
|
|
6629
|
+
stretchy false
|
|
6630
|
+
# bidirectional data-binding of text to self.filter_value with after_write option
|
|
6631
|
+
text <=> [self, :filter_value,
|
|
6632
|
+
after_write: ->(filter_value) { # execute after write to self.filter_value
|
|
6633
|
+
@unfiltered_contacts ||= @contacts.dup
|
|
6634
|
+
# Unfilter first to remove any previous filters
|
|
6635
|
+
self.contacts = @unfiltered_contacts.dup # affects table indirectly through explicit data-binding
|
|
6636
|
+
# Now, apply filter if entered
|
|
6637
|
+
unless filter_value.empty?
|
|
6638
|
+
self.contacts = @contacts.filter do |contact| # affects table indirectly through explicit data-binding
|
|
6639
|
+
contact.members.any? do |attribute|
|
|
6640
|
+
contact[attribute].to_s.downcase.include?(filter_value.downcase)
|
|
6641
|
+
end
|
|
6642
|
+
end
|
|
6643
|
+
end
|
|
6644
|
+
}
|
|
6645
|
+
]
|
|
6646
|
+
}
|
|
6647
|
+
|
|
6648
|
+
table {
|
|
6649
|
+
text_column('Name')
|
|
6650
|
+
text_column('Email')
|
|
6651
|
+
text_column('Phone')
|
|
6652
|
+
text_column('City')
|
|
6653
|
+
text_column('State/Province')
|
|
6654
|
+
|
|
6655
|
+
editable true
|
|
6656
|
+
cell_rows <=> [self, :contacts, column_attributes: {'State/Province' => :state}] # explicit data-binding to Model Array with column_attributes mapping for a specific column
|
|
6657
|
+
|
|
6658
|
+
on_changed do |row, type, row_data|
|
|
6659
|
+
puts "Row #{row} #{type}: #{row_data}"
|
|
6660
|
+
end
|
|
6661
|
+
}
|
|
6662
|
+
}
|
|
6663
|
+
}.show
|
|
6664
|
+
end
|
|
6665
|
+
end
|
|
6666
|
+
|
|
6667
|
+
FormTable.new.launch
|
|
6668
|
+
```
|
|
6669
|
+
|
|
6670
|
+
New [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version (with explicit [data-binding](#data-binding)):
|
|
6671
|
+
|
|
6672
|
+
```ruby
|
|
6673
|
+
|
|
6674
|
+
require 'glimmer-dsl-libui'
|
|
6675
|
+
|
|
6676
|
+
class FormTable
|
|
6677
|
+
Contact = Struct.new(:full_name, :email_address, :phone_number, :city_or_town, :state_or_province)
|
|
6678
|
+
|
|
6679
|
+
include Glimmer
|
|
6680
|
+
|
|
6681
|
+
attr_accessor :contacts, :name, :email, :phone, :city, :state, :filter_value
|
|
6682
|
+
|
|
6683
|
+
def initialize
|
|
6684
|
+
@contacts = [
|
|
6685
|
+
Contact.new('Lisa Sky', 'lisa@sky.com', '720-523-4329', 'Denver', 'CO'),
|
|
6686
|
+
Contact.new('Jordan Biggins', 'jordan@biggins.com', '617-528-5399', 'Boston', 'MA'),
|
|
6687
|
+
Contact.new('Mary Glass', 'mary@glass.com', '847-589-8788', 'Elk Grove Village', 'IL'),
|
|
6688
|
+
Contact.new('Darren McGrath', 'darren@mcgrath.com', '206-539-9283', 'Seattle', 'WA'),
|
|
6689
|
+
Contact.new('Melody Hanheimer', 'melody@hanheimer.com', '213-493-8274', 'Los Angeles', 'CA'),
|
|
6690
|
+
]
|
|
6691
|
+
end
|
|
6692
|
+
|
|
6693
|
+
def launch
|
|
6694
|
+
window('Contacts', 600, 600) { |w|
|
|
6695
|
+
margined true
|
|
6696
|
+
|
|
6697
|
+
vertical_box {
|
|
6698
|
+
form {
|
|
6699
|
+
stretchy false
|
|
6700
|
+
|
|
6701
|
+
entry {
|
|
6702
|
+
label 'Name'
|
|
6703
|
+
text <=> [self, :name] # bidirectional data-binding between entry text and self.name
|
|
6704
|
+
}
|
|
6705
|
+
|
|
6706
|
+
entry {
|
|
6707
|
+
label 'Email'
|
|
6708
|
+
text <=> [self, :email]
|
|
6709
|
+
}
|
|
6710
|
+
|
|
6711
|
+
entry {
|
|
6712
|
+
label 'Phone'
|
|
6713
|
+
text <=> [self, :phone]
|
|
6714
|
+
}
|
|
6715
|
+
|
|
6716
|
+
entry {
|
|
6717
|
+
label 'City'
|
|
6718
|
+
text <=> [self, :city]
|
|
6719
|
+
}
|
|
6720
|
+
|
|
6721
|
+
entry {
|
|
6722
|
+
label 'State'
|
|
6723
|
+
text <=> [self, :state]
|
|
6724
|
+
}
|
|
6725
|
+
}
|
|
6726
|
+
|
|
6727
|
+
button('Save Contact') {
|
|
6728
|
+
stretchy false
|
|
6729
|
+
|
|
6730
|
+
on_clicked do
|
|
6731
|
+
new_row = [name, email, phone, city, state]
|
|
6732
|
+
if new_row.include?('')
|
|
6733
|
+
msg_box_error(w, 'Validation Error!', 'All fields are required! Please make sure to enter a value for all fields.')
|
|
6734
|
+
else
|
|
6735
|
+
@contacts << Contact.new(*new_row) # automatically inserts a row into the table due to implicit data-binding
|
|
6736
|
+
@unfiltered_contacts = @contacts.dup
|
|
6737
|
+
self.name = '' # automatically clears name entry through explicit data-binding
|
|
6738
|
+
self.email = ''
|
|
6739
|
+
self.phone = ''
|
|
6740
|
+
self.city = ''
|
|
6741
|
+
self.state = ''
|
|
6742
|
+
end
|
|
6743
|
+
end
|
|
6744
|
+
}
|
|
6745
|
+
|
|
6746
|
+
search_entry {
|
|
6747
|
+
stretchy false
|
|
6748
|
+
# bidirectional data-binding of text to self.filter_value with after_write option
|
|
6749
|
+
text <=> [self, :filter_value,
|
|
6750
|
+
after_write: ->(filter_value) { # execute after write to self.filter_value
|
|
6751
|
+
@unfiltered_contacts ||= @contacts.dup
|
|
6752
|
+
# Unfilter first to remove any previous filters
|
|
6753
|
+
self.contacts = @unfiltered_contacts.dup # affects table indirectly through explicit data-binding
|
|
6754
|
+
# Now, apply filter if entered
|
|
6755
|
+
unless filter_value.empty?
|
|
6756
|
+
self.contacts = @contacts.filter do |contact| # affects table indirectly through explicit data-binding
|
|
6757
|
+
contact.members.any? do |attribute|
|
|
6758
|
+
contact[attribute].to_s.downcase.include?(filter_value.downcase)
|
|
6759
|
+
end
|
|
6760
|
+
end
|
|
6761
|
+
end
|
|
6762
|
+
}
|
|
6763
|
+
]
|
|
6764
|
+
}
|
|
6765
|
+
|
|
6766
|
+
table {
|
|
6767
|
+
text_column('Name')
|
|
6768
|
+
text_column('Email')
|
|
6769
|
+
text_column('Phone')
|
|
6770
|
+
text_column('City')
|
|
6771
|
+
text_column('State')
|
|
6772
|
+
|
|
6773
|
+
editable true
|
|
6774
|
+
cell_rows <=> [self, :contacts, column_attributes: [:full_name, :email_address, :phone_number, :city_or_town, :state_or_province]] # explicit data-binding to Model Array with column_attributes mapping for all columns
|
|
6775
|
+
|
|
6776
|
+
on_changed do |row, type, row_data|
|
|
6777
|
+
puts "Row #{row} #{type}: #{row_data}"
|
|
6778
|
+
end
|
|
6779
|
+
}
|
|
6780
|
+
}
|
|
6781
|
+
}.show
|
|
6782
|
+
end
|
|
6783
|
+
end
|
|
6784
|
+
|
|
6785
|
+
FormTable.new.launch
|
|
6786
|
+
```
|
|
6787
|
+
|
|
6788
|
+
New [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version 4 (with explicit [data-binding](#data-binding) to raw data):
|
|
6306
6789
|
|
|
6307
6790
|
```ruby
|
|
6308
6791
|
require 'glimmer-dsl-libui'
|
|
@@ -6332,7 +6815,7 @@ class FormTable
|
|
|
6332
6815
|
|
|
6333
6816
|
entry {
|
|
6334
6817
|
label 'Name'
|
|
6335
|
-
text <=> [self, :name]
|
|
6818
|
+
text <=> [self, :name] # bidirectional data-binding between entry text and self.name
|
|
6336
6819
|
}
|
|
6337
6820
|
|
|
6338
6821
|
entry {
|
|
@@ -6364,8 +6847,8 @@ class FormTable
|
|
|
6364
6847
|
if new_row.include?('')
|
|
6365
6848
|
msg_box_error(w, 'Validation Error!', 'All fields are required! Please make sure to enter a value for all fields.')
|
|
6366
6849
|
else
|
|
6367
|
-
|
|
6368
|
-
@unfiltered_data =
|
|
6850
|
+
data << new_row # automatically inserts a row into the table due to implicit data-binding
|
|
6851
|
+
@unfiltered_data = data.dup
|
|
6369
6852
|
self.name = '' # automatically clears name entry through explicit data-binding
|
|
6370
6853
|
self.email = ''
|
|
6371
6854
|
self.phone = ''
|
|
@@ -6377,14 +6860,15 @@ class FormTable
|
|
|
6377
6860
|
|
|
6378
6861
|
search_entry {
|
|
6379
6862
|
stretchy false
|
|
6380
|
-
|
|
6863
|
+
# bidirectional data-binding of text to self.filter_value with after_write option
|
|
6864
|
+
text <=> [self, :filter_value,
|
|
6381
6865
|
after_write: ->(filter_value) { # execute after write to self.filter_value
|
|
6382
|
-
@unfiltered_data ||=
|
|
6866
|
+
@unfiltered_data ||= data.dup
|
|
6383
6867
|
# Unfilter first to remove any previous filters
|
|
6384
|
-
|
|
6868
|
+
data.replace(@unfiltered_data) # affects table indirectly through implicit data-binding
|
|
6385
6869
|
# Now, apply filter if entered
|
|
6386
6870
|
unless filter_value.empty?
|
|
6387
|
-
|
|
6871
|
+
data.filter! do |row_data| # affects table indirectly through implicit data-binding
|
|
6388
6872
|
row_data.any? do |cell|
|
|
6389
6873
|
cell.to_s.downcase.include?(filter_value.downcase)
|
|
6390
6874
|
end
|
|
@@ -6400,8 +6884,9 @@ class FormTable
|
|
|
6400
6884
|
text_column('Phone')
|
|
6401
6885
|
text_column('City')
|
|
6402
6886
|
text_column('State')
|
|
6403
|
-
|
|
6404
|
-
|
|
6887
|
+
|
|
6888
|
+
editable true
|
|
6889
|
+
cell_rows <=> [self, :data] # explicit data-binding to raw data Array of Arrays
|
|
6405
6890
|
|
|
6406
6891
|
on_changed do |row, type, row_data|
|
|
6407
6892
|
puts "Row #{row} #{type}: #{row_data}"
|
|
@@ -6415,7 +6900,7 @@ end
|
|
|
6415
6900
|
FormTable.new.launch
|
|
6416
6901
|
```
|
|
6417
6902
|
|
|
6418
|
-
New [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version
|
|
6903
|
+
New [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version 5 (with implicit [data-binding](#data-binding)):
|
|
6419
6904
|
|
|
6420
6905
|
```ruby
|
|
6421
6906
|
require 'glimmer-dsl-libui'
|
|
@@ -6503,7 +6988,8 @@ window('Contacts', 600, 600) { |w|
|
|
|
6503
6988
|
text_column('City')
|
|
6504
6989
|
text_column('State')
|
|
6505
6990
|
|
|
6506
|
-
|
|
6991
|
+
editable true
|
|
6992
|
+
cell_rows data # implicit data-binding to raw data Array of Arrays
|
|
6507
6993
|
|
|
6508
6994
|
on_changed do |row, type, row_data|
|
|
6509
6995
|
puts "Row #{row} #{type}: #{row_data}"
|