@@1-line description

(formerly coga-importance).

Having the following values: (main task such as send for an email)

I can't figure out from the description here what the intended list of properties are.

• coga-simplification="simplest". This setting should be used on:
  • Elements that are essential for the key function (from the user perspective) of the page (Example: The send button for an email draft) or
  • Elements that are sometimes critical to a user being able to use the site, such as "save my work" or "emergency instructions" or
  • Elements that are used by over 90% of a user group (such as parents or teachers) use this element most times they use the content
    

Typically 3 links or buttons would be considered "simplest"

• coga-simplification="high". This setting should be used on:
  • Elements that are used frequent (Example: The delete button for an email draft) or
  • Elements that are sometimes important to a user being able to use the site, such as settings or
  • Elements that are used by frequently (over 60%) by a user group (such as parents or teachers) use this element most times they use the content
• coga-simplification= "med". This is the default value.
• coga-simplification="low". This setting should be used on elements that are rarely used or only used by advanced users. (Example: The terms and services or the archive button for an email draft)

The action attribute provides the context of a button. It is typically be used on a button element or element with role="button".

For example: <button coga-action="undo" >default</button>

The user experience may be simply replacing the text for the term "undo". Note that there is no default value.

Supported Values:

The following could be supported values of coga-action for buttons:

compose

compose new item such as an email. (Default importance = "critical".)

next

move to the next item in the series. (Default importance = "critical".)

delete

delete current item, selected control or text

previous

move to the previous item in the series. (Default importance = "critical".)

toc

opens a table of content

submit

submits the form data or request to the server. (Default importance = "critical".)

undo

revert to the state before the user's most recent changes

cancel

closes the dialog and discards any changes the user may have made within that dialog. (Default importance = "critical".)

reset

resets all the controls to their initial values

label

add label to the selected item or the item at the current location.

buy

buy the selected item or buy the item at the current location. Often involves adding the current item into a shopping cart. (Default importance = "critical".)

add

add the selected item or the item at the current location to a list

move

move the selected item

save

save the current content. (Default importance = "critical".)

send

send a form, email or request. (Default importance = "critical".)

close

close current dialog. (Default importance = "critical".)

more

show more information

print

print current page, selection or the item at the current location

received

open received folder

sent

open sent folder

edit

edit current item, selection or the item at the current location

forward

forward to current item such as an email

reply

reply to current item such as an email. (Default importance = "critical".)

upload

upload file to the server

open

open item. (Default importance = "critical".)

new

open new item. (Default importance = "critical".)

settings

open settings and options

mode

change the mode or functionality. (Default importance = "critical".)

higher

increases the level of the relevant setting. (Default importance = "critical".)

lower

increases the level of the relevant setting. (Default importance = "critical".)

my profile

opens the user’s profile page

expand

expand or unexpand the current item

refresh

manually refresh the current contents of the screen

properties

shows the properties of the item

help

opens a help function. (Default importance = "critical".)

cut

removes the selected control, item or text and places it on the Clipboard

copy

copies the selected control, item or text onto the Clipboard

color

opens a color picker

date

opens a date control. (Default importance = "critical".)

remove

remove an item from a list

right

moves a selected item to the right to another column or list

left

moves a selected item to the left to another column or list

The destination attribute provides the context of a link. It should be used on a link element or element with role="link".

For example: <a href="home.html" coga-destination="home" >our main page</a>

The user experience may be simply replacing the text for the term "home" and adding an icon. Based on personalization setting the user can see different icons. A sample user experience is available at https://rawgit.com/ayelet-seeman/coga.personalisation/demo/conactUs.html

It may also position this button to a location on the screen where the user is expecting the home page link. Note that there is no default value.

Supported Values:

The following could be supported values of coga-destination.

home

initial or main page of a website or application

contact us

opes contact information for content owner or producer

our phone

phone content owner or producer

our email

email content owner or producer

site map

content containing a list of pages in a web site

help

a help function, support or instructions

chat help

Human help or a dialog help function such as a chat bot

about us

information about the content owner or producer

terms

terms and conditions

tools

available tools for the current content

services

services available from the content provider

products

products available from the content provider

comment

submit a comment on the current item

language

language options

sign in

sign in to current web site or application

sign out

sign out current web site or application

sign up

register for the current web site or application

social

content provider on social media

post

post current item. Item will be visible to other parties.

field provides the context of a text input field such as a text box. It is typically used on an input of type text, or element with a responding role.

