Share your advanced knowledge/code with the community.
User avatar
Peter
 
Posts: 625
Joined: Mon Feb 24, 2014 10:17 pm
Location: 127.0.0.1

BlockUI

by Peter Thu Jun 08, 2017 10:09 am

Hello,

if you want to block your UI (because you have a long running background process like HttpRequest or something else) you can use the $.blockUI() - Command (in JavaScript mode).

Here is a sample code how to use it:
Code: Select all
Enumeration
  #Window
  #Button
  #Timer
EndEnumeration

Procedure BlockUI(Message.s)
  ! $.blockUI({ message: v_message });
EndProcedure

Procedure UnblockUI()
  ! $.unblockUI();
EndProcedure

Procedure TimerEvent()
 
  UnblockUI()
 
  RemoveWindowTimer(#Window, #Timer) 
 
EndProcedure

Procedure ButtonEvent()
 
  BlockUI("<h1>Waiting 3 seconds...</h1>")
 
  AddWindowTimer(#Window, #Timer, 3000) ; Wait 3 Seconds...
 
  BindEvent(#PB_Event_Timer, @TimerEvent(), #Window)
 
EndProcedure

OpenWindow(#Window, 0, 0, 300, 100, "BlockUI example", #PB_Window_SystemMenu | #PB_Window_SizeGadget | #PB_Window_ScreenCentered)

ButtonGadget(#Button, 10, 10, 200, 30, "Block UI for 3 seconds")

BindGadgetEvent(#Button, @ButtonEvent())


You can get further informations here: http://malsup.com/jquery/block/

Greetings ... Peter
User avatar
SparrowhawkMMU
 
Posts: 277
Joined: Wed Aug 19, 2015 3:02 pm
Location: United Kingdom

Re: BlockUI

by SparrowhawkMMU Mon Dec 18, 2017 8:50 am

+1 very useful and cleaner than what I am currently using.
bbanelli
 
Posts: 102
Joined: Mon Jul 13, 2015 7:40 am

Re: BlockUI

by bbanelli Tue Jan 02, 2018 9:21 pm

Fantastic trick n' tip, Peter, as always!!!
"If you lie to the compiler, it will get its revenge."
Henry Spencer
http://www.pci-z.com/
munfraid
 
Posts: 30
Joined: Sat Mar 24, 2018 1:33 pm

Re: BlockUI

by munfraid Sat Jun 23, 2018 12:50 pm

Thanks very much for this great Tip, Peter! It's so easy and works like charme. I put a spinner using this code:

Code: Select all
BlockUI("<p><i class='fa fa-spinner fa-spin fa-4x' aria-hidden='true'></i></p>")


The spinner is shown, but any idea how I can remove the white box in the background? Would like to show just the spinner itself.
User avatar
Peter
 
Posts: 625
Joined: Mon Feb 24, 2014 10:17 pm
Location: 127.0.0.1

Re: BlockUI

by Peter Tue Oct 15, 2019 9:40 am

Hallo,

besides the possibility to block the entire screen, you can also block individual windows or gadgets.

The following code shows how to do this:

Code: Select all
Procedure BlockUI(Message.s)
  ! $.blockUI({ message: v_message });
EndProcedure

Procedure UnblockUI()
  ! $.unblockUI();
EndProcedure

Procedure BlockWindow(Window, Message.s)
 
  If IsWindow(Window)
    Protected WID = WindowID(Window)
    ! $(v_wid.content.parentElement.parentElement).block({ message: v_message });
  EndIf
 
EndProcedure

Procedure UnblockWindow(Window)
 
  If IsWindow(Window)
    Protected WID = WindowID(Window)
    ! $(v_wid.content.parentElement.parentElement).unblock();
  EndIf
 
EndProcedure

Procedure BlockGadget(Gadget, Message.s)
 
  If IsGadget(Gadget)
    Protected GID = GadgetID(Gadget)
    ! $(v_gid.div).block({ message: v_message });
  EndIf
 
EndProcedure

Procedure UnblockGadget(Gadget)
 
  If IsGadget(Gadget)
    Protected GID = GadgetID(Gadget)
    ! $(v_gid.div).unblock();
  EndIf
 
EndProcedure

; Demo

CompilerIf #PB_Compiler_IsMainFile
 
  Enumeration
    #Window
    #btnBlockScreen
    #btnBlockWindow
    #btnBlockGadget
    #Gadget
  EndEnumeration
 
  Enumeration
    #timBlock
  EndEnumeration
 
  Global BlockType.s
 
  Procedure timBlockEvent()
   
    Select BlockType
       
      Case "Screen"
        UnblockUI()
       
      Case "Window"
        UnblockWindow(#Window)
       
      Case "Gadget"
        UnblockGadget(#Gadget)
       
    EndSelect
   
    RemoveWindowTimer(#Window, #timBlock)
   
    DisableGadget(#btnBlockScreen, #False)
    DisableGadget(#btnBlockWindow, #False)
    DisableGadget(#btnBlockGadget, #False)
   
  EndProcedure
 
  Procedure BlockIt()
   
    Select BlockType
       
      Case "Screen"
        BlockUI("<h1>Waiting 2 seconds....</h1>")
       
      Case "Window"
        BlockWindow(#Window, "<h2>Waiting 2 seconds....</h2>")
       
      Case "Gadget"
        BlockGadget(#Gadget, "<h3>Waiting 2 seconds....</h3>")
       
    EndSelect
   
    AddWindowTimer(#Window, #timBlock, 2000)
    BindEvent(#PB_Event_Timer, @timBlockEvent(), #Window, #timBlock)
   
    DisableGadget(#btnBlockScreen, #True)
    DisableGadget(#btnBlockWindow, #True)
    DisableGadget(#btnBlockGadget, #True)
   
  EndProcedure
 
  ; --
 
  Procedure btnBlockScreenEvent()
    BlockType = "Screen"
    BlockIt()
  EndProcedure
 
  Procedure btnBlockWindowEvent()
    BlockType = "Window"
    BlockIt()
  EndProcedure
 
  Procedure btnBlockGadgetEvent()
    BlockType = "Gadget"
    BlockIt()
  EndProcedure
 
  ; --
 
  OpenWindow(#Window, #PB_Ignore, #PB_Ignore, 420, 400, "BlockUI-Demo", #PB_Window_ScreenCentered)
 
  ButtonGadget(#btnBlockScreen, 10,  10, 400, 50, "Block screen")
  ButtonGadget(#btnBlockWindow, 10,  70, 400, 50, "Block window")
  ButtonGadget(#btnBlockGadget, 10, 130, 400, 50, "Block gadget")
 
  ListIconGadget(#Gadget, 10, 190, 400, 200, "Col1", 100, #PB_ListIcon_GridLines)
  AddGadgetColumn(#Gadget, 1, "Col2", 100)
 
  AddGadgetItem(#Gadget, -1, "Foo" + #LF$ + "Bar")
 
  BindGadgetEvent(#btnBlockScreen, @btnBlockScreenEvent())
  BindGadgetEvent(#btnBlockWindow, @btnBlockWindowEvent())
  BindGadgetEvent(#btnBlockGadget, @btnBlockGadgetEvent())
 
CompilerEndIf


Greetings ... Peter
Return to Tricks 'n' Tips

Who is online

Users browsing this forum: No registered users and 1 guest