# Triggers, Events & Actions

## Triggers 

Not yet implement, considering;

sa-trigger-video-play 

sa-trigger-video-pause 

sa-trigger-video-seek 

sa-trigger-video-position 

sa-trigger-video-position:pos 

## Actions

### sa-action-video-play = ( *event name* ) 

Play the video.

### sa-action-video-pause = ( *event name* ) 

Pause the video. 

### sa-action-video-seek = ( *event name* ) 

Seek the video, to a specified position. 

#### sa-action-video-seek:pos = ( *position* ) 

* Unsigned integers indicates a position in seconds, from the start of the video 
* `+` Integers indicate a number seconds to advance 
* `-` Integers indicate a number seconds to rewind 
* Unsigned percentages indicate a position in % of total playtime, from the start of the video 
* `+` Percentages indicate a % of the total playtime to advance 
* `-` Percentages indicate a % of the total playtime to rewind 

{% hint style="info" %}
This attribute can be placed either on the video element, or on the triggering element.  

* Place it on the video element if the seek position will always be the same when you invoke this Action. 
* Place it on the triggering element if the seek position can vary depending on the Trigger. 
  {% endhint %}

Examples; 

<table><thead><tr><th width="140.33331298828125">Seek value</th><th>Behavior</th><th>Notes</th></tr></thead><tbody><tr><td><code>10</code> </td><td>Seek to 10 seconds from the beginning of the video</td><td>If the position given is > the video duration, will seek to end</td></tr><tr><td><code>+10</code> </td><td>Seek +10 seconds</td><td>Will stop if the end of the video is hit</td></tr><tr><td><code>-20</code> </td><td>Seek -20 seconds</td><td>Will stop if the start of the video is hit</td></tr><tr><td><code>10%</code> </td><td>Seek to 10% from the beginning of the video</td><td>If the position given is > the video duration, will seek to end</td></tr><tr><td><code>+20%</code> </td><td>Seek forward 20% of the video duration </td><td>Will stop if the end of the video is hit</td></tr><tr><td><code>-50%</code> </td><td>Seek back 50%</td><td>If the position given is > the video duration, will seek to end</td></tr></tbody></table>

<https://www.npmjs.com/package/player.js>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://attr.sygnal.com/sa5-video/triggers-events-and-actions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.