For example: <input type="text" name="fname" coga-field="phone"/>

The user experience may include filling in the field and adding an icon.

coga-field values that would typically be on form controls and would have a user context - for example phone would relate to the user's phone. Note that there is no default value.

Note they can be concatenated such as coga-field="birthdate month"

name

full name

honorific-prefix

prefix or title (Mr., Mrs. Dr., etc.)

given-name

given or first name

additional-name

additional or middle name

additional-name-initial

additional or middle name initial

family-name

family name, surname, or last name

honorific-suffix

suffix (Jr., II, etc.)

nickname

nickname

street-address

full street address condensed into one line

address-line1

first line of street address

address-line2

second line of street address

address-line3

third line of street address

city or locality

locality or city

area

administrative area, state, province, or region

postal-code

postal or ZIP code

country

country name

email

email address

tel

full phone number, including country code

tel-country-code

international country code

tel-national

national phone number: full number minus country code

tel-area-code

area code

tel-local

local phone number: full number minus country and area codes

tel-extension

phone extension number

fax

full fax number, including country code

fax-country-code

international country code

fax-national

national fax number: full number minus country code

fax-area-code

area code

fax-local

local fax number: full number minus country and area codes

fax-extension

fax extension number

cc-name

full name, as it appears on credit card

cc-number

credit card number

cc-exp-month

month of expiration of credit card

cc-exp-year

year of expiration of credit card

cc-exp

date of expiration of credit card

cc-csc

credit card security code

language

preferred language

bday

birthday

bday-year

year of birthday

bday-month

month of birthday

bday-day

day of birthday

topic

Topic for the form. Typically selected from a list of reserved words

comment

comment section. Typically a free text field

subject

form subject. Typically a free text field

answer

answer to a section question

org

company or organization

organization-title

user's position or title within company or organization

sex

sex or gender

gender

gender identity

url

Website URL

photo

photo or avatar

section-*****

used to group forms together

coga-field can also give the context for text elements.

coga-field values on text are:

our-tel

full phone number, including country code of the website owner

our-tel-country-code

international country code of the website owner

our-tel-national

national phone number of the website owner: full number minus country code

our-tel-area-code

area code of the website owner

our-tel-local

local phone number of the website owner: full number minus country and area codes

our-email

email address of the website owner

our-street-address

full street address condensed of the website owner

Coga-context would let the author give additional contextual information about the content.

Coga-context accepts the values of a URI or shortened URI. Note that there is no default value.

<a href="women.html" coga-context="openref:gender#femail">women</a> 

To make this work without an RDF parser we recommend maintaining a list of recommended ontologies.

@@1-line description

Supported Values: URL

Note that there is no default value.

Examples:

<img coga-concept="http//wordnet.com/node/girl" href="mygirlsy.bmp/> 

@@1-line description

Supported value : String

Note that there is no default value.

For example:

<span coga-numberfree="almost all">9 out of 10 </span>
			

<span coga-numberfree="hat and coat weather">The weather is 9 degrees</span>
			

@@1-line description

Supported value: String

Note that there is no default value.

Examples:

<span coga-literal="it is raining hard"> It is raining cats and dogs </span>

User agents can render non-literal text in a different way so that users will know that this is non literal. They can then use a mouse over or other technique to receive the translation.

This attribute provides immediate feedback that can be shown or spoken when any event is triggered on a control.

User experience: This can be rendered as text at the top of the page and read immediately. Most users will not want this text rendered and spoken. Other users however will need it to know what has just happened.

This attribute provides any information that helps the user anticipate the functionality, such as letting the user know what behavior will trigger an event. This is most important if the mechanism is not standard.

User experience: This help can be rendered as a tool tip, help link or read when the control or link is read. Most users will not want this text rendered or spoken, but other users however will need it to understand the behavior of the element.

Note that there is no default value.

Examples:

coga-explain="press enter to send the email" 

coga-feedback="your email on birthdays was sent" 

These values will change when the email is sent.

@@1-line description

Supported values: URI

Note that there is no default value.

@@1-line description

Supported values: URI

Note that there is no default value.

@@1-line description

Example:

<button type="button" coga-extrahelp="uri2 uri3" >undo</button>

URI 2 may read:

<div id="uri2" 
    coga-helptype="morehelp" 
    coga-hidden="true">
  pressing the undo button will erase all your work on this page. 
  Use this button with care. 
  If you press it by mistake, press control and y at the same time 
  and your answers will come back. 
