feat: add network management UI for kobo

frontend/ui/widget/listview.lua

@@ -0,0 +1,123 @@
+--[[--
+Widget compoent that handles pagination for a list of items.
+
+Example:
+
+    local list_view = ListView:new{
+        height = 400,
+        width = 200,
+        page_update_cb = function(curr_page_num, total_pages)
+            -- This callback function will be called whenever there is a
+            -- page turn event triggered. You can use it to update information
+            -- on parent widget.
+        end,
+        items = {
+            FrameContainer:new{
+                bordersize = 0,
+                background = Blitbuffer.COLOR_WHITE
+                TextWidget:new{
+                    text = "foo",
+                    fact = Font:getFace("cfont"),
+                }
+            },
+            FrameContainer:new{
+                bordersize = 0,
+                background = Blitbuffer.COLOR_LIGHT_GREY
+                TextWidget:new{
+                    text = "bar",
+                    fact = Font:getFace("cfont"),
+                }
+            },
+            -- You can add as many widgets as you want here...
+        }
+    }
+
+Note that ListView is created mainly to be used as a building block for other
+widgets like NetworkSetting so they can share the same pagination code.
+]]
+
+local InputContainer = require("ui/widget/container/inputcontainer")
+local FrameContainer = require("ui/widget/container/framecontainer")
+local VerticalGroup = require("ui/widget/verticalgroup")
+local GestureRange = require("ui/gesturerange")
+local Blitbuffer = require("ffi/blitbuffer")
+local Device = require("device")
+local Screen = Device.screen
+local Geom = require("ui/geometry")
+
+local ListView = InputContainer:new{
+    width = nil,
+    height = nil,
+    padding = nil,
+    item_height = nil,
+    itmes = nil,
+}
+
+function ListView:init()
+    self.show_page = 1
+    self.dimen = Geom:new{w = self.width, h = self.height}
+
+    if Device:isTouchDevice() then
+        self.ges_events.Swipe = {
+            GestureRange:new{
+                ges = "swipe",
+                range = self.dimen,
+            }
+        }
+    end
+
+    local padding = self.padding or Screen:scaleBySize(10)
+    self.item_height = self.item_height or self.items[1]:getSize().h
+    self.item_width = self.dimen.w - 2 * padding
+    self.items_per_page = math.floor(self.height / self.item_height)
+    self.main_content = VerticalGroup:new{}
+    self:_populateItems()
+    self[1] = FrameContainer:new{
+        height = self.dimen.h,
+        padding = padding,
+        bordersize = 0,
+        background = Blitbuffer.COLOR_WHITE,
+        self.main_content,
+    }
+end
+
+-- make sure self.item_height are set before calling this
+function ListView:_populateItems()
+    self.pages = math.ceil(#self.items / self.items_per_page)
+    self.main_content:clear()
+    local idx_offset = (self.show_page - 1) * self.items_per_page
+    for idx = 1, self.items_per_page do
+        local item = self.items[idx_offset + idx]
+        if item == nil then break end
+        table.insert(self.main_content, item)
+    end
+    self.page_update_cb(self.show_page, self.pages)
+end
+
+function ListView:nextPage()
+    local new_page = math.min(self.show_page+1, self.pages)
+    if new_page > self.show_page then
+        self.show_page = new_page
+        self:_populateItems()
+    end
+end
+
+function ListView:prevPage()
+    local new_page = math.max(self.show_page-1, 1)
+    if new_page < self.show_page then
+        self.show_page = new_page
+        self:_populateItems()
+    end
+end
+
+function ListView:onSwipe(arg, ges_ev)
+    if ges_ev.direction == "west" then
+        self:nextPage()
+        return true
+    elseif ges_ev.direction == "east" then
+        self:prevPage()
+        return true
+    end
+end
+
+return ListView