getActivityTags - Methods - Author API

Author API Methods

getActivityTags()

Returns the current list of Tags associated with the Activity being edited.

You would want to use this method so that you can display the current Tags for the current Activity, for example.

Important This method can only be used when in the Activity editor view, when the mode initialization option is set to "activity_edit".

Examples

var tags = authorApp.getActivityTags();
console.log(tags);

/*
[
    { "type": "TYPE1", "name": "NAME1" },
    { "type": "TYPE1", "name": "NAME2" },
    { "type": "TYPE2", "name": "NAME1" },
    { "type": "TYPE2", "name": "NAME3" }
]
*/

Arguments

None.

Return value

Type array[tagsV2] | boolean

Returns an array containing all Tags for the current Activity.

Returns false if not in the Activity editor view.

Caveats

Any Tags hidden by the hide_tags initialization option are not returned by this method.

Type definitions

  • tagsV2 object

    Tags are used to improve searching for content while authoring and for reporting and analytics purposes.

    See Understanding Tag Formats for Content Creation and Filtering for more information.

    • name string

      The Tag name.

      Maximum length is 255 characters.

    • type string

      The Tag type.

      Maximum length is 255 characters.

Related articles

  • The setActivityTags() method, which allows you to apply Tags to the current Activity.
Was this article helpful?

Did you arrive here by accident? If so, learn more about Learnosity.