mirror of
https://github.com/google/blockly.git
synced 2026-01-09 18:10:08 +01:00
3cf834a6a6
## The basics - [x] I [validated my changes](https://developers.google.com/blockly/guides/contribute/core#making_and_verifying_a_change) ## The details ### Resolves Fixes #8206 Fixes #8210 Fixes #8213 Fixes #8255 Fixes #8211 Fixes #8212 Fixes #8254 Fixes part of #9301 Fixes part of #9304 ### Proposed Changes This PR completes the remaining ARIA roles and properties needed for all core fields. Specifically: - #8206: A better name needed to be used for the checkbox value, plus there was an ARIA property missing for actually representing the checkbox state. The latter needed to be updated upon toggling the checkbox, as well. These changes bring checkbox fields in compliance with the ARIA checkbox pattern documented here: https://www.w3.org/WAI/ARIA/apg/patterns/checkbox/. - #8210: This one required a lot of changes in order to adapt to the ARIA combobox pattern documented here: https://www.w3.org/WAI/ARIA/apg/patterns/combobox/. Specifically: - Menus needed to have a unique ID that's also exposed in order to link the combobox element to its menu when open. - ARIA's `activedescendant` proved very useful in ensuring that the current dropdown selection is correctly read when the combobox has focus but its menu isn't opened. - The default properties available for options (label and value) aren't very good for readout, so a custom ARIA property was added for much clearer option readouts. This is only demonstrated for the math arithmetic block for now. - The text element is normally hidden for ARIA but it's useful in conjunction with `activedescendant` to represent the current value selection. - Images have been handled here as well (partly as part of #8255) by leveraging their alt text for readouts. This actually seems to work quite well both for current value and selection. - #8213: Much of the improvements here come from the combobox (`FieldDropdown`) improvements explained above. However one additional bit was done to provide an explicit 'Variable <name>' readout for the purpose of clarity. This demonstrates some contextualization of the value of the field which may be a generally useful pattern to copy in other field contexts. - #8255: Image fields have been refined since they were redundantly specifying 'image' when an `image` ARIA role is already being used. Now only the alt text is supplied along with the role context. Note that images need special handling since they can sometimes be navigable (such as when they have click handlers). - #8211: Text input fields have had their labeling improved like all other fields, and the field's value is now exposed via its `text` element since this will show up as a `StaticText` node in the accessibility tree and automatically be read as part of the field's value. - #8212: This gets the same benefits as the previous point since those improvements were included for both text and number input. However, existing `valuemin` and `valuemax` ARIA properties have been removed. It seems these are really only useful when introducing a slider mechanism (see https://www.w3.org/WAI/ARIA/apg/patterns/slider/) and from testing seems to not really be utilized for the basic text input that `FieldNumber` currently uses. It may be the case that this is a better pattern to use in the future, but it's more likely that other custom fields could benefit from more specific patterns like slider rather than `FieldNumber` being changed in that way. - #8254 and part of #9304: Field labels have been completely removed from the accessibility node tree since they can never be navigated to (as #8254 explains all labels will be included as part of the block's ARIA label itself for readout parity with navigation options). Note that it doesn't cover external fields (such as those supplied in blockly-samples), nor does it fully set up the infrastructure work for those. Ultimately that work needs to happen as part of #9301. Beyond the role work above, this PR also introduces some fundamental work for #9301. Specifically: - It demonstrates how block definitions could be used to introduce accessibility label customizations (in this case for the options of the arithmetic operator block's drop-down field, plus the block itself). - It sets up some central label computation for all fields, though more thought is needed on whether this is sufficient for custom fields outside of core Blockly and on how to properly contextualize labels for field values. Core Blockly's fields are fairly simple for representing values which is why that aspect of #9301 didn't need to be solved in this PR. Note that the field labeling here is being used to improve all of the fields above, but also it tries to aggressively fall back to the _next best_ label to be used (though it's possible to run out of options which is why fields still need contextually-specific fallbacks). ### Reason for Changes Generally the initial approach for implementing labels is leveraging as specific ARIA roles as exist to directly represent the element. This PR is completing that work for all of core Blockly's built-in fields, and laying some of the groundwork for generalizing this support for custom fields. Having specific roles does potentially introduce inconsistencies across screen readers (though should improve consistency across sites for a single screen reader), and expectations for behaviors (like shortcuts) that may need to be ignored or only partially supported (#9313 is discussing this). ### Test Coverage Only manual testing has been completed since this is experimental work. Video demonstrating most of the changes: [Screen recording 2025-10-01 4.05.35 PM.webm](https://github.com/user-attachments/assets/c7961caa-eae0-4585-8fd9-87d7cbe65988) ### Documentation N/A -- Experimental work. ### Additional Information This has only been tested on ChromeVox.
427 lines
26 KiB
JSON
427 lines
26 KiB
JSON
{
|
||
"@metadata": {
|
||
"author": "Ellen Spertus <ellen.spertus@gmail.com>",
|
||
"lastupdated": "2025-09-23 23:27:37.312782",
|
||
"locale": "en",
|
||
"messagedocumentation" : "qqq"
|
||
},
|
||
"VARIABLES_DEFAULT_NAME": "item",
|
||
"UNNAMED_KEY": "unnamed",
|
||
"TODAY": "Today",
|
||
"DUPLICATE_BLOCK": "Duplicate",
|
||
"ADD_COMMENT": "Add Comment",
|
||
"REMOVE_COMMENT": "Remove Comment",
|
||
"DUPLICATE_COMMENT": "Duplicate Comment",
|
||
"COLLAPSE_COMMENT": "Collapse Comment",
|
||
"EXTERNAL_INPUTS": "External Inputs",
|
||
"INLINE_INPUTS": "Inline Inputs",
|
||
"DELETE_BLOCK": "Delete Block",
|
||
"DELETE_X_BLOCKS": "Delete %1 Blocks",
|
||
"DELETE_ALL_BLOCKS": "Delete all %1 blocks?",
|
||
"CLEAN_UP": "Clean up Blocks",
|
||
"CLOSE": "Close",
|
||
"COLLAPSE_BLOCK": "Collapse Block",
|
||
"COLLAPSE_ALL": "Collapse Blocks",
|
||
"EXPAND_BLOCK": "Expand Block",
|
||
"EXPAND_ALL": "Expand Blocks",
|
||
"DISABLE_BLOCK": "Disable Block",
|
||
"ENABLE_BLOCK": "Enable Block",
|
||
"HELP": "Help",
|
||
"UNDO": "Undo",
|
||
"REDO": "Redo",
|
||
"CHANGE_VALUE_TITLE": "Change value:",
|
||
"RENAME_VARIABLE": "Rename variable...",
|
||
"RENAME_VARIABLE_TITLE": "Rename all '%1' variables to:",
|
||
"ARIA_LABEL_FOR_VARIABLE_NAME": "Variable '%1'",
|
||
"NEW_VARIABLE": "Create variable...",
|
||
"NEW_STRING_VARIABLE": "Create string variable...",
|
||
"NEW_NUMBER_VARIABLE": "Create number variable...",
|
||
"NEW_COLOUR_VARIABLE": "Create colour variable...",
|
||
"NEW_VARIABLE_TYPE_TITLE": "New variable type:",
|
||
"NEW_VARIABLE_TITLE": "New variable name:",
|
||
"VARIABLE_ALREADY_EXISTS": "A variable named '%1' already exists.",
|
||
"VARIABLE_ALREADY_EXISTS_FOR_ANOTHER_TYPE": "A variable named '%1' already exists for another type: '%2'.",
|
||
"VARIABLE_ALREADY_EXISTS_FOR_A_PARAMETER": "A variable named '%1' already exists as a parameter in the procedure '%2'.",
|
||
"DELETE_VARIABLE_CONFIRMATION": "Delete %1 uses of the '%2' variable?",
|
||
"CANNOT_DELETE_VARIABLE_PROCEDURE": "Can't delete the variable '%1' because it's part of the definition of the function '%2'",
|
||
"DELETE_VARIABLE": "Delete the '%1' variable",
|
||
"COLOUR_PICKER_HELPURL": "https://en.wikipedia.org/wiki/Color",
|
||
"COLOUR_PICKER_TOOLTIP": "Choose a colour from the palette.",
|
||
"COLOUR_RANDOM_HELPURL": "http://randomcolour.com",
|
||
"COLOUR_RANDOM_TITLE": "random colour",
|
||
"COLOUR_RANDOM_TOOLTIP": "Choose a colour at random.",
|
||
"COLOUR_RGB_HELPURL": "https://www.december.com/html/spec/colorpercompact.html",
|
||
"COLOUR_RGB_TITLE": "colour with",
|
||
"COLOUR_RGB_RED": "red",
|
||
"COLOUR_RGB_GREEN": "green",
|
||
"COLOUR_RGB_BLUE": "blue",
|
||
"COLOUR_RGB_TOOLTIP": "Create a colour with the specified amount of red, green, and blue. All values must be between 0 and 100.",
|
||
"COLOUR_BLEND_HELPURL": "https://meyerweb.com/eric/tools/color-blend/#:::rgbp",
|
||
"COLOUR_BLEND_TITLE": "blend",
|
||
"COLOUR_BLEND_COLOUR1": "colour 1",
|
||
"COLOUR_BLEND_COLOUR2": "colour 2",
|
||
"COLOUR_BLEND_RATIO": "ratio",
|
||
"COLOUR_BLEND_TOOLTIP": "Blends two colours together with a given ratio (0.0 - 1.0).",
|
||
"CONTROLS_REPEAT_HELPURL": "https://en.wikipedia.org/wiki/For_loop",
|
||
"CONTROLS_REPEAT_TITLE": "repeat %1 times",
|
||
"CONTROLS_REPEAT_INPUT_DO": "do",
|
||
"CONTROLS_REPEAT_TOOLTIP": "Do some statements several times.",
|
||
"CONTROLS_WHILEUNTIL_HELPURL": "https://github.com/google/blockly/wiki/Loops#repeat",
|
||
"CONTROLS_WHILEUNTIL_OPERATOR_WHILE": "repeat while",
|
||
"CONTROLS_WHILEUNTIL_OPERATOR_UNTIL": "repeat until",
|
||
"CONTROLS_WHILEUNTIL_TOOLTIP_WHILE": "While a value is true, then do some statements.",
|
||
"CONTROLS_WHILEUNTIL_TOOLTIP_UNTIL": "While a value is false, then do some statements.",
|
||
"CONTROLS_FOR_HELPURL": "https://github.com/google/blockly/wiki/Loops#count-with",
|
||
"CONTROLS_FOR_TOOLTIP": "Have the variable '%1' take on the values from the start number to the end number, counting by the specified interval, and do the specified blocks.",
|
||
"CONTROLS_FOR_TITLE": "count with %1 from %2 to %3 by %4",
|
||
"CONTROLS_FOREACH_HELPURL": "https://github.com/google/blockly/wiki/Loops#for-each",
|
||
"CONTROLS_FOREACH_TITLE": "for each item %1 in list %2",
|
||
"CONTROLS_FOREACH_TOOLTIP": "For each item in a list, set the variable '%1' to the item, and then do some statements.",
|
||
"CONTROLS_FLOW_STATEMENTS_HELPURL": "https://github.com/google/blockly/wiki/Loops#loop-termination-blocks",
|
||
"CONTROLS_FLOW_STATEMENTS_OPERATOR_BREAK": "break out of loop",
|
||
"CONTROLS_FLOW_STATEMENTS_OPERATOR_CONTINUE": "continue with next iteration of loop",
|
||
"CONTROLS_FLOW_STATEMENTS_TOOLTIP_BREAK": "Break out of the containing loop.",
|
||
"CONTROLS_FLOW_STATEMENTS_TOOLTIP_CONTINUE": "Skip the rest of this loop, and continue with the next iteration.",
|
||
"CONTROLS_FLOW_STATEMENTS_WARNING": "Warning: This block may only be used within a loop.",
|
||
"CONTROLS_IF_HELPURL": "https://github.com/google/blockly/wiki/IfElse",
|
||
"CONTROLS_IF_TOOLTIP_1": "If a value is true, then do some statements.",
|
||
"CONTROLS_IF_TOOLTIP_2": "If a value is true, then do the first block of statements. Otherwise, do the second block of statements.",
|
||
"CONTROLS_IF_TOOLTIP_3": "If the first value is true, then do the first block of statements. Otherwise, if the second value is true, do the second block of statements.",
|
||
"CONTROLS_IF_TOOLTIP_4": "If the first value is true, then do the first block of statements. Otherwise, if the second value is true, do the second block of statements. If none of the values are true, do the last block of statements.",
|
||
"CONTROLS_IF_MSG_IF": "if",
|
||
"CONTROLS_IF_MSG_ELSEIF": "else if",
|
||
"CONTROLS_IF_MSG_ELSE": "else",
|
||
"CONTROLS_IF_IF_TOOLTIP": "Add, remove, or reorder sections to reconfigure this if block.",
|
||
"CONTROLS_IF_ELSEIF_TOOLTIP": "Add a condition to the if block.",
|
||
"CONTROLS_IF_ELSE_TOOLTIP": "Add a final, catch-all condition to the if block.",
|
||
"LOGIC_COMPARE_HELPURL": "https://en.wikipedia.org/wiki/Inequality_(mathematics)",
|
||
"LOGIC_COMPARE_TOOLTIP_EQ": "Return true if both inputs equal each other.",
|
||
"LOGIC_COMPARE_TOOLTIP_NEQ": "Return true if both inputs are not equal to each other.",
|
||
"LOGIC_COMPARE_TOOLTIP_LT": "Return true if the first input is smaller than the second input.",
|
||
"LOGIC_COMPARE_TOOLTIP_LTE": "Return true if the first input is smaller than or equal to the second input.",
|
||
"LOGIC_COMPARE_TOOLTIP_GT": "Return true if the first input is greater than the second input.",
|
||
"LOGIC_COMPARE_TOOLTIP_GTE": "Return true if the first input is greater than or equal to the second input.",
|
||
"LOGIC_OPERATION_HELPURL": "https://github.com/google/blockly/wiki/Logic#logical-operations",
|
||
"LOGIC_OPERATION_TOOLTIP_AND": "Return true if both inputs are true.",
|
||
"LOGIC_OPERATION_AND": "and",
|
||
"LOGIC_OPERATION_TOOLTIP_OR": "Return true if at least one of the inputs is true.",
|
||
"LOGIC_OPERATION_OR": "or",
|
||
"LOGIC_NEGATE_HELPURL": "https://github.com/google/blockly/wiki/Logic#not",
|
||
"LOGIC_NEGATE_TITLE": "not %1",
|
||
"LOGIC_NEGATE_TOOLTIP": "Returns true if the input is false. Returns false if the input is true.",
|
||
"LOGIC_BOOLEAN_HELPURL": "https://github.com/google/blockly/wiki/Logic#values",
|
||
"LOGIC_BOOLEAN_TRUE": "true",
|
||
"LOGIC_BOOLEAN_FALSE": "false",
|
||
"LOGIC_BOOLEAN_TOOLTIP": "Returns either true or false.",
|
||
"LOGIC_NULL_HELPURL": "https://en.wikipedia.org/wiki/Nullable_type",
|
||
"LOGIC_NULL": "null",
|
||
"LOGIC_NULL_TOOLTIP": "Returns null.",
|
||
"LOGIC_TERNARY_HELPURL": "https://en.wikipedia.org/wiki/%3F:",
|
||
"LOGIC_TERNARY_CONDITION": "test",
|
||
"LOGIC_TERNARY_IF_TRUE": "if true",
|
||
"LOGIC_TERNARY_IF_FALSE": "if false",
|
||
"LOGIC_TERNARY_TOOLTIP": "Check the condition in 'test'. If the condition is true, returns the 'if true' value; otherwise returns the 'if false' value.",
|
||
"MATH_NUMBER_HELPURL": "https://en.wikipedia.org/wiki/Number",
|
||
"MATH_NUMBER_TOOLTIP": "A number.",
|
||
"MATH_ADDITION_SYMBOL": "+",
|
||
"MATH_SUBTRACTION_SYMBOL": "-",
|
||
"MATH_DIVISION_SYMBOL": "÷",
|
||
"MATH_MULTIPLICATION_SYMBOL": "×",
|
||
"MATH_POWER_SYMBOL": "^",
|
||
"MATH_TRIG_SIN": "sin",
|
||
"MATH_TRIG_COS": "cos",
|
||
"MATH_TRIG_TAN": "tan",
|
||
"MATH_TRIG_ASIN": "asin",
|
||
"MATH_TRIG_ACOS": "acos",
|
||
"MATH_TRIG_ATAN": "atan",
|
||
"MATH_ARITHMETIC_HELPURL": "https://en.wikipedia.org/wiki/Arithmetic",
|
||
"MATH_ARITHMETIC_TOOLTIP_ADD": "Return the sum of the two numbers.",
|
||
"MATH_ARITHMETIC_TOOLTIP_MINUS": "Return the difference of the two numbers.",
|
||
"MATH_ARITHMETIC_TOOLTIP_MULTIPLY": "Return the product of the two numbers.",
|
||
"MATH_ARITHMETIC_TOOLTIP_DIVIDE": "Return the quotient of the two numbers.",
|
||
"MATH_ARITHMETIC_TOOLTIP_POWER": "Return the first number raised to the power of the second number.",
|
||
"MATH_SINGLE_HELPURL": "https://en.wikipedia.org/wiki/Square_root",
|
||
"MATH_SINGLE_OP_ROOT": "square root",
|
||
"MATH_SINGLE_TOOLTIP_ROOT": "Return the square root of a number.",
|
||
"MATH_SINGLE_OP_ABSOLUTE": "absolute",
|
||
"MATH_SINGLE_TOOLTIP_ABS": "Return the absolute value of a number.",
|
||
"MATH_SINGLE_TOOLTIP_NEG": "Return the negation of a number.",
|
||
"MATH_SINGLE_TOOLTIP_LN": "Return the natural logarithm of a number.",
|
||
"MATH_SINGLE_TOOLTIP_LOG10": "Return the base 10 logarithm of a number.",
|
||
"MATH_SINGLE_TOOLTIP_EXP": "Return e to the power of a number.",
|
||
"MATH_SINGLE_TOOLTIP_POW10": "Return 10 to the power of a number.",
|
||
"MATH_TRIG_HELPURL": "https://en.wikipedia.org/wiki/Trigonometric_functions",
|
||
"MATH_TRIG_TOOLTIP_SIN": "Return the sine of a degree (not radian).",
|
||
"MATH_TRIG_TOOLTIP_COS": "Return the cosine of a degree (not radian).",
|
||
"MATH_TRIG_TOOLTIP_TAN": "Return the tangent of a degree (not radian).",
|
||
"MATH_TRIG_TOOLTIP_ASIN": "Return the arcsine of a number.",
|
||
"MATH_TRIG_TOOLTIP_ACOS": "Return the arccosine of a number.",
|
||
"MATH_TRIG_TOOLTIP_ATAN": "Return the arctangent of a number.",
|
||
"MATH_CONSTANT_HELPURL": "https://en.wikipedia.org/wiki/Mathematical_constant",
|
||
"MATH_CONSTANT_TOOLTIP": "Return one of the common constants: π (3.141…), e (2.718…), φ (1.618…), sqrt(2) (1.414…), sqrt(½) (0.707…), or ∞ (infinity).",
|
||
"MATH_IS_EVEN": "is even",
|
||
"MATH_IS_ODD": "is odd",
|
||
"MATH_IS_PRIME": "is prime",
|
||
"MATH_IS_WHOLE": "is whole",
|
||
"MATH_IS_POSITIVE": "is positive",
|
||
"MATH_IS_NEGATIVE": "is negative",
|
||
"MATH_IS_DIVISIBLE_BY": "is divisible by",
|
||
"MATH_IS_TOOLTIP": "Check if a number is an even, odd, prime, whole, positive, negative, or if it is divisible by certain number. Returns true or false.",
|
||
"MATH_CHANGE_HELPURL": "https://en.wikipedia.org/wiki/Programming_idiom#Incrementing_a_counter",
|
||
"MATH_CHANGE_TITLE": "change %1 by %2",
|
||
"MATH_CHANGE_TOOLTIP": "Add a number to variable '%1'.",
|
||
"MATH_ROUND_HELPURL": "https://en.wikipedia.org/wiki/Rounding",
|
||
"MATH_ROUND_TOOLTIP": "Round a number up or down.",
|
||
"MATH_ROUND_OPERATOR_ROUND": "round",
|
||
"MATH_ROUND_OPERATOR_ROUNDUP": "round up",
|
||
"MATH_ROUND_OPERATOR_ROUNDDOWN": "round down",
|
||
"MATH_ONLIST_HELPURL": "",
|
||
"MATH_ONLIST_OPERATOR_SUM": "sum of list",
|
||
"MATH_ONLIST_TOOLTIP_SUM": "Return the sum of all the numbers in the list.",
|
||
"MATH_ONLIST_OPERATOR_MIN": "min of list",
|
||
"MATH_ONLIST_TOOLTIP_MIN": "Return the smallest number in the list.",
|
||
"MATH_ONLIST_OPERATOR_MAX": "max of list",
|
||
"MATH_ONLIST_TOOLTIP_MAX": "Return the largest number in the list.",
|
||
"MATH_ONLIST_OPERATOR_AVERAGE": "average of list",
|
||
"MATH_ONLIST_TOOLTIP_AVERAGE": "Return the average (arithmetic mean) of the numeric values in the list.",
|
||
"MATH_ONLIST_OPERATOR_MEDIAN": "median of list",
|
||
"MATH_ONLIST_TOOLTIP_MEDIAN": "Return the median number in the list.",
|
||
"MATH_ONLIST_OPERATOR_MODE": "modes of list",
|
||
"MATH_ONLIST_TOOLTIP_MODE": "Return a list of the most common item(s) in the list.",
|
||
"MATH_ONLIST_OPERATOR_STD_DEV": "standard deviation of list",
|
||
"MATH_ONLIST_TOOLTIP_STD_DEV": "Return the standard deviation of the list.",
|
||
"MATH_ONLIST_OPERATOR_RANDOM": "random item of list",
|
||
"MATH_ONLIST_TOOLTIP_RANDOM": "Return a random element from the list.",
|
||
"MATH_MODULO_HELPURL": "https://en.wikipedia.org/wiki/Modulo_operation",
|
||
"MATH_MODULO_TITLE": "remainder of %1 ÷ %2",
|
||
"MATH_MODULO_TOOLTIP": "Return the remainder from dividing the two numbers.",
|
||
"MATH_CONSTRAIN_HELPURL": "https://en.wikipedia.org/wiki/Clamping_(graphics)",
|
||
"MATH_CONSTRAIN_TITLE": "constrain %1 low %2 high %3",
|
||
"MATH_CONSTRAIN_TOOLTIP": "Constrain a number to be between the specified limits (inclusive).",
|
||
"MATH_RANDOM_INT_HELPURL": "https://en.wikipedia.org/wiki/Random_number_generation",
|
||
"MATH_RANDOM_INT_TITLE": "random integer from %1 to %2",
|
||
"MATH_RANDOM_INT_TOOLTIP": "Return a random integer between the two specified limits, inclusive.",
|
||
"MATH_RANDOM_FLOAT_HELPURL": "https://en.wikipedia.org/wiki/Random_number_generation",
|
||
"MATH_RANDOM_FLOAT_TITLE_RANDOM": "random fraction",
|
||
"MATH_RANDOM_FLOAT_TOOLTIP": "Return a random fraction between 0.0 (inclusive) and 1.0 (exclusive).",
|
||
"MATH_ATAN2_HELPURL": "https://en.wikipedia.org/wiki/Atan2",
|
||
"MATH_ATAN2_TITLE": "atan2 of X:%1 Y:%2",
|
||
"MATH_ATAN2_TOOLTIP": "Return the arctangent of point (X, Y) in degrees from -180 to 180.",
|
||
"TEXT_TEXT_HELPURL": "https://en.wikipedia.org/wiki/String_(computer_science)",
|
||
"TEXT_TEXT_TOOLTIP": "A letter, word, or line of text.",
|
||
"TEXT_JOIN_HELPURL": "https://github.com/google/blockly/wiki/Text#text-creation",
|
||
"TEXT_JOIN_TITLE_CREATEWITH": "create text with",
|
||
"TEXT_JOIN_TOOLTIP": "Create a piece of text by joining together any number of items.",
|
||
"TEXT_CREATE_JOIN_TITLE_JOIN": "join",
|
||
"TEXT_CREATE_JOIN_TOOLTIP": "Add, remove, or reorder sections to reconfigure this text block.",
|
||
"TEXT_CREATE_JOIN_ITEM_TOOLTIP": "Add an item to the text.",
|
||
"TEXT_APPEND_HELPURL": "https://github.com/google/blockly/wiki/Text#text-modification",
|
||
"TEXT_APPEND_TITLE": "to %1 append text %2",
|
||
"TEXT_APPEND_TOOLTIP": "Append some text to variable '%1'.",
|
||
"TEXT_LENGTH_HELPURL": "https://github.com/google/blockly/wiki/Text#text-modification",
|
||
"TEXT_LENGTH_TITLE": "length of %1",
|
||
"TEXT_LENGTH_TOOLTIP": "Returns the number of letters (including spaces) in the provided text.",
|
||
"TEXT_ISEMPTY_HELPURL": "https://github.com/google/blockly/wiki/Text#checking-for-empty-text",
|
||
"TEXT_ISEMPTY_TITLE": "%1 is empty",
|
||
"TEXT_ISEMPTY_TOOLTIP": "Returns true if the provided text is empty.",
|
||
"TEXT_INDEXOF_HELPURL": "https://github.com/google/blockly/wiki/Text#finding-text",
|
||
"TEXT_INDEXOF_TOOLTIP": "Returns the index of the first/last occurrence of the first text in the second text. Returns %1 if text is not found.",
|
||
"TEXT_INDEXOF_TITLE": "in text %1 %2 %3",
|
||
"TEXT_INDEXOF_OPERATOR_FIRST": "find first occurrence of text",
|
||
"TEXT_INDEXOF_OPERATOR_LAST": "find last occurrence of text",
|
||
"TEXT_CHARAT_HELPURL": "https://github.com/google/blockly/wiki/Text#extracting-text",
|
||
"TEXT_CHARAT_TITLE": "in text %1 %2",
|
||
"TEXT_CHARAT_FROM_START": "get letter #",
|
||
"TEXT_CHARAT_FROM_END": "get letter # from end",
|
||
"TEXT_CHARAT_FIRST": "get first letter",
|
||
"TEXT_CHARAT_LAST": "get last letter",
|
||
"TEXT_CHARAT_RANDOM": "get random letter",
|
||
"TEXT_CHARAT_TAIL": "",
|
||
"TEXT_CHARAT_TOOLTIP": "Returns the letter at the specified position.",
|
||
"TEXT_GET_SUBSTRING_TOOLTIP": "Returns a specified portion of the text.",
|
||
"TEXT_GET_SUBSTRING_HELPURL": "https://github.com/google/blockly/wiki/Text#extracting-a-region-of-text",
|
||
"TEXT_GET_SUBSTRING_INPUT_IN_TEXT": "in text",
|
||
"TEXT_GET_SUBSTRING_START_FROM_START": "get substring from letter #",
|
||
"TEXT_GET_SUBSTRING_START_FROM_END": "get substring from letter # from end",
|
||
"TEXT_GET_SUBSTRING_START_FIRST": "get substring from first letter",
|
||
"TEXT_GET_SUBSTRING_END_FROM_START": "to letter #",
|
||
"TEXT_GET_SUBSTRING_END_FROM_END": "to letter # from end",
|
||
"TEXT_GET_SUBSTRING_END_LAST": "to last letter",
|
||
"TEXT_GET_SUBSTRING_TAIL": "",
|
||
"TEXT_CHANGECASE_HELPURL": "https://github.com/google/blockly/wiki/Text#adjusting-text-case",
|
||
"TEXT_CHANGECASE_TOOLTIP": "Return a copy of the text in a different case.",
|
||
"TEXT_CHANGECASE_OPERATOR_UPPERCASE": "to UPPER CASE",
|
||
"TEXT_CHANGECASE_OPERATOR_LOWERCASE": "to lower case",
|
||
"TEXT_CHANGECASE_OPERATOR_TITLECASE": "to Title Case",
|
||
"TEXT_TRIM_HELPURL": "https://github.com/google/blockly/wiki/Text#trimming-removing-spaces",
|
||
"TEXT_TRIM_TOOLTIP": "Return a copy of the text with spaces removed from one or both ends.",
|
||
"TEXT_TRIM_OPERATOR_BOTH": "trim spaces from both sides of",
|
||
"TEXT_TRIM_OPERATOR_LEFT": "trim spaces from left side of",
|
||
"TEXT_TRIM_OPERATOR_RIGHT": "trim spaces from right side of",
|
||
"TEXT_PRINT_HELPURL": "https://github.com/google/blockly/wiki/Text#printing-text",
|
||
"TEXT_PRINT_TITLE": "print %1",
|
||
"TEXT_PRINT_TOOLTIP": "Print the specified text, number or other value.",
|
||
"TEXT_PROMPT_HELPURL": "https://github.com/google/blockly/wiki/Text#getting-input-from-the-user",
|
||
"TEXT_PROMPT_TYPE_TEXT": "prompt for text with message",
|
||
"TEXT_PROMPT_TYPE_NUMBER": "prompt for number with message",
|
||
"TEXT_PROMPT_TOOLTIP_NUMBER": "Prompt for user for a number.",
|
||
"TEXT_PROMPT_TOOLTIP_TEXT": "Prompt for user for some text.",
|
||
"TEXT_COUNT_MESSAGE0": "count %1 in %2",
|
||
"TEXT_COUNT_HELPURL": "https://github.com/google/blockly/wiki/Text#counting-substrings",
|
||
"TEXT_COUNT_TOOLTIP": "Count how many times some text occurs within some other text.",
|
||
"TEXT_REPLACE_MESSAGE0": "replace %1 with %2 in %3",
|
||
"TEXT_REPLACE_HELPURL": "https://github.com/google/blockly/wiki/Text#replacing-substrings",
|
||
"TEXT_REPLACE_TOOLTIP": "Replace all occurances of some text within some other text.",
|
||
"TEXT_REVERSE_MESSAGE0": "reverse %1",
|
||
"TEXT_REVERSE_HELPURL": "https://github.com/google/blockly/wiki/Text#reversing-text",
|
||
"TEXT_REVERSE_TOOLTIP": "Reverses the order of the characters in the text.",
|
||
"LISTS_CREATE_EMPTY_HELPURL": "https://github.com/google/blockly/wiki/Lists#create-empty-list",
|
||
"LISTS_CREATE_EMPTY_TITLE": "create empty list",
|
||
"LISTS_CREATE_EMPTY_TOOLTIP": "Returns a list, of length 0, containing no data records",
|
||
"LISTS_CREATE_WITH_HELPURL": "https://github.com/google/blockly/wiki/Lists#create-list-with",
|
||
"LISTS_CREATE_WITH_TOOLTIP": "Create a list with any number of items.",
|
||
"LISTS_CREATE_WITH_INPUT_WITH": "create list with",
|
||
"LISTS_CREATE_WITH_CONTAINER_TITLE_ADD": "list",
|
||
"LISTS_CREATE_WITH_CONTAINER_TOOLTIP": "Add, remove, or reorder sections to reconfigure this list block.",
|
||
"LISTS_CREATE_WITH_ITEM_TOOLTIP": "Add an item to the list.",
|
||
"LISTS_REPEAT_HELPURL": "https://github.com/google/blockly/wiki/Lists#create-list-with",
|
||
"LISTS_REPEAT_TOOLTIP": "Creates a list consisting of the given value repeated the specified number of times.",
|
||
"LISTS_REPEAT_TITLE": "create list with item %1 repeated %2 times",
|
||
"LISTS_LENGTH_HELPURL": "https://github.com/google/blockly/wiki/Lists#length-of",
|
||
"LISTS_LENGTH_TITLE": "length of %1",
|
||
"LISTS_LENGTH_TOOLTIP": "Returns the length of a list.",
|
||
"LISTS_ISEMPTY_HELPURL": "https://github.com/google/blockly/wiki/Lists#is-empty",
|
||
"LISTS_ISEMPTY_TITLE": "%1 is empty",
|
||
"LISTS_ISEMPTY_TOOLTIP": "Returns true if the list is empty.",
|
||
"LISTS_INLIST": "in list",
|
||
"LISTS_INDEX_OF_HELPURL": "https://github.com/google/blockly/wiki/Lists#finding-items-in-a-list",
|
||
"LISTS_INDEX_OF_FIRST": "find first occurrence of item",
|
||
"LISTS_INDEX_OF_LAST": "find last occurrence of item",
|
||
"LISTS_INDEX_OF_TOOLTIP": "Returns the index of the first/last occurrence of the item in the list. Returns %1 if item is not found.",
|
||
"LISTS_GET_INDEX_HELPURL": "https://github.com/google/blockly/wiki/Lists#getting-items-from-a-list",
|
||
"LISTS_GET_INDEX_GET": "get",
|
||
"LISTS_GET_INDEX_GET_REMOVE": "get and remove",
|
||
"LISTS_GET_INDEX_REMOVE": "remove",
|
||
"LISTS_GET_INDEX_FROM_START": "#",
|
||
"LISTS_GET_INDEX_FROM_END": "# from end",
|
||
"LISTS_GET_INDEX_FIRST": "first",
|
||
"LISTS_GET_INDEX_LAST": "last",
|
||
"LISTS_GET_INDEX_RANDOM": "random",
|
||
"LISTS_GET_INDEX_TAIL": "",
|
||
"LISTS_INDEX_FROM_START_TOOLTIP": "%1 is the first item.",
|
||
"LISTS_INDEX_FROM_END_TOOLTIP": "%1 is the last item.",
|
||
"LISTS_GET_INDEX_TOOLTIP_GET_FROM": "Returns the item at the specified position in a list.",
|
||
"LISTS_GET_INDEX_TOOLTIP_GET_FIRST": "Returns the first item in a list.",
|
||
"LISTS_GET_INDEX_TOOLTIP_GET_LAST": "Returns the last item in a list.",
|
||
"LISTS_GET_INDEX_TOOLTIP_GET_RANDOM": "Returns a random item in a list.",
|
||
"LISTS_GET_INDEX_TOOLTIP_GET_REMOVE_FROM": "Removes and returns the item at the specified position in a list.",
|
||
"LISTS_GET_INDEX_TOOLTIP_GET_REMOVE_FIRST": "Removes and returns the first item in a list.",
|
||
"LISTS_GET_INDEX_TOOLTIP_GET_REMOVE_LAST": "Removes and returns the last item in a list.",
|
||
"LISTS_GET_INDEX_TOOLTIP_GET_REMOVE_RANDOM": "Removes and returns a random item in a list.",
|
||
"LISTS_GET_INDEX_TOOLTIP_REMOVE_FROM": "Removes the item at the specified position in a list.",
|
||
"LISTS_GET_INDEX_TOOLTIP_REMOVE_FIRST": "Removes the first item in a list.",
|
||
"LISTS_GET_INDEX_TOOLTIP_REMOVE_LAST": "Removes the last item in a list.",
|
||
"LISTS_GET_INDEX_TOOLTIP_REMOVE_RANDOM": "Removes a random item in a list.",
|
||
"LISTS_SET_INDEX_HELPURL": "https://github.com/google/blockly/wiki/Lists#in-list--set",
|
||
"LISTS_SET_INDEX_SET": "set",
|
||
"LISTS_SET_INDEX_INSERT": "insert at",
|
||
"LISTS_SET_INDEX_INPUT_TO": "as",
|
||
"LISTS_SET_INDEX_TOOLTIP_SET_FROM": "Sets the item at the specified position in a list.",
|
||
"LISTS_SET_INDEX_TOOLTIP_SET_FIRST": "Sets the first item in a list.",
|
||
"LISTS_SET_INDEX_TOOLTIP_SET_LAST": "Sets the last item in a list.",
|
||
"LISTS_SET_INDEX_TOOLTIP_SET_RANDOM": "Sets a random item in a list.",
|
||
"LISTS_SET_INDEX_TOOLTIP_INSERT_FROM": "Inserts the item at the specified position in a list.",
|
||
"LISTS_SET_INDEX_TOOLTIP_INSERT_FIRST": "Inserts the item at the start of a list.",
|
||
"LISTS_SET_INDEX_TOOLTIP_INSERT_LAST": "Append the item to the end of a list.",
|
||
"LISTS_SET_INDEX_TOOLTIP_INSERT_RANDOM": "Inserts the item randomly in a list.",
|
||
"LISTS_GET_SUBLIST_HELPURL": "https://github.com/google/blockly/wiki/Lists#getting-a-sublist",
|
||
"LISTS_GET_SUBLIST_START_FROM_START": "get sub-list from #",
|
||
"LISTS_GET_SUBLIST_START_FROM_END": "get sub-list from # from end",
|
||
"LISTS_GET_SUBLIST_START_FIRST": "get sub-list from first",
|
||
"LISTS_GET_SUBLIST_END_FROM_START": "to #",
|
||
"LISTS_GET_SUBLIST_END_FROM_END": "to # from end",
|
||
"LISTS_GET_SUBLIST_END_LAST": "to last",
|
||
"LISTS_GET_SUBLIST_TAIL": "",
|
||
"LISTS_GET_SUBLIST_TOOLTIP": "Creates a copy of the specified portion of a list.",
|
||
"LISTS_SORT_HELPURL": "https://github.com/google/blockly/wiki/Lists#sorting-a-list",
|
||
"LISTS_SORT_TITLE": "sort %1 %2 %3",
|
||
"LISTS_SORT_TOOLTIP": "Sort a copy of a list.",
|
||
"LISTS_SORT_ORDER_ASCENDING": "ascending",
|
||
"LISTS_SORT_ORDER_DESCENDING": "descending",
|
||
"LISTS_SORT_TYPE_NUMERIC": "numeric",
|
||
"LISTS_SORT_TYPE_TEXT": "alphabetic",
|
||
"LISTS_SORT_TYPE_IGNORECASE": "alphabetic, ignore case",
|
||
"LISTS_SPLIT_HELPURL": "https://github.com/google/blockly/wiki/Lists#splitting-strings-and-joining-lists",
|
||
"LISTS_SPLIT_LIST_FROM_TEXT": "make list from text",
|
||
"LISTS_SPLIT_TEXT_FROM_LIST": "make text from list",
|
||
"LISTS_SPLIT_WITH_DELIMITER": "with delimiter",
|
||
"LISTS_SPLIT_TOOLTIP_SPLIT": "Split text into a list of texts, breaking at each delimiter.",
|
||
"LISTS_SPLIT_TOOLTIP_JOIN": "Join a list of texts into one text, separated by a delimiter.",
|
||
"LISTS_REVERSE_HELPURL": "https://github.com/google/blockly/wiki/Lists#reversing-a-list",
|
||
"LISTS_REVERSE_MESSAGE0": "reverse %1",
|
||
"LISTS_REVERSE_TOOLTIP": "Reverse a copy of a list.",
|
||
"ORDINAL_NUMBER_SUFFIX": "",
|
||
"VARIABLES_GET_HELPURL": "https://github.com/google/blockly/wiki/Variables#get",
|
||
"VARIABLES_GET_TOOLTIP": "Returns the value of this variable.",
|
||
"VARIABLES_GET_CREATE_SET": "Create 'set %1'",
|
||
"VARIABLES_SET_HELPURL": "https://github.com/google/blockly/wiki/Variables#set",
|
||
"VARIABLES_SET": "set %1 to %2",
|
||
"VARIABLES_SET_TOOLTIP": "Sets this variable to be equal to the input.",
|
||
"VARIABLES_SET_CREATE_GET": "Create 'get %1'",
|
||
"PROCEDURES_DEFNORETURN_HELPURL": "https://en.wikipedia.org/wiki/Subroutine",
|
||
"PROCEDURES_DEFNORETURN_TITLE": "to",
|
||
"PROCEDURES_DEFNORETURN_PROCEDURE": "do something",
|
||
"PROCEDURES_BEFORE_PARAMS": "with:",
|
||
"PROCEDURES_CALL_BEFORE_PARAMS": "with:",
|
||
"PROCEDURES_CALL_DISABLED_DEF_WARNING": "Can't run the user-defined function '%1' because the definition block is disabled.",
|
||
"PROCEDURES_DEFNORETURN_DO": "",
|
||
"PROCEDURES_DEFNORETURN_TOOLTIP": "Creates a function with no output.",
|
||
"PROCEDURES_DEFNORETURN_COMMENT": "Describe this function...",
|
||
"PROCEDURES_DEFRETURN_HELPURL": "https://en.wikipedia.org/wiki/Subroutine",
|
||
"PROCEDURES_DEFRETURN_RETURN": "return",
|
||
"PROCEDURES_DEFRETURN_TOOLTIP": "Creates a function with an output.",
|
||
"PROCEDURES_ALLOW_STATEMENTS": "allow statements",
|
||
"PROCEDURES_DEF_DUPLICATE_WARNING": "Warning: This function has duplicate parameters.",
|
||
"PROCEDURES_CALLNORETURN_HELPURL": "https://en.wikipedia.org/wiki/Subroutine",
|
||
"PROCEDURES_CALLNORETURN_TOOLTIP": "Run the user-defined function '%1'.",
|
||
"PROCEDURES_CALLRETURN_HELPURL": "https://en.wikipedia.org/wiki/Subroutine",
|
||
"PROCEDURES_CALLRETURN_TOOLTIP": "Run the user-defined function '%1' and use its output.",
|
||
"PROCEDURES_MUTATORCONTAINER_TITLE": "inputs",
|
||
"PROCEDURES_MUTATORCONTAINER_TOOLTIP": "Add, remove, or reorder inputs to this function.",
|
||
"PROCEDURES_MUTATORARG_TITLE": "input name:",
|
||
"PROCEDURES_MUTATORARG_TOOLTIP": "Add an input to the function.",
|
||
"PROCEDURES_HIGHLIGHT_DEF": "Highlight function definition",
|
||
"PROCEDURES_CREATE_DO": "Create '%1'",
|
||
"PROCEDURES_IFRETURN_TOOLTIP": "If a value is true, then return a second value.",
|
||
"PROCEDURES_IFRETURN_HELPURL": "https://c2.com/cgi/wiki?GuardClause",
|
||
"PROCEDURES_IFRETURN_WARNING": "Warning: This block may be used only within a function definition.",
|
||
"WORKSPACE_COMMENT_DEFAULT_TEXT": "Say something...",
|
||
"WORKSPACE_ARIA_LABEL": "Blockly Workspace",
|
||
"TOOLBOX_ARIA_LABEL": "Toolbox",
|
||
"COLLAPSED_WARNINGS_WARNING": "Collapsed blocks contain warnings.",
|
||
"DIALOG_OK": "OK",
|
||
"DIALOG_CANCEL": "Cancel",
|
||
"EDIT_BLOCK_CONTENTS": "Edit Block contents",
|
||
"MOVE_BLOCK": "Move Block",
|
||
"WINDOWS": "Windows",
|
||
"MAC_OS": "macOS",
|
||
"CHROME_OS": "ChromeOS",
|
||
"LINUX": "Linux",
|
||
"UNKNOWN": "Unknown",
|
||
"CONTROL_KEY": "Ctrl",
|
||
"COMMAND_KEY": "⌘ Command",
|
||
"OPTION_KEY": "⌥ Option",
|
||
"ALT_KEY": "Alt",
|
||
"CUT_SHORTCUT": "Cut",
|
||
"COPY_SHORTCUT": "Copy",
|
||
"PASTE_SHORTCUT": "Paste",
|
||
"HELP_PROMPT": "Press %1 for help on keyboard controls",
|
||
"SHORTCUTS_GENERAL": "General",
|
||
"SHORTCUTS_EDITING": "Editing",
|
||
"SHORTCUTS_CODE_NAVIGATION": "Code navigation",
|
||
"KEYBOARD_NAV_UNCONSTRAINED_MOVE_HINT": "Hold %1 and use arrow keys to move freely, then %2 to accept the position",
|
||
"KEYBOARD_NAV_CONSTRAINED_MOVE_HINT": "Use the arrow keys to move, then %1 to accept the position",
|
||
"KEYBOARD_NAV_COPIED_HINT": "Copied. Press %1 to paste.",
|
||
"KEYBOARD_NAV_CUT_HINT": "Cut. Press %1 to paste."
|
||
}
|