Web-components available in Markdown Free Text
Last updated
Last updated
This document describes the web components that can be used in the free text field of AccessibleSurveys.com.
Web component tag MUST be closed:
This will work:
This will not work:
An element for displaying tooltip. Tooltip provide additional content when focused or hovered.
Example
Produces:
When a user over the tooltip with or activate it :
Properties
container
container
object
the container
used to decide how to position tooltip before opening.
fireonclick
fireonclick
boolean
When true, activate tooltip on click event (and not just on hover)
heading
heading
string
Tooltip title.
message
message
string
message appearing when tooltip is active
noIcon
noIcon
boolean
false
Do not display the info
icon top right of tooltip when true
opened
boolean
false
position
position
string
Placement of the tooltip. Note that the actual placement may vary as needed to keep the tooltip inside of the viewport {'top'
skipFocus
skipFocus
boolean
tooltip is not activatable by tap if true. To use for instance when sloted element is a button (which will receive focus)
tipwidth
tipwidth
string
200
Wdth of the tooltip - overrides css properties.
Tooltips to be user in forms. It allows to display glossary definition for complex terms used in the form.
Usually, only term
property should be used:
Produces:
appName
app-name
string
appName
container
container
object
the container
used to decide how to position tooltip before opening.
fireonclick
fireonclick
boolean
When true, activate tooltip on click event (and not just on hover)
heading
heading
string
Tooltip title.
loadingMessage
loadingMessage
string
"loading remote tooltip ..."
loadingMessage
message appearing before
remote content was loaded
message
message
string
message appearing when tooltip is active
noIcon
noIcon
boolean
false
Do not display the info
icon top right of tooltip when true
opened
boolean
false
path
path
string
path
database path
position
position
string
Placement of the tooltip. Note that the actual placement may vary as needed to keep the tooltip inside of the viewport {'top'
resource
resource
object
resource
the resource object to get
context from. It can be a form or a section.
For editor shall not set this propery as it is handled by the application.
skipFocus
skipFocus
boolean
true
tooltip is not actiabtable by tap if true. To use for instance when sloted element is a button (which will receive focus)
term
term
string
term
the term id to get tooltip for
tipwidth
tipwidth
string
200
Wdth of the tooltip - overrides css properties.
<pfo-survey-guidance>
An element displaying Guidance on how to use iData and how to till out forms.
Guidance appear in the active application language.
will display iData Form guidance.
An element displaying a video on on how to use iData and how to till out forms.
The video adapts to active language
will display iData Form guidance.
Produces:
<lapp-youtube>
or <lite-youtube>
Prefer using lapp-youtube
over lite-youtube
as default parameters are added for you.
videoid
The YouTube videoid
``
playlabel
label for the play button
Play
params
Set YouTube query parameters
``
Or, using the lite-youtube
element:
A menu for accessibility settings. It allows to activate, deactivate or change settings for application theme and contrast, text size, easyread or simplified interface.
In context of forms or survey, it also display readaloud and Internation Sign settings.
produces:
context
context
string
used to show or hide specific accessibility items depending on application context.
For instance, readaloud
. international sign
are visible only when context = survey
.
A Button opening the application's accessibility menu.
It renders with open accessibility settings
label and an accessibility Icon
<a11y-dialog-button outlined></a11y-dialog-button>
Produces:
outlined
outlined
boolean
Creates an outlined button that is flush with the surface.
unelevated
unelevated
boolean
Creates a contained button that is flush with the surface.
a11y-dialog-button
was previously pfo-accessibility-settings
, which is now deprecated
Individual controls exists for each accessibility settings. We recommend the use of <a11y-menu context=form></a11y-menu>
in forms as it is more compact.
However there are cases where it makes sense to introduce each accessibility controls individually.
<a11y-easyread></a11y-easyread>
On/Off easyread accessibility settings
<a11y-readaloud></a11y-readaloud>
On/Off readaloud accessibility settings
<a11y-signlanguage></a11y-signlanguage>
On/Off International Sign (IS) accessibility mode
<a11y-theme></a11y-theme>
Display a list of available themes
<a11y-font></a11y-font>
set font size
It is sometime helpful to add icons directly in the text. are available through the following syntax:
The element for rendering youtube video is . We deploy an alternative version of this element called lapp-youtube
that adds default parameters for allowing to pause videos when necessary, and display videos from the same channel when the video is finished.
Use any you like. For lite-youtube
We recommend setting rel
to 0
as below to avoid showing unrelated video after the video was just played. Those parameters are added by default in lapp-youtube
.