Skip to content

Commit 25c1c48

Browse files
Added checkbox color customization and updated to v10.1.3
1 parent 83dd349 commit 25c1c48

1 file changed

Lines changed: 54 additions & 16 deletions

File tree

index.html

Lines changed: 54 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -3,14 +3,14 @@
33
<head>
44
<meta charset="UTF-8" />
55
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
6-
<title>FilePicker v10.1.2 — Android File & Directory Picker Library</title>
7-
<meta name="description" content="FilePicker is a lightweight Android file and directory picker library for Java and Kotlin apps. Supports API 23+, AndroidX, single/multiple selection, file size filters, dialog customization, and modern Android storage documentation." />
8-
<meta name="keywords" content="Android FilePicker, Android file picker library, Android directory picker, Java Android library, Kotlin Android file picker, Android storage permissions, MANAGE_EXTERNAL_STORAGE, READ_MEDIA_IMAGES, Maven Central, JitPack" />
6+
<title>FilePicker v10.1.3 — Android File & Directory Picker Library</title>
7+
<meta name="description" content="FilePicker is a lightweight Android file and directory picker library for Java and Kotlin apps. Supports API 23+, AndroidX, single/multiple selection, file size filters, checkbox color customization, dialog customization, and modern Android storage documentation." />
8+
<meta name="keywords" content="Android FilePicker, Android file picker library, Android directory picker, Java Android library, Kotlin Android file picker, Android checkbox color, Android storage permissions, MANAGE_EXTERNAL_STORAGE, READ_MEDIA_IMAGES, Maven Central, JitPack" />
99
<meta name="author" content="TutorialsAndroid" />
1010
<meta name="theme-color" content="#111827" />
1111

12-
<meta property="og:title" content="FilePicker v10.1.2 — Android File & Directory Picker Library" />
13-
<meta property="og:description" content="A modern Android file and directory picker library with API 23+ support, Maven Central, JitPack, dialog customization, file size filtering, and Play Store storage guidance." />
12+
<meta property="og:title" content="FilePicker v10.1.3 — Android File & Directory Picker Library" />
13+
<meta property="og:description" content="A modern Android file and directory picker library with API 23+ support, Maven Central, JitPack, dialog customization, checkbox color customization, file size filtering, and Play Store storage guidance." />
1414
<meta property="og:type" content="website" />
1515
<meta property="og:image" content="https://github.com/TutorialsAndroid/FilePicker/blob/master/sample/src/main/res/mipmap-xxhdpi/ic_launcher.png?raw=true" />
1616

@@ -690,14 +690,14 @@
690690
<span class="pill">📦 Maven Central</span>
691691
<span class="pill">🔗 JitPack</span>
692692
<span class="pill">⚙️ AndroidX</span>
693-
<span class="pill">🚀 v10.1.2</span>
693+
<span class="pill">🚀 v10.1.3</span>
694694
</div>
695695
<h1><span class="gradient-text">Android File Picker</span> built for modern storage.</h1>
696696
<p>
697-
FilePicker is a lightweight Android file and directory picker library for Java and Kotlin apps. It supports file selection, directory selection, single mode, multi mode, extension filtering, file size filtering, dialog themes, responsive dialog sizing, and detailed Android storage guidance for Android 11, 13, and 14+.
697+
FilePicker is a lightweight Android file and directory picker library for Java and Kotlin apps. It supports file selection, directory selection, single mode, multi mode, extension filtering, file size filtering, checkbox color customization, dialog themes, responsive dialog sizing, and detailed Android storage guidance for Android 11, 13, and 14+.
698698
</p>
699699
<div class="hero-actions">
700-
<a class="btn primary" href="#installation">Install v10.1.2</a>
700+
<a class="btn primary" href="#installation">Install v10.1.3</a>
701701
<a class="btn" href="https://github.com/TutorialsAndroid/FilePicker" target="_blank" rel="noopener">View on GitHub</a>
702702
<a class="btn sponsor" href="https://github.com/sponsors/TutorialsAndroid" target="_blank" rel="noopener">❤ Sponsor</a>
703703
</div>
@@ -747,17 +747,27 @@ <h1><span class="gradient-text">Android File Picker</span> built for modern stor
747747
<div class="card"><div class="icon">📂</div><h3>Files & folders</h3><p>Select files, directories, or both depending on your app flow.</p></div>
748748
<div class="card"><div class="icon"></div><h3>Single / multi</h3><p>Use single-selection mode or allow users to select many files.</p></div>
749749
<div class="card"><div class="icon">🎛️</div><h3>Advanced filters</h3><p>Filter by extension and file size using min/max byte limits.</p></div>
750-
<div class="card"><div class="icon">🎨</div><h3>Custom UI</h3><p>Change title, buttons, theme, dialog width, and dialog height.</p></div>
750+
<div class="card"><div class="icon">🎨</div><h3>Custom UI</h3><p>Change title, buttons, theme, checkbox colors, dialog width, and dialog height.</p></div>
751751
</div>
752752
</section>
753753

