Difference between revisions of "Working with UI Page Libraries"

From Lianjapedia
Jump to: navigation, search
Line 93: Line 93:
 
=App UILibs=
 
=App UILibs=
 
App UILibs are available from v5.6.  Design pages visually then add them to the App UiLib enabling them to be used with lianja.showDialog() and Lianja.showDialogPanel(). Check the page attribute “Register in UiLib”. The pages are not included in the pages menu but can be used with dialogs by specifying "page:pagename" as the file name.
 
App UILibs are available from v5.6.  Design pages visually then add them to the App UiLib enabling them to be used with lianja.showDialog() and Lianja.showDialogPanel(). Check the page attribute “Register in UiLib”. The pages are not included in the pages menu but can be used with dialogs by specifying "page:pagename" as the file name.
 +
 +
[[Category:Lianja v5.6]]

Revision as of 05:08, 26 November 2020

Under Construction

See article here

Overview

Lianja Demo App



In Lianja App Builder, Pages can be saved in a Visual Page Library as reusable UI Page components.

This provides developers with the ability to lay out pages in the Pages Workspace (with all of the power and functionality of related sections) and reuse these pages in dialogs and desktop navigation Panels and component gadgets .

Saving to the UI Page Library

Headerbar Toolbutton: Save in the Page Library

Page Attribute

Attribute Description Name Type
Autosave in Page Library Always save this page to the UI Page Library when an App is saved. alwaysSaveInPageLibrary Boolean

Custom Event Delegates

For UI Pages with Custom Event Delegates, see forum post here

Using UI Page Library Files

showdialog

On the desktop client, the showdialog action or the Lianja.showDialog() method can be used to pop up a dialog with an embedded Page from the UI Page Library.

Lianja.showDocument("showdialog:page?title=cTitle
                                    &width=nWidth
                                    &height=nHeight
                                    &buttons=lButtons
                                    &ontop=lOntop
                                    &modal=lModal
                                    &action=cAction
                                    &text=cText
                                    &resizable=lResizable")


The Lianja.showDialog() method pops up a standard dialog and embeds the specified page from the page library into it.

Lianja.showDialog(title as Character, 
                  page as Character
                  [, width as Numeric
                  [, height as Numeric
                  [, buttons as Logical
                  [, ontop as Logical
                  [, modal as Logical
                  [, action as Character
                  [, text as Character
                  [, resizable as Logical]]]]]]]]

Note: Prior to v5.6, when using Lianja.showDialog() on the web/mobile client, the page must be a .rsp or .jssp script. From v5.6, App UILibs are supported and allow embedded pages to be displayed.

showdialogpanel

On the desktop client, the showdialogpanel action or the Lianja.showDialogPanel() method can be used to slide in a dialogPanel with an embedded Page from the UI Page Library.


The Lianja.showDialogPanel() method slides a dialogPanel in from the right of the main window and embeds the specified page from the page library into it. If width is a negative number, the dialogPanel will slide from the left.

Lianja.showDialogPanel(title as Character, 
                  page as Character
                  [, width as Numeric
                  [, action as Character
                  [, text as Character]]]

Note: Prior to v5.6, when using Lianja.showDialogPanel() on the web/mobile client, the page must be a .rsp or .jssp script. Specifying a width of "100%" will animate the dialogPanel in place and it will occupy the whole page viewport on the web/mobile client. From v5.6, App UILibs are supported and allow embedded pages to be displayed.

Component Gadgets

Component Gadget Attributes

Attribute Description Name Type
Custom UI component Specify a custom UI component from the UI Page Library to embed into this gadget customComponent Character

App UILibs

App UILibs are available from v5.6. Design pages visually then add them to the App UiLib enabling them to be used with lianja.showDialog() and Lianja.showDialogPanel(). Check the page attribute “Register in UiLib”. The pages are not included in the pages menu but can be used with dialogs by specifying "page:pagename" as the file name.