Ein toller und anpassbarer Suchdialog mit integrierten Suchoptionen.
Fügen Sie zunächst Jitpack zur build.gradle-Datei Ihres Projekts hinzu
allprojects {
repositories {
.. .
maven { url " https://jitpack.io " }
}
}
Fügen Sie dann die Abhängigkeit in der Datei build.gradle des Moduls hinzu
dependencies {
implementation ' com.github.mirrajabi:search-dialog:1.2.4 '
}
Wenn Sie zunächst nur den einfachen Suchdialog verwenden möchten, müssen Sie durchsuchbare Elemente bereitstellen. Um dies zu erreichen, sollten Sie Searchable in Ihrem Modell implementieren.
Sie können das SampleSearchModel zum Beispiel sehen:
public class SampleSearchModel implements Searchable {
private String mTitle ;
public SampleSearchModel ( String title ) {
mTitle = title ;
}
@ Override
public String getTitle () {
return mTitle ;
}
public SampleSearchModel setTitle ( String title ) {
mTitle = title ;
return this ;
}
}
Generieren Sie nun einige Suchoptionen in Ihrer Aktivität:
private ArrayList < SampleSearchModel > createSampleData (){
ArrayList < SampleSearchModel > items = new ArrayList <>();
items . add ( new SampleSearchModel ( "First item" ));
items . add ( new SampleSearchModel ( "Second item" ));
items . add ( new SampleSearchModel ( "Third item" ));
items . add ( new SampleSearchModel ( "The ultimate item" ));
items . add ( new SampleSearchModel ( "Last item" ));
items . add ( new SampleSearchModel ( "Lorem ipsum" ));
items . add ( new SampleSearchModel ( "Dolor sit" ));
items . add ( new SampleSearchModel ( "Some random word" ));
items . add ( new SampleSearchModel ( "guess who's back" ));
return items ;
}
Dann müssen Sie nur noch die folgenden Zeilen dort hinzufügen, wo Sie den Dialog anzeigen möchten:
new SimpleSearchDialogCompat ( MainActivity . this , "Search..." ,
"What are you looking for...?" , null , createSampleData (),
new SearchResultListener < SampleSearchModel >() {
@ Override
public void onSelected ( BaseSearchDialogCompat dialog ,
SampleSearchModel item , int position ) {
// If filtering is enabled, [position] is the index of the item in the filtered result, not in the unfiltered source
Toast . makeText ( MainActivity . this , item . getTitle (),
Toast . LENGTH_SHORT ). show ();
dialog . dismiss ();
}
}). show ();
Die Konstruktorparameter sind
SimpleSearchDialogCompat ( Context context , String title , String searchHint ,
@ Nullable Filter filter , ArrayList < T > items ,
SearchResultListener < T > searchResultListener )
Verwenden Sie einfach setLoading(true)
zum Anzeigen und setLoading(false)
zum Ausblenden auf einer Instanz von SimpleSearchDialogCompat
Wenn Sie die Standardfarben ändern möchten, überschreiben Sie diese Farben einfach in Ihrer colors.xml
oder wo auch immer Sie möchten, wie folgt.
< color name = " searchDialogResultColor " />
< color name = " searchDialogResultHighlightColor " />
Ich habe dieses Layout für einen einfachen Suchdialog verwendet, Sie können aber auch alles andere verwenden. Natürlich sollte Ihr Layout diese beiden Ansichten haben:
Sie können Ihre benutzerdefinierten Layouts, Adapter und Suchoptionen verwenden, indem Sie eine Klasse erstellen, die BaseSearchDialogCompat erbt. Sehen Sie sich SimpleSearchDialogCompat an, um ein Beispiel dafür zu sehen, wie dies möglich ist. Sie sollten die BaseSearchDialogCompat-Methoden implementieren:
// handle your view with this one
protected abstract void getView ( View view );
// Id of your custom layout
@ LayoutRes protected abstract int getLayoutResId ();
// Id of the search edittext you used in your custom layout
@ IdRes protected abstract int getSearchBoxId ();
// Id of the recyclerview you used in your custom layout
@ IdRes protected abstract int getRecyclerViewId ();
Sie können Ihre benutzerdefinierten Filter für die Textsuche verwenden. Der in SimpleSearchDialogCompat verwendete ist SimpleSearchFilter. Es überprüft den Suchschlüssel und wenn ein Element und der Schlüssel teilweise genau dieselben Buchstaben hatten, wird dieses Element zu den Ergebnissen hinzugefügt. Wenn CheckLCS auf „true“ gesetzt wurde, wird außerdem geprüft, ob die Anzahl der übereinstimmenden Buchstaben größer als der angegebene AccuracyPercentage war Das Element wird den Ergebnissen hinzugefügt
die in SimpleSearchDialogCompat verwendete ist so einfach, obwohl sie zu lang ist. Die Hauptfunktionalität liegt in der Methode initializeViews. Sie können Ihre benutzerdefinierten Adapter erstellen und diese anstelle dieses verwenden
Es gibt zwei Methoden, mit denen Sie die Ergebnisse hervorheben können.
/*
* Returns a SpannableString with
* highlighted LCS(Longest Common Subsequence)
* of two strings with the givven color
*/
SpannableStringBuilder highlightLCS ( String text1 , String text2 , int highlightColor );
// Returns the LCS(Longest Common Subsequence) of two strings
String lcs ( String text1 , String text2 )
1.2.4 – Added an option to SimpleSearchDialogCompat so that the dialog cancellation on touching outside the dialog can be customized.
1.2.3 – Changed minSdkVersion to 14. Added getter for the title textview of simple search dialog. Improved results sorting.
1.2.2 – Gradle tools version and dependencies were updated.
1.2.1 – Added an option for changing text color and highlight color of default adapter.
1.2 – Added getter for views in simple search dialog and an option to turn off the auto filtering on search edittext.
1.1.1 – Fixes drawable overriding issue.
1.1 – Added loading feature.