diff --git a/py/selenium/webdriver/common/keys.py b/py/selenium/webdriver/common/keys.py index 8d2bf29c5e8d3..d07cdc3159c81 100644 --- a/py/selenium/webdriver/common/keys.py +++ b/py/selenium/webdriver/common/keys.py @@ -14,11 +14,16 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. + """The Keys implementation.""" class Keys: - """Set of special keys codes.""" + """Set of special key codes for input actions. + + Primarily intended for keyboard usage, but also applied in other contexts + such as Action Chains and IME interactions. + """ NULL = "\ue000" CANCEL = "\ue001" # ^break @@ -58,7 +63,8 @@ class Keys: SEMICOLON = "\ue018" EQUALS = "\ue019" - NUMPAD0 = "\ue01a" # number pad keys + # Keys representing number pad digits + NUMPAD0 = "\ue01a" NUMPAD1 = "\ue01b" NUMPAD2 = "\ue01c" NUMPAD3 = "\ue01d" @@ -68,6 +74,7 @@ class Keys: NUMPAD7 = "\ue021" NUMPAD8 = "\ue022" NUMPAD9 = "\ue023" + MULTIPLY = "\ue024" ADD = "\ue025" SEPARATOR = "\ue026" @@ -75,7 +82,8 @@ class Keys: DECIMAL = "\ue028" DIVIDE = "\ue029" - F1 = "\ue031" # function keys + # Function keys + F1 = "\ue031" F2 = "\ue032" F3 = "\ue033" F4 = "\ue034"