MultiInput SAP SE <h3>Overview</h3> A multi-input field allows the user to enter multiple values, which are displayed as {@link sap.m.Token tokens}. You can enable auto-complete suggestions or value help to help the user choose the correct entry. You can define validator functions to define what token values are accepted. <b>Notes:</b> <ul> <li> New valid tokens are created, when the user presses Enter, selects a value from the suggestions drop-down, or when the focus leaves the field.</li> <li> When multiple values are copied and pasted in the field, separate tokens are created for each of them.</li> <li> When a single value is copied and pasted in the field, it is shown as a text value, as further editing might be required before it is converted into a token.</li> <li> Provide meaningful labels for all input fields. Do not use the placeholder as a replacement for the label.</li> <li> The <code>showValueHelp</code> property is overwritten and after initialization of the control, its value becomes <code>truthy</code>.</li> </ul> <h3>Usage</h3> <h4>When to use:</h4> <ul> <li> You need to provide the value help option to help users select or search multiple business objects.</li> <li> The dataset to choose from is expected to increase over time (for example, to more than 200 values).</li> </ul> <h4>When not to use:</h4> <ul> <li> When you need to select only one value.</li> <li> When you want the user to select from a predefined set of options. Use {@link sap.m.MultiComboBox} instead.</li> </ul> <h3>Responsive Behavior</h3> If there are many tokens, the control shows only the last selected tokens that fit and for the others a label <i>N-more</i> is provided. In case the length of the last selected token is exceeding the width of the control, only a label <i>N-Items</i> is shown. In both cases, pressing on the label will show the tokens in a popup. <u>On Phones:</u> <ul> <li> Only the last entered token is displayed.</li> <li> A new full-screen dialog opens where the auto-complete suggestions can be selected.</li> <li> You can review the tokens by tapping on the token or the input field.</li> </ul> <u> On Tablets:</u> <ul> <li> The auto-complete suggestions appear below or above the multi-input field.</li> <li> You can review the tokens by swiping them to the left or right.</li> </ul> <u>On Desktop:</u> <ul> <li> The auto-complete suggestions appear below or above the multi-input field.</li> <li> You can review the tokens by pressing the right or left arrows on the keyboard.</li> <li> You can select single tokens or a range of tokens and you can copy/cut/delete them.</li> </ul> sap.m/Input If set to true, the MultiInput will be displayed in multi-line display mode. In multi-line display mode, all tokens can be fully viewed and easily edited in the MultiInput. The default value is false. <b>Note:</b> This property does not take effect on smartphones or when the editable property is set to false. <b>Caution:</b> Do not enable multi-line mode in tables and forms. Replaced with N-more/N-items labels, which work in all cases. The max number of tokens that is allowed in MultiInput. Fired when the tokens aggregation changed (add / remove token) Please use the new event tokenUpdate. Type of tokenChange event. There are four TokenChange types: "added", "removed", "removedAll", "tokensChanged". Use sap.m.Tokenizer.TokenChangeType.Added for "added", sap.m.Tokenizer.TokenChangeType.Removed for "removed", sap.m.Tokenizer.TokenChangeType.RemovedAll for "removedAll" and sap.m.Tokenizer.TokenChangeType.TokensChanged for "tokensChanged". The added token or removed token. This parameter is used when tokenChange type is "added" or "removed". The array of removed tokens. This parameter is used when tokenChange type is "removedAll". The array of tokens that are added. This parameter is used when tokenChange type is "tokenChanged". The array of tokens that are removed. This parameter is used when tokenChange type is "tokenChanged". Fired when the tokens aggregation changed due to a user interaction (add / remove token) Type of tokenChange event. There are two TokenUpdate types: "added", "removed" Use sap.m.Tokenizer.TokenUpdateType.Added for "added" and sap.m.Tokenizer.TokenUpdateType.Removed for "removed". The array of tokens that are added. This parameter is used when tokenUpdate type is "added". The array of tokens that are removed. This parameter is used when tokenUpdate type is "removed". The currently displayed tokens The tokenizer which displays the tokens