| rev | 
   line source | 
| 
jbe/bsw@0
 | 
     1 --[[--
 | 
| 
jbe/bsw@0
 | 
     2 ui.link{
 | 
| 
jbe/bsw@0
 | 
     3   external  = external,   -- external URL
 | 
| 
jbe/bsw@0
 | 
     4   static    = static,     -- URL relative to the static file directory
 | 
| 
jbe/bsw@0
 | 
     5   module    = module,     -- module name
 | 
| 
jbe/bsw@0
 | 
     6   view      = view,       -- view name
 | 
| 
jbe/bsw@0
 | 
     7   action    = action,     -- action name
 | 
| 
jbe/bsw@0
 | 
     8   id        = id,         -- optional id to be passed to the view or action to select a particular data record
 | 
| 
jbe/bsw@0
 | 
     9   params    = params,     -- optional parameters to be passed to the view or action
 | 
| 
jbe/bsw@0
 | 
    10   routing   = routing,    -- optional routing information for action links, as described for ui.form{...}
 | 
| 
jbe/bsw@0
 | 
    11   text      = text,       -- link text
 | 
| 
jbe/bsw@11
 | 
    12   content   = content,    -- link content (overrides link text, except for submit buttons for action calls without JavaScript)
 | 
| 
jbe@12
 | 
    13   partial   = {           -- parameters for partial loading, see below
 | 
| 
jbe/bsw@11
 | 
    14     module = module,
 | 
| 
jbe/bsw@11
 | 
    15     view   = view,
 | 
| 
jbe/bsw@11
 | 
    16     id     = id,
 | 
| 
jbe@12
 | 
    17     params = params,
 | 
| 
jbe@12
 | 
    18     target = target
 | 
| 
jbe/bsw@11
 | 
    19   }
 | 
| 
jbe/bsw@0
 | 
    20 }
 | 
| 
jbe/bsw@0
 | 
    21 
 | 
| 
jbe/bsw@0
 | 
    22 This function inserts a link into the active slot. It may be either an internal application link ('module' given and 'view' or 'action' given), or a link to an external web page ('external' given), or a link to a file in the static file directory of the application ('static' given).
 | 
| 
jbe/bsw@0
 | 
    23 
 | 
| 
jbe@12
 | 
    24 When passing a table as "partial" argument, AND if partial loading has been enabled by calling ui.enable_partial_loading(), then ui._partial_load_js is
 | 
| 
jbe@12
 | 
    25 used to create an onclick event (onsubmit event for action links). The
 | 
| 
jbe@12
 | 
    26 "partial" setting table is passed to ui._partial_load_js as first argument.
 | 
| 
jbe@12
 | 
    27 See ui._partial_load_js(...) for further documentation.
 | 
| 
jbe@12
 | 
    28 
 | 
| 
jbe/bsw@0
 | 
    29 --]]--
 | 
| 
jbe/bsw@0
 | 
    30 
 | 
| 
jbe/bsw@0
 | 
    31 function ui.link(args)
 | 
| 
jbe/bsw@0
 | 
    32   local args = args or {}
 | 
| 
jbe/bsw@4
 | 
    33   local content = args.content or args.text
 | 
| 
jbe/bsw@0
 | 
    34   assert(content, "ui.link{...} needs a text.")
 | 
| 
jbe/bsw@0
 | 
    35   local function wrapped_content()
 | 
| 
jbe/bsw@11
 | 
    36     if args.image then
 | 
| 
jbe/bsw@11
 | 
    37       ui.image(args.image)
 | 
| 
jbe/bsw@11
 | 
    38     end
 | 
| 
jbe/bsw@0
 | 
    39     if type(content) == "function" then
 | 
| 
jbe/bsw@0
 | 
    40       content()
 | 
| 
jbe/bsw@0
 | 
    41     else
 | 
| 
jbe/bsw@0
 | 
    42       slot.put(encode.html(content))
 | 
| 
jbe/bsw@0
 | 
    43     end
 | 
| 
jbe/bsw@0
 | 
    44   end
 | 
| 
jbe/bsw@0
 | 
    45   if args.action then
 | 
| 
jbe/bsw@0
 | 
    46     local form_attr   = table.new(args.form_attr)
 | 
| 
jbe/bsw@0
 | 
    47     local form_id
 | 
| 
jbe/bsw@0
 | 
    48     if form_attr.id then
 | 
| 
jbe/bsw@0
 | 
    49       form_id = form_attr.id
 | 
| 
jbe/bsw@0
 | 
    50     else
 | 
| 
jbe/bsw@0
 | 
    51       form_id = ui.create_unique_id()
 | 
| 
jbe/bsw@0
 | 
    52     end
 | 
| 
jbe/bsw@0
 | 
    53     local quoted_form_id = encode.json(form_id)
 | 
