Дії на сторінці: що помічник може на ній робити

Для розробників, у коді: що помічник може робити на сторінці, чого ніколи не робить сам, і три перемикачі, які цим керують.

З увімкненими діями на сторінці помічник може читати екран, на якому стоїть відвідувач, заповнювати форми й натискати кнопки — на сайті чи всередині додатка. Він працює із самої сторінки: підписи, ролі, ARIA-атрибути — те, що вже використовує програма озвучування. Розмітка необов’язкова і робить його кращим; щоб почати, вона не потрібна.

У панелі: Віджет → Дії на сторінці → Дозволити агенту діяти на сторінці (налаштування віджета).

Читати — не означає діяти

Віджет сканує сторінку в маніфест: кожен видимий елемент керування з його видом, назвою, заповненістю, недоступністю, належністю до набору. Саме це помічник читає, щоб відповісти «що це за поле?» чи «чому “Зберегти” сіра?». Заповнення чи натискання — це дія, і елемент може бути читабельним, але не доступним для дії.

Маніфест несе стан, а не вміст: filled — це так/ні. Те, що написано в полі, виходить із браузера лише під перемикачем власника page_read_values, а паролі, приховані поля, поля файлів і все позначене data-sa-private — ніколи. Читання екрана.

Що виконується одразу, а що притримується

Введення даних виконується одразу, скільки б не було полів: вписати в поле, обрати варіант, поставити галочку. Відвідувач бачить, як справжній текст лягає на його екран, і може скасувати перезавантаженням. Заповнення поля, де вже був текст, повідомляється як замінено; заповнення значенням, яке вже там було, — як без змін.
Наслідкове натискання притримується. «Надіслати», «Зберегти», «Замовити», «Видалити» — усе, чого не повернеш, — ніколи не натискається з ініціативи помічника. Коли воно йде в парі з введенням даних, помічник застосовує введення, потім питає, називаючи кнопку, і натискає лише на «так».
Натискання, що змінює лише вигляд, виконується одразу: вкладка, сегмент перемикача, ARIA option чи radio, розкривач (aria-expanded). Вони змінюють те, що редагується, а не світ. Згода і збереження.
Натискання як окрема команда виконується одразу. «Надішли» — це відвідувач натискає кнопку через помічника.

Три перемикачі

Усі три належать власнику й лежать на вкладці Дії на сторінці віджета в панелі; жоден не задається зі сторінки.

Перемикач	Значення	Сенс
Дозволити агенту діяти на сторінці	так / ні	сама функція; ні = помічник відповідає й веде, але нічого не торкається
Натискання кнопок (`page_actions_submit_policy`)	`off` / `confirm` / `auto`	Лише заповнення (без натискань) · Натискання з підтвердженням: притримати парне натискання і спитати (за замовчуванням) · Зберігати автоматично: після вдалого введення натиснути позначену кнопку збереження без питань
Чи бачить асистент вміст полів (`page_read_values`)	`off` / `marked` / `all`	Ніколи — лише чи заповнене (за замовчуванням) · Лише поля з data-sa-read · Усі поля на сторінці

Сторінка може вимкнути дії на одне завантаження через Shukai.setPageActions(false) — це не зберігається і не може увімкнути те, що власник вимкнув. JavaScript API.

Дії на сторінці входять у тариф Growth і вищі. На тарифі без них помічник не пропонує діяти на сторінці, а віджет приходить із вимкненими діями.

Що помічник уміє, одним списком

Операція	На чому	Примітки
`fill`	текстові поля, textarea, повзунки (число), комбобокси	замінює значення; повідомляється замінено / без змін
`append`	текстові поля, textarea	дописує в кінець у браузері — наявний текст не покидає сторінку, тож працює й із вимкненим читанням; на випадному списку відхиляється
`select`	рідний `<select>`, ARIA-комбобокси	знаходить варіант за видимим підписом — точно, потім за входженням
`check`	галочки, радіокнопки, ARIA `checked`	ставить галочку; на перемикачі, що сам зберігається і позначений `data-sa-commit`, вважається натисканням
`click`	кнопки, посилання, вкладки, варіанти, розкривачі	притримується, якщо наслідкове; одразу, якщо це вибір
прокрутити до місця	заголовки, секції, названі landmarks	«покажи, де це» — працює навіть із вимкненими діями
прокрутити сторінку	документ або оголошений контейнер	«гортай далі» — по екрану за раз

Три правила, яких не видно в DOM

Ідентифікатори стабільні. Елемент без data-sa-id отримує згенерований ідентифікатор, який запам’ятовується за елементом, тож вставлений вище рядок не перенумеровує його.
Невидимих елементів на екрані немає. Усе приховане CSS пропускається — сторінка, що малює той самий перемикач для десктопа і для телефона, пропонує лише видимий.
Сторінка йде за дією. Після кроку змінений елемент прокручується у видиму область (раз на пакет, до першого вдалого кроку) і отримує фокус — якщо відвідувач не набирає текст у чаті.

Куди далі

Форма крок за кроком — демо-форма на нашому сайті, розмічена й пояснена рядок за рядком.
Розмітка елементів — ідентифікатори, назви, підказки, групи, приватні області.
Згода і збереження — data-sa-risk, data-sa-commit, три політики.
Списки й варіанти — повторювані рядки і перемикачі мов.
Повзунки й вибори, Читання екрана, Екрани додатка.