ผลต่างระหว่างรุ่นของ "CuneiModal"
บรรทัดที่ 43: | บรรทัดที่ 43: | ||
Below is the list of and notes on modal object attributes: | Below is the list of and notes on modal object attributes: | ||
* '''Basic Attributes''' | * '''Basic Attributes''' | ||
** '''id''' ''(str)'': The ID of the CuneiModal. | |||
** '''self_type''': Takes on the value {{code|lang=javascript|'modal'}}. | |||
** '''type''': Takes on the value of '''{{code|type}}''' argument of the Jinja2 macro. | |||
* '''Colours & Classes''' | * '''Colours & Classes''' | ||
** head_class | |||
** ok_class | |||
* '''References to Modal Elements''' | * '''References to Modal Elements''' | ||
** modal_ele | |||
** ok_ele | |||
** close_ele | |||
** x_ele | |||
** main_comp_obj | |||
* '''References to Other Elements''' | * '''References to Other Elements''' | ||
** first_focus | |||
** next_focus | |||
** invoker | |||
** fillers | |||
* '''Status Attributes''' | * '''Status Attributes''' | ||
** hold_modal | |||
** release_modal | |||
** shown_status | |||
** about_to_show | |||
** instant_trigger | |||
** post_fill_nav | |||
** hide_mode | |||
** promptly_submit | |||
=== Modal Lower Macro === | === Modal Lower Macro === |
รุ่นแก้ไขเมื่อ 12:06, 24 มิถุนายน 2567
CuneiModals are basically pop-up windows with pre-defined scripts and event handlers to make them work fluently with CuneiForms and CuneiTables. They are purely client-side constructs, so there are no needs to define and initiate them on the server side. It is, however, necessary for the server-side developer to anticipate their existence and, in most cases, their IDs in the server-side code. (See attributes in_modal of CuneiForms and in_modal/bound_modal of CuneiTables.)
Design & Pre-made Scripts
The process of putting up a CuneiModal is designed to be as straigtforward as possible, at least for the most common use cases (see notes on CuneiModal types below). All one has to do is to surround whatever that go in a modal with 2 extra lines of Jinja2 macros.
{{ CuneiModals.modal_upper_half("<ModalID>", ...) }}
/* Modal content goes here. */
{{ CuneiModals.modal_lower_half("<ModalID>", ...) }}
Modal Upper Macro & Modal Object
This half of the CuneiModal macros takes care of creating the CuneiModal object and initiating the modal HTML elements up to the open tag of the <div>
for modal-content.
modal_upper_half(modalid, type="table", title="Look up",
class="primary", head_bg=false, size=false,
first_focus=false)
Parameters | DO NOT rely on argument order farther than modalid and type, ALWAYS PROVIDE argument keywords.
|
Modal Object Attributes
Below is the list of and notes on modal object attributes:
- Basic Attributes
- id (str): The ID of the CuneiModal.
- self_type: Takes on the value
'modal'
. - type: Takes on the value of
type
argument of the Jinja2 macro.
- Colours & Classes
- head_class
- ok_class
- References to Modal Elements
- modal_ele
- ok_ele
- close_ele
- x_ele
- main_comp_obj
- References to Other Elements
- first_focus
- next_focus
- invoker
- fillers
- Status Attributes
- hold_modal
- release_modal
- shown_status
- about_to_show
- instant_trigger
- post_fill_nav
- hide_mode
- promptly_submit
Modal Lower Macro
modal_lower_half(modalid, class="success", head_bg=false, hidden=false,
ok_btn="OK", hide_ok=false, addi_btns=[],
close_btn="Close", hide_cancel=false)
Parameters | DO NOT rely on argument order farther than modalid and type, ALWAYS PROVIDE argument keywords.
|