Package eltos.simpledialogfragment.form

Klasse Input

java.lang.Object
eltos.simpledialogfragment.form.FormElement<Input,eltos.simpledialogfragment.form.InputViewHolder>
eltos.simpledialogfragment.form.Input
Alle implementierten Schnittstellen:
android.os.Parcelable
public class Input extends FormElement<Input,eltos.simpledialogfragment.form.InputViewHolder>
An input form element to be used with SimpleFormDialog This is an EditText that can be used to enter text, email-addresses, numbers, passwords etc. Optionally supports auto-complete behaviour using suggestions.

This will add a String to resource bundle containing the entered text.

Created by eltos on 20.02.17.

  • Felddetails

    • wrap

      protected Boolean wrap

    • maxLines

      protected int maxLines

    • CREATOR

      public static final android.os.Parcelable.Creator<Input> CREATOR

  • Methodendetails

    • plain

      public static Input plain(String key)
      Factory method for a plain input field.
      Parameter:
      key - the key that can be used to receive the entered text from the bundle in SimpleDialog.OnDialogResultListener.onResult(java.lang.String, int, android.os.Bundle)
      Gibt zurück:
      this instance

    • name

      public static Input name(String key)
      Factory method for a name input field. InputType and hint are preset.
      Parameter:
      key - the key that can be used to receive the entered text from the bundle in SimpleDialog.OnDialogResultListener.onResult(java.lang.String, int, android.os.Bundle)
      Gibt zurück:
      this instance

    • password

      public static Input password(String key)
      Factory method for a password input field. InputType and hint are preset. Shows a button to toggle the passwords visibility
      Parameter:
      key - the key that can be used to receive the entered text from the bundle in SimpleDialog.OnDialogResultListener.onResult(java.lang.String, int, android.os.Bundle)
      Gibt zurück:
      this instance

    • pin

      public static Input pin(String key)
      Factory method for a pin input field. InputType and hint are preset.
      Parameter:
      key - the key that can be used to receive the entered text from the bundle in SimpleDialog.OnDialogResultListener.onResult(java.lang.String, int, android.os.Bundle)
      Gibt zurück:
      this instance

    • email

      public static Input email(String key)
      Factory method for an email input field. InputType and hint are preset. This field also validates, that an email matching the default pattern was entered.
      Parameter:
      key - the key that can be used to receive the entered text from the bundle in SimpleDialog.OnDialogResultListener.onResult(java.lang.String, int, android.os.Bundle)
      Gibt zurück:
      this instance

    • phone

      public static Input phone(String key)
      Factory method for a phone input field. InputType and hint are preset. This field also automatically format the phone number while the user is typing.
      Parameter:
      key - the key that can be used to receive the entered text from the bundle in SimpleDialog.OnDialogResultListener.onResult(java.lang.String, int, android.os.Bundle)
      Gibt zurück:
      this instance

    • spinner

      public static Input spinner(String key)
      Factory method for a spinner input field. This disables editing and only uses suggestions.

      Make sure to supply the items via suggest(int)

      Parameter:
      key - the key that can be used to receive the entered text from the bundle in SimpleDialog.OnDialogResultListener.onResult(java.lang.String, int, android.os.Bundle)
      Gibt zurück:
      this instance

    • spinner

      public static Input spinner(String key, @ArrayRes int suggestionArrayRes)

    • spinner

      public static Input spinner(String key, @StringRes int... suggestionStringResArray)

    • spinner

      public static Input spinner(String key, String... strings)

    • spinner

      public static Input spinner(String key, ArrayList<String> strings)

    • hint

      public Input hint(String hint)
      Sets a hint
      Parameter:
      hint - the hint as string
      Gibt zurück:
      this instance

    • hint

      public Input hint(@StringRes int hintResourceId)
      Sets a hint
      Parameter:
      hintResourceId - the hint as android string resource
      Gibt zurück:
      this instance

    • text

      public Input text(String text)
      Sets the initial text
      Parameter:
      text - initial text as string
      Gibt zurück:
      this instance

    • text

      public Input text(@StringRes int textResourceId)
      Sets the initial text
      Parameter:
      textResourceId - initial text as android string resource
      Gibt zurück:
      this instance

    • inputType

      public Input inputType(int inputType)
      Sets the input type The default is InputType.TYPE_CLASS_TEXT.
      Parameter:
      inputType - the input type. See InputType
      Gibt zurück:
      this instance

    • multiLine

      public Input multiLine()
      Sets the input type to InputType.TYPE_TEXT_FLAG_MULTI_LINE.
      Gibt zurück:
      this instance

    • multiLine

      public Input multiLine(int maxLines)
      Sets the input type to InputType.TYPE_TEXT_FLAG_MULTI_LINE and the maximum number of lines to show
      Parameter:
      maxLines - the maximum number of lines to show. If the text exceeds this number of lines, the input field will scroll vertically.
      Gibt zurück:
      this instance

    • wrap

      public Input wrap()
      Enables wrapping of lines exceeding the width of the input field.
      Gibt zurück:
      this instance

    • wrap

      public Input wrap(int maxLines)
      Enables wrapping of lines exceeding the width of the input field.
      Parameter:
      maxLines - the maximum number of lines to show. If the text exceeds this number of lines, the input field will scroll vertically.
      Gibt zurück:
      this instance

    • wrap

      public Input wrap(@Nullable Boolean wrap, int maxLines)
      Configures wrapping of lines exceeding the width of the input field.
      Parameter:
      wrap - en-/disable wrapping of lines (and dis-/enable horizontal scrolling)
      maxLines - the maximum number of lines to show. If the text exceeds this number of lines, the input field will scroll vertically.
      Gibt zurück:
      this instance

    • showPasswordToggle

      public Input showPasswordToggle()
      Displays a button to toggle the password visibility. Note that this will only work if the input type is a password. See showPasswordToggle(boolean)
      Gibt zurück:
      this instance

    • showPasswordToggle

      public Input showPasswordToggle(boolean show)
      Hide or show a button to toggle the password visibility. Note that this will only work if the input type is a password.
      Parameter:
      show - whether to show the password toggle button
      Gibt zurück:
      this instance

    • max

      public Input max(@IntRange(from=1L) int maxLength)
      Sets an upper limit to the input's text length.
      Parameter:
      maxLength - the maximum text length
      Gibt zurück:
      this instance

    • min

      public Input min(@IntRange(from=1L) int minLength)
      Sets a lower limit to the input's text length.
      Parameter:
      minLength - the minimum text length
      Gibt zurück:
      this instance

    • suggest

      public Input suggest(@ArrayRes int suggestionArrayRes)
      Provide an array resource with suggestions to be shown while the user is typing. This enables the auto-complete behaviour.
      Parameter:
      suggestionArrayRes - the string array resource to suggest
      Gibt zurück:
      this instance

    • suggest

      public Input suggest(@StringRes int... suggestionStringResArray)
      Provide an array of suggestions to be shown while the user is typing This enables the auto-complete behaviour.
      Parameter:
      suggestionStringResArray - array of string resources to suggest
      Gibt zurück:
      this instance

    • suggest

      public Input suggest(String... strings)
      Provide an array of suggestions to be shown while the user is typing This enables the auto-complete behaviour.
      Parameter:
      strings - array of strings to suggest
      Gibt zurück:
      this instance

    • suggest

      public Input suggest(ArrayList<String> strings)
      Provide an array of suggestions to be shown while the user is typing This enables the auto-complete behaviour.
      Parameter:
      strings - An ArrayList of strings to suggest
      Gibt zurück:
      this instance

    • forceSuggestion

      public Input forceSuggestion()
      Shortcut for forceSuggestion(boolean)
      Gibt zurück:
      this instance

    • forceSuggestion

      public Input forceSuggestion(boolean force)
      Specify whether this input may contain only one of the suggestions provided. If enabled, the EditText will show an error message if something else was entered. This will only take affect if suggestions were set by any of the suggest(int) methods

      If the suggestion array is small, consider using a spinner instead.

      Parameter:
      force - whether to force the input to be one of the suggestions or not
      Gibt zurück:
      this instance

    • asSpinner

      public Input asSpinner(boolean spinner)
      Make this Input field a spinner (not editable, drop down button)
      Parameter:
      spinner - whether to make this a spinner
      Gibt zurück:
      this instance

    • validatePattern

      public Input validatePattern(String pattern, @Nullable String errorMsg)
      Validate input using the supplied regular expression pattern and display an error message if the pattern does not match.
      Parameter:
      pattern - a regular expression used to validate input
      errorMsg - the error message to display, if the pattern does not match the input
      Gibt zurück:
      this instance

    • validatePattern

      public Input validatePattern(String pattern, @StringRes int errorMsgId)
      Validate input using the supplied regular expression pattern and display an error message if the pattern does not match. See validatePattern(String, String)
      Parameter:
      pattern - a regular expression used to validate input
      errorMsgId - the error message to display as string resource
      Gibt zurück:
      this instance

    • validatePatternEmail

      public Input validatePatternEmail()
      Validate input as email address. Shortcut for validatePattern(String, int).
      Gibt zurück:
      this instance

    • validatePatternStrongPassword

      public Input validatePatternStrongPassword()
      Validate input as password. The password must consists of at least 8 chars and contains at least one number, one special character, one upper and one lower case letter Shortcut for validatePattern(String, int).
      Gibt zurück:
      this instance

    • validatePatternLetters

      public Input validatePatternLetters()
      Validate input so that only upper- and lowercase letters are contained. Shortcut for validatePattern(String, int).
      Gibt zurück:
      this instance

    • validatePatternAlphanumeric

      public Input validatePatternAlphanumeric()
      Validate input to consist of alpha-numeric characters only. Shortcut for validatePattern(String, int).
      Gibt zurück:
      this instance

    • buildViewHolder

      public eltos.simpledialogfragment.form.InputViewHolder buildViewHolder()
      Beschreibung aus Klasse kopiert: FormElement
      Return your custom implementation of FormElementViewHolder here
      Angegeben von:
      buildViewHolder in Klasse FormElement<Input,eltos.simpledialogfragment.form.InputViewHolder>
      Gibt zurück:
      The view holder that can represent this form element

    • validatePattern

      protected String validatePattern(android.content.Context context, @Nullable String input)

    • getPatternError

      @Nullable protected String getPatternError(android.content.Context context)

    • getHint

      @Nullable protected String getHint(android.content.Context context)

    • getText

      @Nullable protected String getText(android.content.Context context)
      Setzt außer Kraft:
      getText in Klasse FormElement<Input,eltos.simpledialogfragment.form.InputViewHolder>

    • getSuggestions

      @Nullable protected String[] getSuggestions(android.content.Context context)

    • describeContents

      public int describeContents()
      Angegeben von:
      describeContents in Schnittstelle android.os.Parcelable
      Setzt außer Kraft:
      describeContents in Klasse FormElement<Input,eltos.simpledialogfragment.form.InputViewHolder>

    • writeToParcel

      public void writeToParcel(android.os.Parcel dest, int flags)
      Angegeben von:
      writeToParcel in Schnittstelle android.os.Parcelable
      Setzt außer Kraft:
      writeToParcel in Klasse FormElement<Input,eltos.simpledialogfragment.form.InputViewHolder>