Caps how far survey text may grow under the OS text-size setting, as a multiple of its base size - React Native's maxFontSizeMultiplier, applied to every semantic Text and TextInput the survey renders. Icon-only text fallbacks do not scale because they occupy fixed-size icon boxes.
Pass a number to cap every role at once, or an object to cap them separately: a survey headline can usually take more scaling than a numeral inside a rating button, and a host app that already caps its own text by role will want to match those ceilings here.
Roles left out of the object are uncapped, as they are today. Use 0 for no maximum, or a value of 1 or greater to set a cap. Other values below 1 (such as 0.8) do not shrink text and are unsupported by React Native; depending on the platform and version, they may be ignored or rejected.
Leave it unset (the default) and survey text scales without a ceiling. That is what the OS asks for, but not always what a fixed-size survey card can hold - at the largest accessibility sizes an unbounded 18pt headline renders roughly one word per line.
React Native only inherits this prop through nested Text, so a host app cannot apply it from the outside - it has to come in here.
undefined (no ceiling) |