754754
<section class="section" id="features">
755755
<div class="section-head">
756756
<div class="eyebrow">What is new</div>
757-
<h2>v10.1.2 focuses on modern Android support and professional developer experience.</h2>
758-
<p>The new version improves storage behavior, dialog customization, file size filtering, stability, and documentation for Play Store-safe Android apps.</p>
757+
<h2>v10.1.3 focuses on modern Android support and professional developer experience.</h2>
758+
<p>The new version improves storage behavior, dialog customization, checkbox color customization, file size filtering, stability, and documentation for Play Store-safe Android apps.</p>
759759
</div>
760760
<div class="grid cols-3">
761+
<div class="card">
762+
<h3>v10.1.3 checkbox color customization</h3>
763+
<ul>
764+
<li>Customize checked checkbox color.</li>
765+
<li>Customize unchecked checkbox border/background color.</li>
766+
<li>Customize checkmark/tick color.</li>
767+
<li>Customize unchecked inner fill color.</li>
768+
<li>Fixes checkbox visibility issues on white or custom dialog backgrounds.</li>
769+
</ul>
770+
</div>
761771
<div class="card">
762772
<h3>v10.1.2 file size filtering</h3>
763773
<ul>
@@ -828,12 +838,12 @@ <h3>Step 1: Add Maven Central in project-level settings.gradle</h3>
828838
<h3>Step 2: Add dependency in app/build.gradle</h3>
829839
<p>Open <strong>YourProject/app/build.gradle</strong> and add the dependency in the <code>dependencies</code> block.</p>
830840
<div class="code-wrap"><div class="code-top"><span>app/build.gradle</span><button class="copy-btn">Copy</button></div><pre><code>dependencies {
831-
implementation "io.github.tutorialsandroid:filepicker:10.1.2"
841+
implementation "io.github.tutorialsandroid:filepicker:10.1.3"
832842
}</code></pre></div>
833843

834844
<h3>Kotlin DSL</h3>
835845
<div class="code-wrap"><div class="code-top"><span>app/build.gradle.kts</span><button class="copy-btn">Copy</button></div><pre><code>dependencies {
836-
implementation("io.github.tutorialsandroid:filepicker:10.1.2")
846+
implementation("io.github.tutorialsandroid:filepicker:10.1.3")
837847
}</code></pre></div>
838848
</div>
839849
</div>
@@ -853,7 +863,7 @@ <h3>Step 1: Add JitPack in project-level settings.gradle</h3>
853863

854864
<h3>Step 2: Add JitPack dependency</h3>
855865
<div class="code-wrap"><div class="code-top"><span>app/build.gradle</span><button class="copy-btn">Copy</button></div><pre><code>dependencies {
856-
implementation "com.github.TutorialsAndroid:FilePicker:v10.1.2"
866+
implementation "com.github.TutorialsAndroid:FilePicker:v10.1.3"
857867
}</code></pre></div>
858868

859869
<h3>Kotlin DSL</h3>
@@ -867,15 +877,15 @@ <h3>Kotlin DSL</h3>
867877
}
868878

869879
dependencies {
870-
implementation("com.github.TutorialsAndroid:FilePicker:v10.1.2")
880+
implementation("com.github.TutorialsAndroid:FilePicker:v10.1.3")
871881
}</code></pre></div>
872882
</div>
873883
</div>
874884

