open_link()
  • 1 Minute to read

open_link()


Article summary

This function creates a component that is used to display iframe with title.

The open link component provides a window of an internet url(appears as it would on a search engine) by taking it as an argument. It provides a title to display information about the url. Users are able to interact with the url and view animations as they would be able to on a browser.

Reference

Screenshot 2023-06-20 at 3.44.44 PM.png

Explore more about this component here

Arguments

ArgumentsTypeDefault ValueDescription
urlAny (str)provided valid URL, usually in string format (mandatory)
titlestringTitle of the screen (mandatory)
title_sizeenumUI_TITLE_SIZE.MEDIUMSize of the title
show_back_buttonboolFalseShow a button to go back
back_button_textstring"Back"Text of the back button
button_sizeint1Button size (1 = SMALL, 2 = MEDIUM, 3 = LARGE)
languageslistNoneList of languages to be displayed on the screen (optional)
chosen_languagestrNoneIf list given, string representing chosen language
themeenumUI_THEME_TYPE.DARKEnum to define the theme of the screen, check UI_THEME_TYPE
custom_styledictNoneDictionary containing custom styles for the modal (optional)
waitboolTrueBool indicating to wait for user response (optional)
callbackcallableNoneCallable function to handle the response (optional)

See the complete list of general enumerations.

Return

Dictionary that contains the action performed by the user
Ex: {'action': 'back_pressed', 'app_id': 'doctest'}

Exception

  • RayaUIMissingValue
  • RayaNeedCallback

See the complete list of ui exceptions and the complete list of general exceptions.

Callback Arguments

callback

ArgumentTypeDescription
datadictDict containing the result of the action

Example

...


class RayaApplication(RayaApplicationBase):

    async def setup(self):
        self.UI = await self.enable_controller('ui')
        ....
        
    async def loop(self):
     ....
        await self.UI.open_link(
            title="Open Link title", 
            url = "https://www.unlimited-robotics.com/"
        )
      ...
      
    async def finish(self):
      ...

...

Was this article helpful?

What's Next