Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

...

High

...

level

...

requirement

...

User

...

should

...

be

...

able

...

to

...

rollover

...

tooltip

...

indicator

...

to

...

have

...

content

...

explain

...

requirements

...

of

...

the

...

input

...

field

...

it

...

is

...

displayed

...

in.

Details

The tooltip will be dynamically populated with content to be pulled via xml files that are configured by the documentation team. Special tags will be placed in the the documented xml files and pulled from the tooltip to display the information.

Technical details

Add a tooltip to form fields, which display relevant documentation for that field on focus of the input/select box.

Create a JSON 'lookup table' for the documentation, which is organized by a new field ID.

It is in a basic object map format:

No Format



h2. *Details*

The  tooltip will be dynamically populated with content to be pulled via xml  files that are configured by the documentation team. Special tags will  be placed in the the documented xml files and pulled from the tooltip to  display the information.

h1. Technical details

Add a tooltip to form fields, which display relevant documentation for that field on focus of the input/select box.\\

Create a JSON 'lookup table' for the documentation, which is organized by a new field ID.\\

It is in a basic object map format:\\

<pre>
cloudStack.docs = {

&nbsp;  <fieldID>: {

&nbsp;&nbsp;&nbsp;    desc: '<Content of the tooltip>'

&nbsp;  }

}\\
</pre>

The tooltips only support fields generated by the createForm (form

builder) widget. To show a tooltip for a field on focus, add a new option, 'docID' to the field object.\\

For example, for the 'name' field on the add volume form, the doc JSON looks like this:\\

The tooltips only support fields generated by the createForm (form

builder) widget. To show a tooltip for a field on focus, add a new option, 'docID' to the field object.

For example, for the 'name' field on the add volume form, the doc JSON looks like this:

No Format
cloudStack.docs = {

&nbsp;  // Add volume

&nbsp;  helpVolumeName: {

&nbsp;&nbsp;&nbsp;    desc: 'Give the volume a unique name so you can find it later.'

&nbsp;  },\\

&nbsp;
  ...

}\\

To

...

show

...

'helpVolumeName'

...

as

...

the

...

tooltip

...

for

...

the

...

name

...

field,

...

just

...

add

...

that

...

ID

...

in

...

the

...

docID

...

field:

No Format
\\

createForm: {

&nbsp;  title: 'label.add.volume',

&nbsp;  desc: 'message.add.volume',

&nbsp;  fields: {

&nbsp;  name: {

&nbsp;&nbsp;&nbsp;    label: 'label.name',

&nbsp;&nbsp;&nbsp;    docID: 'helpVolumeName',

&nbsp;&nbsp;&nbsp;    ...

&nbsp;  },

&nbsp;  ...

},\\

\

--Now

...

the

...

tooltip

...

content

...

will

...

show

...

up

...

when

...

the

...

name

...

text

...

input

...

has

  focus,

...

and

...

disappear

...

when

...

blurred.

...

*

...

*

...

Note

...

that

...

this

...

document

...

only

...

specifies

...

how

...

the

...

UI

...

reads

...

the

...

tooltip

...

data.

...

Because

...

the

...

documentation

...

is

...

originally

...

in

...

XML

...

format,

...

a

...

new

...

conversion

...

script

...

needs

...

to

...

be

...

integrated

...

into

...

the

...

build

...

system,

...

that

...

will

...

(re)generate

...

the

...

docs.js

...

file

...

from

...

the

...

relevant

...

XML

...

tags.