9.5.1 Anchor (std_anchor and std_anchor_s1)
The anchor weblet provides a hyperlink (or anchor) control. It broadly corresponds to the <a> (anchor) HTML element that designates the destination of a hypertext link. Weblet std_anchor has the same properties as std_anchor_s1, but with the difference that you can add content to the anchor element.
The anchor always generates a GET HTTP request and does not submit any form fields unless explicitly specified in the onclickExtraFields property. So the anchor should only be used for linking to external sites, static pages or webroutines that perform queries. When performing transactions that create or update data you should use a submit button.
HTML 5 form validation is not performed on fields sent with an anchor click. If you need validation, use a submit button.
- In its simplest form the anchor weblet can display a text value that, when tapped will navigate the browser to a new page.
- The anchor weblet can be configured to display as a button, or it can contain any arbritary HTML (including other weblets).
- The destination can be a url (such as http:://www.yourcompany.com/) or you can specify a WAM and webroutine to be executed and optionally identify fields whose values should be passed to the webroutine.