iT邦幫忙

2022 iThome 鐵人賽

DAY 24
0
自我挑戰組

在30天利用HTML & CSS & JavaScript完成Side Project實作系列 第 24

Day 24 Side Project : Live User Filter 動態篩選器

  • 分享至 

  • xImage
  •  

今天要做的是動態篩選器


畫面和功能拆解

  1. 沒有輸入的情況下,可以看到所有的人名
  2. 每輸入一個字母,便動態篩選搜尋結果(類似 google 搜尋 bar)

運用知識點羅列

  • JS
知識點 實際應用
async await 在此處理搜尋資料的回傳
fetch API 打 randomUser API
forEach 陣列處理方法,在此用於遍歷搜尋結果
appendChild 在此將搜尋結果的子節點(li)附加到父節點(ul)上
addEventListener input 事件 監聽搜尋 bar 的任何輸入
El.classList.add(), El.classList.remove() 將符合與不符合條件的搜尋結果透過動態切換class來顯示/隱藏

流程講解

  • HTML

  <div class="container">
      <header class="header">
        <h4 class="title">Live User Filter</h4>
        <small class="subtitle">Search by name and/or location</small>
        <input type="text" id="filter" placeholder="Search">
      </header>

      <ul id="result" class="user-list">
        <li>
          <h3>Loading...</h3>
        </li>
      </ul>
    </div>
  • CSS
    大局配置
* {
  box-sizing: border-box;
}

body {
  background-color: #f8f9fd;
  font-family: 'Roboto', sans-serif;
  display: flex;
  align-items: center;
  justify-content: center;
  height: 100vh;
  overflow: hidden;
  margin: 0;
}

外部容器

.container {
  border-radius: 5px;
  box-shadow: 3px 3px 10px rgba(0, 0, 0, 0.2);
  overflow: hidden;
  width: 300px;
}

主體

.title {
  margin: 0;
}

.subtitle {
  display: inline-block;
  margin: 5px 0 20px;
  opacity: 0.8;
}

.header {
  background-color: #3e57db;
  color: #fff;
  padding: 30px 20px;
}

.header input {
  background-color: rgba(0, 0, 0, 0.3);
  border: 0;
  border-radius: 50px;
  color: #fff;
  font-size: 14px;
  padding: 10px 15px;
  width: 100%;
}

.header input:focus {
  outline: none;
}

.user-list {
  background-color: #fff;
  list-style-type: none;
  margin: 0;
  padding: 0;
  max-height: 400px;
  overflow-y: auto;
}

.user-list li {
  display: flex;
  padding: 20px;
}

.user-list img {
  border-radius: 50%;
  object-fit: cover;
  height: 50px;
  width: 50px;
}

.user-list .user-info {
  margin-left: 10px;
}

.user-list .user-info h4 {
  margin: 0 0 10px;
}

.user-list .user-info p {
  font-size: 12px;
}

.user-list li:not(:last-of-type) {
  border-bottom: 1px solid #eee;
}

.user-list li.hide {
  display: none;
}
  • JS
    *變數宣告
const result = document.getElementById('result') // 存放搜尋結果
const filter = document.getElementById('filter') // 搜尋條件過濾
const listItems = []  // 渲染搜尋結果

主體
這段主要是搜尋功能的實現,摘要成以下幾點,並有在 code 上補上註解

  1. fetch API 中的 fetch() 是一個全域的方法,會回傳一個 帶有 response 的promise 物件,fetch()中的第一個必填參數這裡是使用 https://randomuser.me/ 提供的API url ,實務上較少使用fetch()寫法,但觀念和應用是通用的,所以還是很重要!

  2. 搜尋結果的顯示,其實是利用 CSS 去把不符合條件的結果隱藏

  3. 去監聽搜尋bar,如此才能在用戶每輸入一個值就去重新篩選資料

getData()

// 監聽搜尋框的任何輸入
filter.addEventListener('input', (e) => filterData(e.target.value)) // e.target.value 抓取當前輸入的內容 

// 取得資料
async function getData() {
    const res = await fetch('https://randomuser.me/api?results=50') // 預設 50 筆搜尋結果

    const { results } = await res.json() // 解構賦值,從 JSON 中提取 results 屬性。可使用.then() .catch() 對 api 的回傳去做錯誤處理

    // 清除搜尋結果
    result.innerHTML = ''
    
    // 遍歷搜尋結果
    results.forEach(user => {
        const li = document.createElement('li') // 創建列表

        listItems.push(li)
        
        // 渲染列表內的內容
        li.innerHTML = 
            `<img src="${user.picture.large}" alt="${user.name.first}">
            <div class="user-info">
                <h4>${user.name.first} ${user.name.last}</h4>
                <p>${user.location.city}, ${user.location.country}</p>
            </div>`

        result.appendChild(li) // 將列表的內容放到 ul 中
    })
}

// 過濾資料
function filterData(searchTerm) {
    // 資料過濾邏輯是每一項資料都要檢查是否匹配
    listItems.forEach(item => {
// 以下使用 toLowerCase() 轉換成小寫,確保比較的基準一致

if(item.innerText.toLowerCase().includes(searchTerm.toLowerCase())) {
            item.classList.remove('hide') // 利用class的remove和add去隱藏不符合條件的搜尋結果
        } else {
            item.classList.add('hide')
        }
    })
}

附上codepen連結 https://codepen.io/hangineer/pen/mdLxvwJ
可以直接透過此連結來看api的回傳結果會更清楚喔~

如果有任何問題或敘述不清、錯誤之處,歡迎不吝指正 /images/emoticon/emoticon41.gif


參考資料

  1. 50 Projects In 50 Days - HTML, CSS & JavaScript
  2. JavaScript Fetch API 使用教學

上一篇
Day 23 Side Project : Verify Account UI 帳戶驗證介面
下一篇
Day 25 Side Project : Quiz App 小測驗
系列文
在30天利用HTML & CSS & JavaScript完成Side Project實作30
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

1 則留言

0
112182ssss
iT邦新手 4 級 ‧ 2023-11-16 11:00:32

請問這篇文章的js怎麼沒有解說🥹🥹🥹

看更多先前的回應...收起先前的回應...
hannnahTW iT邦新手 3 級 ‧ 2023-11-16 21:23:31 檢舉

應該是當時發文太趕😂 我再來補

非常感謝

hannnahTW iT邦新手 3 級 ‧ 2023-11-25 16:31:55 檢舉

我有補上說明和註解了,謝謝^^

感謝詳細的解說/images/emoticon/emoticon41.gif

我要留言

立即登入留言