| 
jbe/bsw@0
 | 
    54     form_attr.id      = form_id
 | 
| 
jbe/bsw@0
 | 
    55     local a_attr      = table.new(args.attr)
 | 
| 
jbe/bsw@0
 | 
    56     a_attr.href       = "#"
 | 
| 
jbe/bsw@0
 | 
    57     a_attr.onclick    =
 | 
| 
jbe/bsw@0
 | 
    58       "var f = document.getElementById(" .. quoted_form_id .. "); if (! f.onsubmit || f.onsubmit() != false) { f.submit() };"
 | 
| 
jbe/bsw@0
 | 
    59     ui.form{
 | 
| 
jbe/bsw@0
 | 
    60       external = args.external,
 | 
| 
jbe/bsw@0
 | 
    61       module   = args.module or request.get_module(),
 | 
| 
jbe/bsw@0
 | 
    62       action   = args.action,
 | 
| 
jbe/bsw@0
 | 
    63       id       = args.id,
 | 
| 
jbe/bsw@0
 | 
    64       params   = args.params,
 | 
| 
jbe/bsw@0
 | 
    65       routing  = args.routing,
 | 
| 
jbe/bsw@11
 | 
    66       partial  = args.partial,
 | 
| 
jbe/bsw@0
 | 
    67       attr     = form_attr,
 | 
| 
jbe/bsw@0
 | 
    68       content  = function()
 | 
| 
jbe/bsw@0
 | 
    69         ui.submit{ text = args.text, attr = args.submit_attr }
 | 
| 
jbe/bsw@0
 | 
    70       end
 | 
| 
jbe/bsw@0
 | 
    71     }
 | 
| 
jbe/bsw@0
 | 
    72     ui.script{
 | 
| 
jbe/bsw@0
 | 
    73       type = "text/javascript",
 | 
| 
jbe/bsw@0
 | 
    74       script = (
 | 
| 
jbe/bsw@0
 | 
    75         "document.getElementById(" ..
 | 
| 
jbe/bsw@0
 | 
    76         quoted_form_id ..
 | 
| 
jbe/bsw@0
 | 
    77         ").style.display = 'none'; document.write(" ..
 | 
| 
jbe/bsw@0
 | 
    78         encode.json(
 | 
| 
jbe/bsw@0
 | 
    79           slot.use_temporary(
 | 
| 
jbe/bsw@0
 | 
    80             function()
 | 
| 
jbe/bsw@0
 | 
    81               ui.tag{
 | 
| 
jbe/bsw@0
 | 
    82                 tag     = "a",
 | 
| 
jbe/bsw@0
 | 
    83                 attr    = a_attr,
 | 
| 
jbe/bsw@0
 | 
    84                 content = wrapped_content
 | 
| 
jbe/bsw@0
 | 
    85               }
 | 
| 
jbe/bsw@0
 | 
    86             end
 | 
| 
jbe/bsw@0
 | 
    87           )
 | 
| 
jbe/bsw@0
 | 
    88         ) ..
 | 
| 
jbe/bsw@0
 | 
    89         ");"
 | 
| 
jbe/bsw@0
 | 
    90       )
 | 
| 
jbe/bsw@0
 | 
    91     }
 | 
| 
jbe/bsw@0
 | 
    92   else
 | 
| 
jbe/bsw@0
 | 
    93     -- TODO: support content function
 | 
| 
jbe/bsw@0
 | 
    94     local a_attr = table.new(args.attr)
 | 
| 
jbe/bsw@0
 | 
    95     a_attr.href = encode.url{
 | 
| 
jbe/bsw@0
 | 
    96       external  = args.external,
 | 
| 
jbe/bsw@0
 | 
    97       static    = args.static,
 | 
| 
jbe/bsw@0
 | 
    98       module    = args.module or request.get_module(),
 | 
| 
jbe/bsw@0
 | 
    99       view      = args.view,
 | 
| 
jbe/bsw@0
 | 
   100       id        = args.id,
 | 
| 
jbe/bsw@0
 | 
   101       params    = args.params,
 | 
| 
jbe/bsw@0
 | 
   102     }
 | 
| 
jbe/bsw@11
 | 
   103     if ui.is_partial_loading_enabled() and args.partial then
 | 
| 
jbe/bsw@11
 | 
   104       a_attr.onclick = ui._partial_load_js(args.partial)
 | 
| 
jbe/bsw@11
 | 
   105     end
 | 
| 
jbe/bsw@0
 | 
   106     return ui.tag{ tag  = "a", attr = a_attr, content = wrapped_content }
 | 
| 
jbe/bsw@0
 | 
   107   end
 | 
| 
jbe/bsw@0
 | 
   108 end
 |