diff --git a/unstable/text-input/text-input-unstable-v3.xml b/unstable/text-input/text-input-unstable-v3.xml index 2803661..f3cb5f3 100644 --- a/unstable/text-input/text-input-unstable-v3.xml +++ b/unstable/text-input/text-input-unstable-v3.xml @@ -425,8 +425,10 @@ Instruct the application to apply changes to state requested by the - preedit_string, commit_string and delete_surrounding_text events. The - state relating to these events is double-buffered, and each one + preedit_string, commit_string delete_surrounding_text, and action + events. + + The state relating to these events is double-buffered, and each one modifies the pending state. This event replaces the current state with the pending state. @@ -439,6 +441,7 @@ 4. Calculate surrounding text to send. 5. Insert new preedit text in cursor position. 6. Place cursor inside preedit text. + 7. Perform the requested action. The serial number reflects the last state of the zwp_text_input_v3 object known to the compositor. The value of the serial argument must @@ -454,6 +457,51 @@ + + + + + + + + + A possible action to perform on a text input. + + The submit action is intended for input entries that expect some sort of + activation after user interaction, e.g. the URL entry in a browser. + + + + + + + + An action was performed on this text input. + + Values set with this event are double-buffered. They must be applied + and reset to initial on the next zwp_text_input_v3.done event. + + The initial value of action is none. + + + + + + + + Set the actions available for this text input. + + Values set with this request are double-buffered. They will get applied + on the next zwp_text_input_v3.commit request. + + If the available_actions array contains the none action, or contains the + same action multiple times, the compositor must raise the invalid_action + protocol error. + + Initially, no actions are available. + + +