Provides spoken guidance during list navigation to indicate which page of items the user is currently on. Use Expression Language pagination functions to determine whether the user is on the first page or last page. You can use the size()
EL function to determine how many items are on the current page. You need to either define a spoken-summary
for the item Bixby is reading about or have a Value
dialog to default to for that item.
Note that you must bind a variable to the current page value with page-content
as shown in the example below.
page-content (page) {
underflow-statement {
macro (HANDS_FREE_OPTION_UNDERFLOW_STATEMENT)
}
item-selection-question {
if (exists(page) && isFirstNavPage(page) && isLastNavPage(page)) { // There is only one page
template ("")
}
else-if (exists(page) && !isLastNavPage(page)) {
macro (HANDS_FREE_OPTION_ITEM_SELECTION_MORE_PAGES)
}
else { // Last page
macro (HANDS_FREE_OPTION_ITEM_SELECTION_LAST_PAGES)
}
}
overflow-statement {
macro (HANDS_FREE_OPTION_OVERFLOW_STATEMENT)
}
overflow-question {
macro (HANDS_FREE_OPTION_OVERFLOW_QUESTION)
}
page-marker {
if (exists(page) && !isFirstNavPage(page) && isLastNavPage(page)) {
macro (HANDS_FREE_OPTION_LAST_OPTION) {
param (page) {
expression (page)
}
}
}
}
}
macro optional | Defines a layout, a portion of a layout, or a dialog with a macro |
template optional | Text to be passed |
template-macro optional | Encapsulates dialog logic that normally would lead to duplication |