Link

Here are some links. Typically links are used in user interfaces to trigger navigation to related content inside or outside of the current application.

Z2UI5_CL_SMPC_APP_160

Controls sap.m UI5 1.128

The facts

Repository: abap2UI5/samples-controls
Class: Z2UI5_CL_SMPC_APP_160
Source file: z2ui5_cl_smpc_app_160.clas.abap ↗
Library: sap.m
UI5 entity: sap.m.Link
Demo kit sample: sap.m.sample.Link
SAP's own sample: running at sdk.openui5.org ↗
Minimum UI5: 1.128
In the playground: runs in the browser, with no system and nothing installed

Keywords: link, sap.m, variants, verticallayout, label

Controls it builds

Read out of the builder chain by the abap2UI5 linter, not from the category this sample is filed under — which is what makes “which samples build one of these” a question the catalogue can answer at all.

Libraries

Run it here

The sample running, in this page — the app on its own, with no editor over it. Switch to Playground with this code

Nothing is installed and nothing is sent anywhere: the ABAP is compiled to JavaScript in this browser and runs against abap2UI5 itself.

The ABAP

z2ui5_cl_smpc_app_160.clas.abap — 102 lines Read it on GitHub ↗

" @keywords link sap.m variants verticallayout label
" @summary Here are some links. Typically links are used in user interfaces to trigger navigation to related content inside or outside of the current application.
CLASS z2ui5_cl_smpc_app_160 DEFINITION PUBLIC.

  PUBLIC SECTION.
    INTERFACES z2ui5_if_app.

  PROTECTED SECTION.
    DATA client TYPE REF TO z2ui5_if_client.

    METHODS view_display.
    METHODS on_event.

  PRIVATE SECTION.
ENDCLASS.


CLASS z2ui5_cl_smpc_app_160 IMPLEMENTATION.

  METHOD z2ui5_if_app~main.

    me->client = client.
    IF client->check_on_navigated( ).
      view_display( ).
    ELSEIF client->check_on_event( ).
      on_event( ).
    ENDIF.

  ENDMETHOD.


  METHOD view_display.

    DATA(view) = z2ui5_cl_ui5_view_builder=>factory( ).

    " handleLinkPress opens MessageBox.alert('Link was clicked!'); the framework
    " expresses that 1:1 (client->message_box_display), so both wired Links go
    " through a backend event rather than being reduced to a toast
    view->ele( n = `View` ns = `mvc`
        )->a( n = `xmlns:l`   v = `sap.ui.layout`
        )->a( n = `xmlns:mvc` v = `sap.ui.core.mvc`
        )->a( n = `xmlns`     v = `sap.m`

        )->ele( n = `VerticalLayout` ns = `l`
            )->a( n = `class` v = `sapUiContentPadding`
            )->a( n = `width` v = `100%`

            )->ele( n = `content` ns = `l`
                )->tag( `Link`
                    )->a( n = `text`  v = `Open message box`
                    )->a( n = `press` v = client->_event( `LINK_PRESSED` )
                )->tag( `Link`
                    )->a( n = `text`    v = `Disabled link`
                    )->a( n = `enabled` v = `false`
                )->tag( `Link`
                    )->a( n = `text`   v = `Open SAP Homepage`
                    )->a( n = `target` v = `_blank`
                    )->a( n = `href`   v = `http://www.sap.com`

            )->end(
        )->end(

        )->ele( n = `VerticalLayout` ns = `l`
            )->a( n = `class` v = `sapUiContentPadding`
            )->a( n = `width` v = `100%`

            )->ele( n = `content` ns = `l`
                )->tag( `Label`
                    )->a( n = `text`     v = `Links with Icons`
                    )->a( n = `design`   v = `Bold`
                    )->a( n = `wrapping` v = `true`
                    )->a( n = `class`    v = `sapUiSmallMarginTop`
                )->tag( `Link`
                    )->a( n = `text`    v = `Show more information`
                    " endIcon is @since 1.128 - kept 1:1 (POST_171)
                    )->a( n = `endIcon` v = `sap-icon://inspect`
                    )->a( n = `press`   v = client->_event( `LINK_PRESSED` )
                )->tag( `Link`
                    )->a( n = `text`    v = `Disabled link with icon`
                    " icon is @since 1.128 - kept 1:1 (POST_171)
                    )->a( n = `icon`    v = `sap-icon://cart`
                    )->a( n = `enabled` v = `false`
                )->tag( `Link`
                    )->a( n = `text` v = `Open SAP Homepage`
                    )->a( n = `icon` v = `sap-icon://globe`
                    )->a( n = `href` v = `http://www.sap.com` ).

    client->view_display( view->stringify( ) ).

  ENDMETHOD.


  METHOD on_event.

    IF client->get_event( ) = `LINK_PRESSED`.
      " MessageBox.alert( ) - type 'alert' with the original's text, verbatim
      client->message_box_display( text = `Link was clicked!` type = `alert` ).
    ENDIF.

  ENDMETHOD.

ENDCLASS.