</div>

<a href="functiongethelp()" 
    coga-helptype="humanhelp" 
    coga-hidden="true">
  I want a person to help me
</a>
<div id="uri3" 
    coga-extrahelp="glossary" 
    coga-hidden="true">

Would be used on an alternative content as an alternative to more detailed or difficult to understand content. coga-alternative can be used on a span, div, link or image that servers as alternative content to it's direct parent element.

This data model may be too complex, so this property could undergo substantial changes.

Supported values:

• On text: easylang, explain, more, vocab500, vocab1000, vocab2000, active, literal, numberfree, smallsentences, chunks
• General: lessoptions. Whitespace, largefont 
• Images: symbolic , realistic
• p0, p1, p1, p2, p3 Where p0 are images with true content, p1 is a symbol or illustration that is typically shown with alt="", P2 are extra illustration that most people will not mind such as at the start of a paragraph or option. p3 are for disability centric illustrations that can disturb other people and may be mid sentence. 

Note that there is no default value.

Example:

<div>
  <span coga-alternative="easylang numberfree vocab1000" class="hidden">>
    most people prefer simple text
  </span>
  In studies it was found that only 30% of users prefer long convoluted text 
  with obtuse words and lots of numbers, 
  with 56% claiming there preferred the simplified text , 
  with the remainder unsure or stated it depends on the context.
</div>

coga-easylang will contain a version of the content that is easier to read and understand. Note that this only works on small sections of text as the easylang attribute does not support full HTML, such as lists and sections.

Supported values: String

<span coga-easylang="some text that is easy to read"> some convoluted obtuse text</span>

Where coga-easylang should use as simple well-known words as possible, and active voicing, literal text, small simple sentences. Acronyms and abbreviations should be avoided, unless they are the common way to refer to an item.

Contains a label or name for the log that reflects the process or task purpose.

Contains the number of the step in the process or task.

This can sometimes be implied via the DOM.

Contains a summary of key actions taken during a step of a process.

Contains a link to the location of the step for editing and review. The referenced location should support editing.

An embedded link inside a step can serve the same function as coga-steplocation.

Describe whether a step in a process is done, pending, current, or not done.

Need a better token for "not done", or is that value actually needed given the presence of prending and current?

Not clear how the true and false values below relate to the done/pending/current/not-done values above.

When actiontaken is not null it implies that coga-status is true.

When actiontaken is null it implies that coga-status is false.

@@1-line description

Example:

<div role="alert" 
    coga-messageimportance="medium">
  It is your daughter's birthday tomorrow
</div>

@@1-line description

Supported values: a string value that identifies the sender of the message. If multiple names are used they can be separated by a coma.

Note that there is no default value.

Example:

<div role="alert" 
    coga-messageimportance="low" 
    coga-messagefrom="lisa seeman, lseeman">
  I posted a new version on GitHub for you to review
</div>

@@1-line description

Supported values: a string value that identifies the location that makes this message relevant. Typical values are "home" and "work". If multiple locations are relevant they can be separated by a coma.

Note that there is no default value.

Example:

<div role="alert"
   coga-messageimportance="low" 
   coga-messagefrom="lisa seeman, lseeman" 
   coga-messagecontext="work">
  I posted a new version on GitHub for you to review
</div>

@@1-line description

Supported values: 24 hour date time format. DD.MM.YEAR.HOUR.MM - DD.MM.YEAR.HOUR.MM where the second date is an optional exclusive expiry date.

Note that there is no default value.

Example:

<div role="alert" 
    coga-messageimportance="medium" 
    coga-messagefrom="my calender" 
    coga-messagecontext="work" 
    coga-messagetime="10.02.2017.00.00-16.02.2017.00.00">
  Renew your driving license this week
</div>

<div role="alert" 
    coga-messageimportance="critical" 
    coga-messagefrom="my calender" 
    coga-messagecontext="work" 
    coga-messagetime="16.02.2017.00.00">
  Renew your driving license ASAP
</div>

This attribute should be used on non essential, detracting content, so that people who have problems keeping focus can turn them off. An example user experiences would be to hide all distraction content.

Example:

coga-distraction="moving ad"

Supported values: animations, auto-starting, moving, ad, message, chat , overlay, popup
Auto-changing (logs) third-party, offer ( includes suggestions).

Note that there is no default value.

Note that elements with the coga-distraction attribute should also have a label or accessible name.