From 7412079f88d8974efc7af8e45e95a42555781758 Mon Sep 17 00:00:00 2001
From: Alex <alex.tran1502@gmail.com>
Date: Fri, 21 Aug 2026 15:11:23 -0500
Subject: [PATCH] chore: search filter animation improvement and reactive
 search cue example (#30866)

* chore: better animation for search form and search cue

* better search cue example

* chore: revert mise.lock changes
---
 i18n/en.json                                  |  1 +
 .../search-bar/SearchBar.svelte               |  6 +++-
 .../search-bar/SearchFilters.svelte           | 36 +++++++++++--------
 .../search-bar/search-bar-utils.ts            | 24 +++++++++++++
 4 files changed, 52 insertions(+), 15 deletions(-)

diff --git a/i18n/en.json b/i18n/en.json
index a6dc28fba..f0761e209 100644
--- a/i18n/en.json
+++ b/i18n/en.json
@@ -1845,6 +1845,7 @@
   "search": "Search",
   "search_albums": "Search albums",
   "search_by_context": "Search by context",
+  "search_by_context_example": "Describe the photo you want to find, e.g. \"Children jumping on a trampoline\"",
   "search_by_description": "Search by description",
   "search_by_description_example": "Hiking day in Sapa",
   "search_by_filename": "Search by file name or extension",
diff --git a/web/src/lib/components/shared-components/search-bar/SearchBar.svelte b/web/src/lib/components/shared-components/search-bar/SearchBar.svelte
index fc6e6f6e2..a126a7526 100644
--- a/web/src/lib/components/shared-components/search-bar/SearchBar.svelte
+++ b/web/src/lib/components/shared-components/search-bar/SearchBar.svelte
@@ -11,6 +11,7 @@
   import { t } from 'svelte-i18n';
   import SearchFilters from './SearchFilters.svelte';
   import { searchManager } from '$lib/managers/search-manager.svelte';
+  import { getSearchTypePlaceholder } from './search-bar-utils';
 
   type Props = {
     grayTheme: boolean;
@@ -19,6 +20,9 @@
   let { grayTheme }: Props = $props();
 
   let showClearIcon = $derived(searchManager.filter.query.length > 0);
+  let placeholder = $derived(
+    searchStore.isSearchEnabled ? getSearchTypePlaceholder(searchManager.filter.queryType) : $t('search_your_photos'),
+  );
 
   let input = $state<HTMLInputElement>();
   let searchFilters = $state<ReturnType<typeof SearchFilters>>();
@@ -145,7 +149,7 @@
         {grayTheme || showSuggestions ? 'dark:bg-immich-dark-gray' : 'dark:bg-immich-dark-bg'}
         {showSuggestions ? 'rounded-t-3xl shadow-[0_8px_20px_rgba(0,0,0,0.12)]' : 'rounded-3xl bg-gray-200'}
         {searchStore.isSearchEnabled ? 'border-light-200 bg-white dark:border-dark-600' : 'border-transparent'}"
-        placeholder={$t('search_your_photos')}
+        {placeholder}
         required
         pattern="^(?!m:$).*$"
         bind:value={searchManager.filter.query}
diff --git a/web/src/lib/components/shared-components/search-bar/SearchFilters.svelte b/web/src/lib/components/shared-components/search-bar/SearchFilters.svelte
index a3dc10a6d..d475eeb21 100644
--- a/web/src/lib/components/shared-components/search-bar/SearchFilters.svelte
+++ b/web/src/lib/components/shared-components/search-bar/SearchFilters.svelte
@@ -62,6 +62,7 @@
   let searchHistory = $state<SearchHistorySection>();
 
   let activeFilter = $state('type');
+  let showAdvanced = $state(false);
   let peoplePromise = $state<Promise<PersonResponseDto[]>>();
   let people = $state<PersonResponseDto[]>();
   let tagsPromise = $state<Promise<TagResponseDto[]>>();
@@ -187,7 +188,7 @@
 <div role="listbox" {id}>
   {#if isOpen}
     <div
-      transition:fly={{ y: 25, duration: 150 }}
+      transition:fly={{ y: 25, duration: 250 }}
       class="absolute z-1 w-full rounded-b-3xl bg-white shadow-[0_8px_20px_rgba(0,0,0,0.12)] transition-all dark:bg-immich-dark-gray dark:text-gray-300"
     >
       <SearchHistorySection
@@ -212,16 +213,7 @@
           {/each}
         </div>
       </div>
-      {#if activeFilter === 'advanced'}
-        <div class="my-5 h-px w-full bg-light-200 dark:bg-dark-600"></div>
-        <div class="px-5">
-          <SearchCameraSection />
-          {#if authManager.authenticated && authManager.preferences.ratings.enabled}
-            <SearchRatingsSection />
-          {/if}
-          <SearchDisplaySection />
-        </div>
-      {:else if activeFilter}
+      {#if activeFilter}
         <div class="px-5 pt-5">
           {#if activeFilter === 'type'}
             <SearchTextSection />
@@ -238,15 +230,31 @@
           {/if}
         </div>
       {/if}
+      <div
+        class="grid transition-[grid-template-rows] duration-200 ease-in-out {showAdvanced
+          ? 'grid-rows-[1fr]'
+          : 'grid-rows-[0fr]'}"
+        inert={!showAdvanced}
+      >
+        <div class="overflow-hidden">
+          <div class="my-5 h-px w-full bg-light-200 dark:bg-dark-600"></div>
+          <div class="px-5">
+            <SearchCameraSection />
+            {#if authManager.authenticated && authManager.preferences.ratings.enabled}
+              <SearchRatingsSection />
+            {/if}
+            <SearchDisplaySection />
+          </div>
+        </div>
+      </div>
       <div class="my-5 h-px w-full bg-light-200 dark:bg-dark-600"></div>
       <div class="flex gap-2 px-5 pb-5">
         <Button
           size="small"
           variant={advancedFiltersSet ? 'outline' : 'ghost'}
           leadingIcon={mdiTune}
-          trailingIcon={activeFilter === 'advanced' ? mdiChevronUp : mdiChevronDown}
-          onclick={() => (activeFilter = activeFilter === 'advanced' ? '' : 'advanced')}
-          >{$t('advanced_filters')}</Button
+          trailingIcon={showAdvanced ? mdiChevronUp : mdiChevronDown}
+          onclick={() => (showAdvanced = !showAdvanced)}>{$t('advanced_filters')}</Button
         >
         <div class="flex-1"></div>
         <Button
diff --git a/web/src/lib/components/shared-components/search-bar/search-bar-utils.ts b/web/src/lib/components/shared-components/search-bar/search-bar-utils.ts
index 4dd99edbb..9ae4fe0df 100644
--- a/web/src/lib/components/shared-components/search-bar/search-bar-utils.ts
+++ b/web/src/lib/components/shared-components/search-bar/search-bar-utils.ts
@@ -95,6 +95,30 @@ export const getSearchTypeTitle = (type: string) => {
   }
 };
 
+export const getSearchTypePlaceholder = (type: string) => {
+  const $t = get(t);
+  switch (type) {
+    case 'metadata': {
+      return $t('search_by_filename_example');
+    }
+    case 'description': {
+      return $t('search_by_description_example');
+    }
+    case 'fullPath': {
+      return $t('search_by_full_path_example');
+    }
+    case 'ocr': {
+      return $t('search_by_ocr_example');
+    }
+    case 'smart': {
+      return $t('search_by_context_example');
+    }
+    default: {
+      return $t('search_your_photos');
+    }
+  }
+};
+
 export const getSearchPlacesTitle = (city?: string, state?: string, country?: string) =>
   [city, state, country].filter(Boolean).join(', ') || undefined;