El Arsenal de Android: Preferencias

? Instalación

Agréguelo al archivo de la aplicación build.gradle :

  implementación   & # 39;  com.github.imangazalievm.material -prefs: core: [19659005] & # 39; 
  implementación  & # 39;  com.github.imangazalievm.material-prefs: dialogs:   & # 39; 
  implementación  & # 39;  com.github.imangazalievm.material-prefs: date-time:   & # 39; 
  implementación  & # 39;  com.github.imangazalievm.material-prefs: color-picker:   & # 39; 

⭐ Características

• Comodo y DSL extensible
• Configuraciones de apariencia flexibles
• Ver Unificado en Lollipop y Pre-Lollipop
• Posibilidad de usar almacenamiento personalizado
• Preferencias predeterminadas
• Temas claros y oscuros

? Uso [19659002] Para comenzar a usar la biblioteca debe realizar 3 pasos simples:

1. Agregar MaterialPreferencesView en el diseño
2. Proporcionar almacenamiento de preferencias: 3.1 Almacenamiento predeterminado – 3.1 Cualquier memoria personalizada que implemente la interfaz PreferencesStorage DefaultPreferencesStorage

3. Crear pantalla de preferencias mediante MaterialPrefs DSL

Si desea utilizar DefaultPreferencesStorage necesita Suministro los valores iniciales a través de DefaultValuesContainer .

Paso 1 Coloque MaterialPreferencesView en el diseño:

  < com  .imangazalievm. materialprefs.views.MaterialPreferencesView
         android :  id  =   " @ + id / prefsView " 
   android :  layout_width  =   " match_parent " 
   android :  layout_height  =   " match_parent "    /> [19659043] Paso 2  Cree el archivo de preferencias y proporcione los valores iniciales: 
 
  val  defValues ​​ =  defaultPrefValues ​​{
      " my_string "    a   " Jhon Doe " 
    " my_int "    a  99 
      " my_long "    a  5L 
      " my_float "    a  2.5f 
      " my_boolean "    a  verdadero 
}

 val  almacenamiento  =  defaultPrefsStorage (  " my_prefs "  defValues) 

  Paso 3  Agregar elementos pref a través de MaterialPrefs DSL: [19659056] prefs (prefsView, almacenamiento) {

categoría (  " Mi categoría " ) {

preferencia {

título (  " Mi entrada de preferencia " )

icono ( R  .drawable.my_icon)

al hacer clic {

  //  mi acción 

}

}

}

}

? Documentación

La biblioteca incluye 4 módulos:

• core – contiene el código principal: preferencias simples, casilla de verificación, conmutador
• diálogos – diálogos prefs: opción única y múltiple
• fecha-hora – selectores de fecha y hora
• selector de color – selector de color

Últimos tres módulos basados ​​en la biblioteca de colores diálogos materiales.

Núcleo

Preferencia simple:

  preferencia {
    título (  " Título " )
    resumen (  " Mi descripción " )
    icono ( R  .drawable.ic_my_icon)
    showArrow ( verdadero )
    al hacer clic {
          //  mi acción 
    }
} 

Interruptor:

  interruptor (  " my_key " ) {
    título (  " Título " )
    resumen (  " Mi descripción " )
    onChecked {isChecked  - > 
          //  mi acción 
    }
} 

Casilla de verificación:

  casilla de verificación (  " my_key " ) {
    título (  " Título " )
    resumen (  " Mi descripción " )
    onChecked {isChecked  - > 
          //  mi acción 
    }
} 

Preferencia de etiqueta:

  labelPreference (  " my_key "   String  ::  class ) {
    título (  " Título " )
    al hacer clic {
          //  mi acción 
    }
} 

Diálogos

Opción única:

  listSingleChoice (  " my_key "   Cadena  ::  clase  ) {
    título (  " Título " )
    icono ( R  .drawable.ic_my_icon)
    showRadioButtons ( true )
    elementos(
         listOf  (
             ListItem  (  " ar "    " Árabe " ),
             ListItem  (  " en "    " Inglés " ),
             ListItem  (  " ru "    " Ruso " )
        )
    )
} 

Opción múltiple:

  listMultiChoice (  " my_key "   String  ::  clase ) {
    título (  " Título " )
    allowEmptySelection ( falso )
      //  obligatorio 
    listValuesSerializer {it.joinToString ()}
      //  obligatorio 
    listValuesDeserializer {
         si  (it.isNotEmpty ()) {
            it.split (  "" )
                .map {número  - >  número.trim (). toInt ()}
        }  más  emptyList ()
    }
    elementos(
         listOf  (
             ListItem  (  " one "    " Item 1 " ),
             ListItem  (  " dos "    " Item 2 " ),
             ListItem  (  " tres "    " Item 3 " )
        )
    )
} 

Entrada de texto:

  textInput (  " my_key " ) {
    título (  " Título " )
    icono ( R  .drawable.ic_username)
    onNewInput {
          //  mi acción 
    }
} 

DateTime

Selector de fecha:

  datePicker (  " my_key " ) {
    título (  " Título " )
     val  formateador  =    SimpleDateFormat  (  " dd.MM.yyyy "   Local .  Estados Unidos )
    valuePresenter {formatter.format (it)}
    onValueSelected {
          //  mi acción 
    }
} 

Selector de tiempo:

  timePicker (  " my_key " ) {
    título (  " Título " )
     val  formateador  =    SimpleDateFormat  (  " hh: mm "   Local .  EE. UU. )
    valuePresenter {formatter.format (it)}
    onValueSelected {
          //  mi acción 
    }
} 

Fecha y selección:

  dateTimePicker (  " my_key " ) {
    título (  " Título " )
     val  formateador  =    SimpleDateFormat  (  " hh: mm dd.MM.yyyy "   Configuración regional  .  Estados Unidos )
    valuePresenter {formatter.format (it)}
    onValueSelected {
          //  mi acción 
    }
} 

ColorPicker

  colorPicker (  " my_key " ) {
    título (  " Título " )
     val  colores  =  intArrayOf ( Color .  ROJO   Color .  VERDE   Color .  AZUL )
    colores (colores)
    onColorSelected {
          //  mi acción 
    }
} 

Elemento de preferencia personalizado

Para crear un elemento de preferencia personalizado, debe realizar 3 pasos:

Paso 1: Crear la clase de vista de preferencias heredada de PreferenceView o BasePreferenceView . (
contexto : Contexto ,
attrs : AttributeSet ? = nulo ,
themeResId : Int = 0
) : BasePreferenceView (context, attrs, themeResId) {

anular diversión createValueView ( padre : ViewGroup ) : Ver {
return parent.inflate ( R .layout.my_pref_view)
}

}