875885
<div id="minSdk" class="tab-panel">
876886
<div class="card">
877887
<h3>Minimum SDK requirement</h3>
878-
<p>FilePicker v10.1.2 requires <strong>minSdk 23</strong> or higher. Add this inside the <code>android { defaultConfig { ... } }</code> block of your app module Gradle file.</p>
888+
<p>FilePicker v10.1.3 requires <strong>minSdk 23</strong> or higher. Add this inside the <code>android { defaultConfig { ... } }</code> block of your app module Gradle file.</p>
879889
<div class="code-wrap"><div class="code-top"><span>app/build.gradle</span><button class="copy-btn">Copy</button></div><pre><code>android {
880890
namespace "com.example.yourapp"
881891
compileSdk 35
@@ -1039,6 +1049,26 @@ <h3>Custom dialog theme</h3>
10391049
&lt;/style&gt;</code></pre></div>
10401050
</div>
10411051

1052+
<div class="card">
1053+
<h3>Checkbox color customization</h3>
1054+
<p>Useful when the default checkbox is not visible on white, dark, or fully custom dialog backgrounds.</p>
1055+
<div class="code-wrap"><div class="code-top"><span>Java</span><button class="copy-btn">Copy</button></div><pre><code>import android.graphics.Color;
1056+
1057+
DialogProperties properties = new DialogProperties();
1058+
1059+
properties.selection_mode = DialogConfigs.MULTI_MODE;
1060+
properties.selection_type = DialogConfigs.DIR_SELECT;
1061+
1062+
properties.checkbox_checked_color = Color.parseColor("#6750A4");
1063+
properties.checkbox_unchecked_color = Color.parseColor("#6750A4");
1064+
properties.checkbox_checkmark_color = Color.WHITE;
1065+
properties.checkbox_unchecked_inner_color = Color.parseColor("#F3E8FF");
1066+
1067+
FilePickerDialog dialog = new FilePickerDialog(MainActivity.this, properties);
1068+
dialog.setTitle("Select Directory");
1069+
dialog.show();</code></pre></div>
1070+
</div>
1071+
10421072
<div class="card">
10431073
<h3>Dialog width and height</h3>
10441074
<p>Useful for tablets, foldables, landscape screens, and ultra-wide layouts.</p>
@@ -1149,6 +1179,10 @@ <h3>DialogProperties</h3>
11491179
<tr><td><code>error_dir</code></td><td>Fallback directory when root/offset is invalid.</td></tr>
11501180
<tr><td><code>extensions</code></td><td>Allowed file extensions.</td></tr>
11511181
<tr><td><code>show_hidden_files</code></td><td>Show or hide dot-files.</td></tr>
1182+
<tr><td><code>checkbox_checked_color</code></td><td>Color used when the checkbox is selected.</td></tr>
1183+
<tr><td><code>checkbox_unchecked_color</code></td><td>Outer color used when the checkbox is not selected.</td></tr>
1184+
<tr><td><code>checkbox_checkmark_color</code></td><td>Tick/checkmark color shown inside the selected checkbox.</td></tr>
1185+
<tr><td><code>checkbox_unchecked_inner_color</code></td><td>Inner fill color used when the checkbox is not selected.</td></tr>
11521186
<tr><td><code>min_file_size</code></td><td>Minimum allowed file size in bytes.</td></tr>
11531187
<tr><td><code>max_file_size</code></td><td>Maximum allowed file size in bytes.</td></tr>
11541188
</tbody>
@@ -1219,6 +1253,10 @@ <h2>Common questions.</h2>
12191253
<summary>Can I change dialog theme?</summary>
12201254
<p>Yes. Use the constructor that accepts a theme resource ID and pass a dialog-compatible AppCompat or Material Components theme.</p>
12211255
</details>
1256+
<details>
1257+
<summary>Can I change checkbox colors?</summary>
1258+
<p>Yes. From v10.1.3, use DialogProperties checkbox color fields to change the checked color, unchecked color, checkmark color, and unchecked inner color. This is useful when the checkbox overlaps with white or custom dialog backgrounds.</p>
1259+
</details>
12221260
<details>
12231261
<summary>Can I change dialog width and height?</summary>
12241262
<p>Yes. Use setDialogSizeByPercent for responsive sizing or setDialogSize for direct layout params and exact pixel values.</p>

0 commit comments

Comments
 (0)