[{"data":1,"prerenderedAt":3494},["ShallowReactive",2],{"all-posts":3,"post:\u002Fithome-2025-day-14":1210},[4,23,35,46,57,68,80,91,102,114,126,138,149,160,171,182,193,204,215,226,237,248,258,268,278,288,298,308,319,330,341,354,368,380,390,400,411,421,431,441,451,461,471,481,491,501,511,521,531,541,551,561,571,581,591,601,611,621,631,641,651,661,675,691,704,719,731,742,752,762,772,782,792,802,812,822,832,842,852,862,871,881,891,901,911,921,931,941,951,961,971,980,990,1000,1010,1020,1036,1050,1062,1073,1083,1095,1107,1121,1134,1145,1156,1167,1180,1191,1201],{"path":5,"title":6,"description":7,"date":8,"updated":9,"tags":10,"categories":14,"draft":15,"wordCount":16,"readingTime":17,"canonical":18,"series":19},"\u002Fithome-2026-day-30","Day 30：Angular Router Providers 與生命週期管理，路由離開後 Service 會銷毀嗎？","平常在 Angular 中，我們可以透過 providers 決定 Service 的注入範圍。例如註冊在 Root，讓整個 Application 共用同一個實例；或註冊在 Component，讓 Service 隨著…","2026-10-14T14:46:39+08:00",null,[11,12,13],"iThome 鐵人賽","2026 鐵人賽","Angular",[11,13],false,7227,7,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10424222",{"name":20,"url":21,"day":22},"2026 iThome 鐵人賽：Angular 22 Signal 進化論","https:\u002F\u002Fithelp.ithome.com.tw\u002Fusers\u002F20116554\u002Fironman\u002F9939",30,{"path":24,"title":25,"description":26,"date":27,"updated":9,"tags":28,"categories":29,"draft":15,"wordCount":30,"readingTime":31,"canonical":32,"series":33},"\u002Fithome-2026-day-29","Day 29：Angular 也有 VueUse？使用 Signality 整合常見 Browser API","在 Vue 生態系中，VueUse 提供許多 Composables，讓我們可以快速使用瀏覽器功能，例如監聽網路狀態、保存使用者設定，或偵測元素是否進入可視範圍。","2026-10-13T23:14:18+08:00",[11,12,13],[11,13],6387,6,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10424070",{"name":20,"url":21,"day":34},29,{"path":36,"title":37,"description":38,"date":39,"updated":9,"tags":40,"categories":41,"draft":15,"wordCount":42,"readingTime":31,"canonical":43,"series":44},"\u002Fithome-2026-day-28","Day 28：Angular 動態建立 Component，NgComponentOutlet 與 ViewContainerRef","平常在 Angular 中使用 Component，通常會直接在 Template 裡面宣告：","2026-10-12T17:27:41+08:00",[11,12,13],[11,13],6565,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10423641",{"name":20,"url":21,"day":45},28,{"path":47,"title":48,"description":49,"date":50,"updated":9,"tags":51,"categories":52,"draft":15,"wordCount":53,"readingTime":17,"canonical":54,"series":55},"\u002Fithome-2026-day-27","Day 27：NgRx Store vs SignalStore，從 Action、Reducer 到直接更新 State","前幾天我們使用 NgRx SignalStore 實作購物車，透過 withState() 管理商品資料、withComputed() 計算總金額，再利用 withMethods() 與 patchState() 更新 …","2026-10-11T20:06:41+08:00",[11,12,13],[11,13],7308,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10423362",{"name":20,"url":21,"day":56},27,{"path":58,"title":59,"description":60,"date":61,"updated":9,"tags":62,"categories":63,"draft":15,"wordCount":64,"readingTime":17,"canonical":65,"series":66},"\u002Fithome-2026-day-26","Day 26：SignalStore 與 Strategy Pattern，透過 DI 動態切換業務邏輯","昨天我們使用 Angular 原生 Signal 與 NgRx SignalStore 實作購物車，透過 State 管理商品資料，再利用 Computed 計算商品數量與總金額。","2026-10-10T22:01:59+08:00",[11,12,13],[11,13],7347,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10423116",{"name":20,"url":21,"day":67},26,{"path":69,"title":70,"description":71,"date":72,"updated":9,"tags":73,"categories":74,"draft":15,"wordCount":75,"readingTime":76,"canonical":77,"series":78},"\u002Fithome-2026-day-25","Day 25：Angular SignalStore，原生 Signal 不夠用嗎？","在 Angular 開發中，如果資料只會被單一 Component 使用，通常可以直接透過 signal() 管理。但當多個 Component 需要共用同一份資料時，就得考慮狀態應該放在哪裡。","2026-10-09T21:28:45+08:00",[11,12,13],[11,13],9117,9,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10422784",{"name":20,"url":21,"day":79},25,{"path":81,"title":82,"description":83,"date":84,"updated":9,"tags":85,"categories":86,"draft":15,"wordCount":87,"readingTime":31,"canonical":88,"series":89},"\u002Fithome-2026-day-24","Day 24：SPA Router 為什麼不再只靠 History API？","平常使用 Angular Router 時，可以透過 routerLink 或 router.navigate() 切換不同頁面。","2026-10-08T14:30:47+08:00",[11,12,13],[11,13],6330,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10422348",{"name":20,"url":21,"day":90},24,{"path":92,"title":93,"description":94,"date":95,"updated":9,"tags":96,"categories":97,"draft":15,"wordCount":98,"readingTime":17,"canonical":99,"series":100},"\u002Fithome-2026-day-23","Day 23：RouteReuseStrategy，切換路由一定要銷毀 Component 嗎？","在後台系統中，很常會看到頁籤式介面，例如：","2026-10-07T15:58:32+08:00",[11,12,13],[11,13],7361,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10422016",{"name":20,"url":21,"day":101},23,{"path":103,"title":104,"description":105,"date":106,"updated":9,"tags":107,"categories":108,"draft":15,"wordCount":109,"readingTime":110,"canonical":111,"series":112},"\u002Fithome-2026-day-22","Day 22：Angular Render Lifecycle，從 afterNextRender 到 DestroyRef","過去在 Angular 中，只要遇到初始化、View 建立或資源清理，通常會先想到 Lifecycle Hooks：","2026-10-06T23:36:23+08:00",[11,12,13],[11,13],8111,8,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10421810",{"name":20,"url":21,"day":113},22,{"path":115,"title":116,"description":117,"date":118,"updated":9,"tags":119,"categories":120,"draft":15,"wordCount":121,"readingTime":122,"canonical":123,"series":124},"\u002Fithome-2026-day-21","Day 21：Angular Template 還適合呼叫 Method 嗎？從 Pipe、RxJS 到 computed","過去在寫 Angular 時，因為 Template 可以直接呼叫 Method，很容易在專案裡看到大量這樣的寫法。","2026-10-05T23:30:32+08:00",[11,12,13],[11,13],5431,5,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10421425",{"name":20,"url":21,"day":125},21,{"path":127,"title":128,"description":129,"date":130,"updated":9,"tags":131,"categories":132,"draft":15,"wordCount":133,"readingTime":134,"canonical":135,"series":136},"\u002Fithome-2026-day-20","Day 20：Signal Forms 非同步驗證，validateHttp 與 validateAsync","前兩篇介紹了 Signal Forms 的基本驗證，以及需要參考其他欄位的 Cross-field Validation。","2026-10-04T20:56:17+08:00",[11,12,13],[11,13],4278,4,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10420910",{"name":20,"url":21,"day":137},20,{"path":139,"title":140,"description":141,"date":142,"updated":9,"tags":143,"categories":144,"draft":15,"wordCount":145,"readingTime":134,"canonical":146,"series":147},"\u002Fithome-2026-day-19","Day 19：Signal Forms Cross-field Validation 與欄位更新時機","上一篇介紹 Signal Forms 時，已經看到可以透過 Schema 定義欄位驗證，例如 required()、email()、minLength()。","2026-10-03T23:18:26+08:00",[11,12,13],[11,13],3783,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10420631",{"name":20,"url":21,"day":148},19,{"path":150,"title":151,"description":152,"date":153,"updated":9,"tags":154,"categories":155,"draft":15,"wordCount":156,"readingTime":31,"canonical":157,"series":158},"\u002Fithome-2026-day-18","Day 18：Angular Signal Forms 穩定了，跟我們用了這麼久的 Reactive Forms 到底差在哪？","在 Angular 中處理表單，很多專案使用的都是 Reactive Forms。","2026-10-02T23:28:36+08:00",[11,12,13],[11,13],5886,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10420249",{"name":20,"url":21,"day":159},18,{"path":161,"title":162,"description":163,"date":164,"updated":9,"tags":165,"categories":166,"draft":15,"wordCount":167,"readingTime":31,"canonical":168,"series":169},"\u002Fithome-2026-day-17","Day 17：effect() 不是拿來同步 Signal 的，Angular 的 Side Effect 該怎麼寫？","effect() 是 Angular signal 裡很容易被誤用的一個 API。因為寫法直覺，只要讀取 signal，就能在值改變時執行一些事情，所以很常被拿來同步狀態、打 API，甚至再去修改其他 signal。","2026-10-01T21:22:13+08:00",[11,12,13],[11,13],6473,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10419779",{"name":20,"url":21,"day":170},17,{"path":172,"title":173,"description":174,"date":175,"updated":9,"tags":176,"categories":177,"draft":15,"wordCount":178,"readingTime":31,"canonical":179,"series":180},"\u002Fithome-2026-day-16","Day 16：即將登場的 Route Resources，Angular Router 為什麼需要新的資料載入方式？","過去在 Angular Router 中，如果希望進入 Component 前先完成資料載入，可以透過 Resolver，讓資料取得流程在 Component 初始化之前執行。","2026-09-30T23:12:05+08:00",[11,12,13],[11,13],6534,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10419409",{"name":20,"url":21,"day":181},16,{"path":183,"title":184,"description":185,"date":186,"updated":9,"tags":187,"categories":188,"draft":15,"wordCount":189,"readingTime":17,"canonical":190,"series":191},"\u002Fithome-2026-day-15","Day 15：搞懂 Injection Context，從 inject()、runInInjectionContext() 到 injectAsync()","前面提到 Injection Context 時，可能會讓人聯想到先前介紹過的 Reactive Context。我一開始也有點搞混，因此花了一些時間重新理解 Angular 裡這些不同的執行環境。","2026-09-29T13:44:28+08:00",[11,12,13],[11,13],6986,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10418752",{"name":20,"url":21,"day":192},15,{"path":194,"title":195,"description":196,"date":197,"updated":9,"tags":198,"categories":199,"draft":15,"wordCount":200,"readingTime":17,"canonical":201,"series":202},"\u002Fithome-2026-day-14","Day 14：Lazy Loading 不只一種，從 Router Preloading、@defer 到 injectAsync()","當 Client Side Rendering 的應用越來越大時，我們通常會開始思考，能不能把原本一次載入的內容拆得更小，等到真正需要時再下載，避免初始載入過多 JavaScript，拉長畫面呈現的時間。","2026-09-28T22:44:46+08:00",[11,12,13],[11,13],7674,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10418485",{"name":20,"url":21,"day":203},14,{"path":205,"title":206,"description":207,"date":208,"updated":9,"tags":209,"categories":210,"draft":15,"wordCount":211,"readingTime":110,"canonical":212,"series":213},"\u002Fithome-2026-day-13","Day 13：從 Router Event 到 Signal","路由狀態管理在前端開發中比較少被單獨拿出來討論，但在 Angular 裡，一次路由導航其實會經過不少階段，也會在過程中發出不同的 Router Event，例如 NavigationStart、NavigationEnd…","2026-09-27T20:37:55+08:00",[11,12,13],[11,13],7777,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10417948",{"name":20,"url":21,"day":214},13,{"path":216,"title":217,"description":218,"date":219,"updated":9,"tags":220,"categories":221,"draft":15,"wordCount":222,"readingTime":122,"canonical":223,"series":224},"\u002Fithome-2026-day-12","Day 12：從 httpResource 到 TanStack Query，認識 Server State","前面我們花了不少時間討論，為什麼「請求本身的狀態」和「元件的顯示狀態」應該分開處理。","2026-09-26T23:35:12+08:00",[11,12,13],[11,13],5119,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10417614",{"name":20,"url":21,"day":225},12,{"path":227,"title":228,"description":229,"date":230,"updated":9,"tags":231,"categories":232,"draft":15,"wordCount":233,"readingTime":122,"canonical":234,"series":235},"\u002Fithome-2026-day-11","Day 11：用 rxResource 串起 Observable 與 Resource","前面介紹了不少 Resource 到 httpResource() 的應用。不過在 Angular 開發中，Observable 與 RxJS 仍然是很常見的非同步資料處理方式，像是 switchMap、map、debo…","2026-09-25T22:42:04+08:00",[11,12,13],[11,13],4908,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10417143",{"name":20,"url":21,"day":236},11,{"path":238,"title":239,"description":240,"date":241,"updated":9,"tags":242,"categories":243,"draft":15,"wordCount":244,"readingTime":31,"canonical":245,"series":246},"\u002Fithome-2026-day-10","Day 10：linkedSignal 讓相依狀態也能被修改","昨天我們透過 httpResource() 搭配 chain() 處理兩個非同步資料之間的依賴。下游 Request 需要使用上游資料時，會等上游完成後再繼續；當 Request 的來源改變，Resource 的狀態也會…","2026-09-24T23:49:49+08:00",[11,12,13],[11,13],5623,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10416746",{"name":20,"url":21,"day":247},10,{"path":249,"title":250,"description":251,"date":252,"updated":9,"tags":253,"categories":254,"draft":15,"wordCount":255,"readingTime":134,"canonical":256,"series":257},"\u002Fithome-2026-day-09","Day 9：httpResource 實務篇，統一回覆格式與 chain 相依請求","昨天我們透過 Orval 串起 API Contract，了解如何根據 OpenAPI 規格產生前端需要的型別與 API 呼叫方式。","2026-09-23T23:42:40+08:00",[11,12,13],[11,13],4358,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10416227",{"name":20,"url":21,"day":76},{"path":259,"title":260,"description":261,"date":262,"updated":9,"tags":263,"categories":264,"draft":15,"wordCount":265,"readingTime":122,"canonical":266,"series":267},"\u002Fithome-2026-day-08","Day 8：用 Orval 串起 Angular API Contract，同時產生 HttpClient、httpResource 與 Zod","前後端在對接 API 時，常見的問題之一，就是雙方對資料格式的定義逐漸不一致。","2026-09-22T23:48:12+08:00",[11,12,13],[11,13],4451,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10415694",{"name":20,"url":21,"day":110},{"path":269,"title":270,"description":271,"date":272,"updated":9,"tags":273,"categories":274,"draft":15,"wordCount":275,"readingTime":17,"canonical":276,"series":277},"\u002Fithome-2026-day-07","Day 7：從 Resource 到 httpResource，用 Signal 管理 HTTP 資料請求","昨天我們提到，Resource API 本身是一套通用的非同步資料模型，比較適合用在「讀取資料」這類情境，而不是新增、修改或刪除資料這種 Mutation 操作。","2026-09-21T22:13:18+08:00",[11,12,13],[11,13],6735,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10415038",{"name":20,"url":21,"day":17},{"path":279,"title":280,"description":281,"date":282,"updated":9,"tags":283,"categories":284,"draft":15,"wordCount":285,"readingTime":122,"canonical":286,"series":287},"\u002Fithome-2026-day-06","Day 6：Resource API，把非同步資料帶進 Signal","今天來看 Angular Signal 裡一個很重要的非同步資料 API：Resource API。","2026-09-20T19:25:37+08:00",[11,12,13],[11,13],5054,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10414377",{"name":20,"url":21,"day":31},{"path":289,"title":290,"description":291,"date":292,"updated":9,"tags":293,"categories":294,"draft":15,"wordCount":295,"readingTime":134,"canonical":296,"series":297},"\u002Fithome-2026-day-05","Day 5：從 Reactive Graph 到 View Tree，看 Angular 如何找到真正需要更新的畫面","前面我們已經知道，當 Signal 的值發生變化後，Angular 會透過 Reactive Graph 找到受到影響的 Consumer。","2026-09-19T20:19:47+08:00",[11,12,13],[11,13],4364,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10413852",{"name":20,"url":21,"day":122},{"path":299,"title":300,"description":301,"date":302,"updated":9,"tags":303,"categories":304,"draft":15,"wordCount":305,"readingTime":122,"canonical":306,"series":307},"\u002Fithome-2026-day-04","Day 4：Angular 怎麼知道誰正在讀 Signal？從 Reactive Context 理解依賴追蹤","前面我們看過，當 Template 讀取 Signal 時，Angular 會記住「誰依賴了誰」；當 Signal 發生變化後，也會透過 Reactive Graph 通知相關的 Consumer。","2026-09-18T21:58:16+08:00",[11,12,13],[11,13],4894,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10413313",{"name":20,"url":21,"day":134},{"path":309,"title":310,"description":311,"date":312,"updated":9,"tags":313,"categories":314,"draft":15,"wordCount":315,"readingTime":122,"canonical":316,"series":317},"\u002Fithome-2026-day-03","Day 3：從 set()、update() 看懂 Angular Signal 的基本使用與更新機制","昨天我們先試著理解，在 Template 中使用 Signal() 時，Angular 是如何建立依賴關係，並在 Signal 發生變化後，知道哪些 View 可能受到影響。","2026-09-17T23:08:58+08:00",[11,12,13],[11,13],5451,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10412826",{"name":20,"url":21,"day":318},3,{"path":320,"title":321,"description":322,"date":323,"updated":9,"tags":324,"categories":325,"draft":15,"wordCount":326,"readingTime":134,"canonical":327,"series":328},"\u002Fithome-2026-day-02","Day 2：Angular Signal 是什麼？從 Change Detection 理解它的運作原理","傳統 Angular 在監測資料變化時，通常會搭配 zone.js。像是 DOM 事件、Promise、Timer、HTTP 請求這些非同步操作發生時，zone.js 會幫忙攔截。","2026-09-16T20:19:12+08:00",[11,12,13],[11,13],4276,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10411944",{"name":20,"url":21,"day":329},2,{"path":331,"title":332,"description":333,"date":334,"updated":9,"tags":335,"categories":336,"draft":15,"wordCount":337,"readingTime":329,"canonical":338,"series":339},"\u002Fithome-2026-day-01","Day 1：為什麼想聊 Angular Signal？","相信講到前端框架，大家第一時間想到的通常會是 Vue、React，甚至也有人會推薦 Svelte 這類近年討論度很高的框架。但一講到 Angular，很多人的第一印象可能就像看到一座大城堡一樣：東西很多、規則很多，一時之…","2026-09-15T23:56:26+08:00",[11,12,13],[11,13],1478,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10411425",{"name":20,"url":21,"day":340},1,{"path":342,"title":343,"description":344,"date":345,"updated":9,"tags":346,"categories":351,"draft":15,"wordCount":353,"readingTime":134,"canonical":9,"series":9},"\u002FTS-Excess-Property-Checks","TypeScript 踩坑筆記：物件字面量的多餘屬性檢查機制","深入探討 TypeScript 的多餘屬性檢查（Excess Property Checks）機制，解析物件字面量與變數賦值的型別檢查差異，並提供實務開發中避免型別陷阱的最佳實踐方法。","2026-01-31T16:29:23+08:00",[347,348,349,350],"Excess Property Checks","Structural Typing","Type Safety","NestJS",[352],"TypeScript",3551,{"path":355,"title":356,"description":357,"date":358,"updated":9,"tags":359,"categories":361,"draft":15,"wordCount":363,"readingTime":329,"canonical":364,"series":365},"\u002Fithome-2025-day-30","Day 30：開發之旅完結 - 感謝與展望","終於來到鐵人賽的最後一天！這是我第二次參加鐵人賽，今年的主題是 LINE Bot 開發。這個主題源自於我參加的十二週讀書會分享，當時我發現大家對 LINE Bot 很感興趣，而我自己也一直很喜歡這個主題，於是早在六月就定…","2025-10-13T20:11:12+08:00",[11,360],"2025 鐵人賽",[11,362],"Line Bot",1751,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10396850",{"name":366,"url":367,"day":22},"2025 iThome 鐵人賽：Line Bot × NestJS：30 天開發日記","https:\u002F\u002Fithelp.ithome.com.tw\u002Fusers\u002F20116554\u002Fironman\u002F8779",{"path":369,"title":370,"description":371,"date":372,"updated":9,"tags":373,"categories":376,"draft":15,"wordCount":377,"readingTime":31,"canonical":378,"series":379},"\u002Fithome-2025-day-29","Day 29：LIFF 會員註冊 - 信箱驗證與 Swagger 文件整合","延續 Day 28 會員註冊的流程，在實際的會員註冊場景中，電子信箱驗證是確保用戶身份真實性的重要環節。本篇將基於昨天的註冊流程，新增兩個核心 API：發送驗證信與驗證驗證碼，讓會員註冊功能更加完整且安全。","2025-10-12T23:15:00+08:00",[11,360,362,374,350,375],"LIFF","Swagger",[11,362],6089,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10396512",{"name":366,"url":367,"day":34},{"path":381,"title":382,"description":383,"date":384,"updated":9,"tags":385,"categories":386,"draft":15,"wordCount":387,"readingTime":122,"canonical":388,"series":389},"\u002Fithome-2025-day-28","Day 28：LIFF 會員註冊 - ID Token 驗證與資料庫整合","今天的開發重點是建立會員卡系統，將 LIFF 前端與 NestJS 後端完整串接。","2025-10-11T22:57:29+08:00",[11,360,362,374,350],[11,362],5254,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10396146",{"name":366,"url":367,"day":45},{"path":391,"title":392,"description":393,"date":394,"updated":9,"tags":395,"categories":396,"draft":15,"wordCount":397,"readingTime":318,"canonical":398,"series":399},"\u002Fithome-2025-day-27","Day 27：群組事件與檔案訊息接收","今天主要補充 LINE Bot 在群組中的專屬特性，包括群組限定的 Webhook 事件，以及前面提到但尚未說明的第 7 種訊息類型 file 檔案訊息。","2025-10-10T21:01:52+08:00",[11,360,362,350],[11,362],2888,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10395785",{"name":366,"url":367,"day":56},{"path":401,"title":402,"description":403,"date":404,"updated":9,"tags":405,"categories":407,"draft":15,"wordCount":408,"readingTime":122,"canonical":409,"series":410},"\u002Fithome-2025-day-26","Day 26：LINE Pay 線上付款","LINE Pay 提供兩種付款方式：線上付款與實體付款。實體付款主要採用店家出示條碼的模式，顧客掃描後即可輸入金額完成付款。這兩種付款方式都支援在沙盒(Sandbox)環境中進行測試。本文將著重說明線上付款的整合流程。","2025-10-09T23:39:32+08:00",[11,360,406],"Line Pay",[11,362],4876,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10395481",{"name":366,"url":367,"day":67},{"path":412,"title":413,"description":414,"date":415,"updated":9,"tags":416,"categories":417,"draft":15,"wordCount":418,"readingTime":318,"canonical":419,"series":420},"\u002Fithome-2025-day-25","Day 25：優惠券設定與 Coupon Message 實作","LINE Official Account 的「優惠券」是提升顧客互動與忠誠度的重要功能。透過獎勵機制，不僅能吸引新客，更能有效促進回購。","2025-10-08T23:49:32+08:00",[11,360,362,350],[11,362],3207,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10395076",{"name":366,"url":367,"day":79},{"path":422,"title":423,"description":424,"date":425,"updated":9,"tags":426,"categories":427,"draft":15,"wordCount":428,"readingTime":134,"canonical":429,"series":430},"\u002Fithome-2025-day-24","Day 24：LIFF 刮刮樂實戰體驗","在了解 LIFF 的基礎設計流程後，本文將透過「刮刮樂」案例示範 LIFF API 的實際應用。從啟動時檢查權限與執行環境、確認用戶分享功能權限，到刮刮樂結束後發送訊息並關閉 LIFF，完整呈現 LIFF 在互動應用中的…","2025-10-07T22:36:58+08:00",[11,360,362,374],[11,362],4200,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10394618",{"name":366,"url":367,"day":90},{"path":432,"title":433,"description":434,"date":435,"updated":9,"tags":436,"categories":437,"draft":15,"wordCount":438,"readingTime":134,"canonical":439,"series":440},"\u002Fithome-2025-day-23","Day 23：LIFF 網頁應用開發入門","在鐵人賽前半段，我們深入探討了 LINE Bot 的兩大核心功能：Richmenu(選單設置)與各種 Reply Message(回覆訊息)的訊息類型。然而在實務應用中，若要提供更豐富的互動體驗，Line 往往需要搭配 …","2025-10-06T23:06:57+08:00",[11,360,362,374],[11,362],4400,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10394035",{"name":366,"url":367,"day":101},{"path":442,"title":443,"description":444,"date":445,"updated":9,"tags":446,"categories":447,"draft":15,"wordCount":448,"readingTime":329,"canonical":449,"series":450},"\u002Fithome-2025-day-22","Day 22：Render 雲端平台部署 Nest 後端伺服器","今天的目標是將系統正式上線。經過這段時間的開發，我們已完成 Line Message API 的核心功能與日誌處理機制。","2025-10-05T22:52:11+08:00",[11,360,362,350],[11,362],1895,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10393809",{"name":366,"url":367,"day":113},{"path":452,"title":453,"description":454,"date":455,"updated":9,"tags":456,"categories":457,"draft":15,"wordCount":458,"readingTime":318,"canonical":459,"series":460},"\u002Fithome-2025-day-21","Day 21：Nest Pino 整合 Grafana Loki 日誌","Loki 環境變數可參考 Day 20 文章的 Grafana Data Source settings 設定","2025-10-04T17:24:26+08:00",[11,360,362,350],[11,362],2740,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10393305",{"name":366,"url":367,"day":125},{"path":462,"title":463,"description":464,"date":465,"updated":9,"tags":466,"categories":467,"draft":15,"wordCount":468,"readingTime":318,"canonical":469,"series":470},"\u002Fithome-2025-day-20","Day 20：Grafana Loki 日誌服務 - 從申請到 API 串接測試","目前已經理解了 LINE Messaging API 的核心功能，包括如何接收訊息、串接第三方服務，以及發送多種類型的訊息。接下來，我們將把原本架設在 ngrok 的後端伺服器，透過 GitHub 自動化部署到 Rend…","2025-10-03T23:16:16+08:00",[11,360,362,350],[11,362],2461,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10392910",{"name":366,"url":367,"day":137},{"path":472,"title":473,"description":474,"date":475,"updated":9,"tags":476,"categories":477,"draft":15,"wordCount":478,"readingTime":318,"canonical":479,"series":480},"\u002Fithome-2025-day-19","Day 19：Flex Message Carousel 食譜分享","Flex Message 可以分成 bubble(單張卡片) 跟 carousel(多張卡片輪播) 兩種方式，昨天示範了 bubble 格式的電子個人名片後，今天主要展示 carousel 的應用，兩者的基本結構大致相同…","2025-10-02T16:06:17+08:00",[11,360,362,350],[11,362],2267,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10392256",{"name":366,"url":367,"day":148},{"path":482,"title":483,"description":484,"date":485,"updated":9,"tags":486,"categories":487,"draft":15,"wordCount":488,"readingTime":122,"canonical":489,"series":490},"\u002Fithome-2025-day-18","Day 18：Flex Message 設計個人名片","從基礎的文字互動開始，我們逐步探索了六大核心訊息類型的發送機制、Template Message 的結構化設計，以及 ImageMap Message 的互動式體驗。今天，我們將進入 LINE Bot 最具彈性的訊息格式…","2025-10-01T17:57:47+08:00",[11,360,362,350],[11,362],4468,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10391723",{"name":366,"url":367,"day":159},{"path":492,"title":493,"description":494,"date":495,"updated":9,"tags":496,"categories":497,"draft":15,"wordCount":498,"readingTime":122,"canonical":499,"series":500},"\u002Fithome-2025-day-17","Day 17：ImageMap Message  從互動海報到影片嵌入","在 Day 16 文章中，我們使用 Cloudflare Workers 實作了圖片代理功能。到目前為止，我們已經完成以下準備工作:","2025-09-30T11:58:32+08:00",[11,360,362,350],[11,362],4807,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10391164",{"name":366,"url":367,"day":170},{"path":502,"title":503,"description":504,"date":505,"updated":9,"tags":506,"categories":507,"draft":15,"wordCount":508,"readingTime":134,"canonical":509,"series":510},"\u002Fithome-2025-day-16","Day 16：Cloudflare Workers 圖片代理實作","在 Day 15 文章中，我們處理了 ImageMap Message 的背景圖，接著我們遇到了圖片不能出現副檔名及動態路徑支援不同解析度的問題。今天主要會透過 Cloudflare Workers 來解決這兩個問題，讓…","2025-09-29T16:15:41+08:00",[11,360,362,350],[11,362],3412,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10390567",{"name":366,"url":367,"day":181},{"path":512,"title":513,"description":514,"date":515,"updated":9,"tags":516,"categories":517,"draft":15,"wordCount":518,"readingTime":134,"canonical":519,"series":520},"\u002Fithome-2025-day-15","Day 15：共通屬性處理優化及 Imagemap  圖片製作","針對 Day 14 的程式碼架構進行優化。由於 Sender 和 Quick Reply 功能在所有回覆訊息類型中都能使用，我們應該將這些共用屬性抽取為獨立函數進行統一處理。","2025-09-28T21:03:38+08:00",[11,360,362,350],[11,362],4033,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10389697",{"name":366,"url":367,"day":192},{"path":522,"title":523,"description":524,"date":525,"updated":9,"tags":526,"categories":527,"draft":15,"wordCount":528,"readingTime":31,"canonical":529,"series":530},"\u002Fithome-2025-day-14","Day 14：LINE Bot Template Message 訊息回覆","經過前幾天的學習，我們已經成功掌握了 LINE Bot 六大基礎訊息類型的發送技巧，為訊息互動奠定了穩固的基礎。今天，我們將踏入更具挑戰性的進階應用領域！","2025-09-27T15:54:06+08:00",[11,360,362,350],[11,362],6372,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10388976",{"name":366,"url":367,"day":203},{"path":532,"title":533,"description":534,"date":535,"updated":9,"tags":536,"categories":537,"draft":15,"wordCount":538,"readingTime":122,"canonical":539,"series":540},"\u002Fithome-2025-day-13","Day 13：LINE Bot 客製化 Sender 與 Quick Reply 功能實作","LINE Bot 所有回覆訊息類型都具備「共用屬性」功能，這些屬性帶來兩項重要的互動體驗提升：","2025-09-26T11:41:34+08:00",[11,360,362,350],[11,362],4426,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10388037",{"name":366,"url":367,"day":214},{"path":542,"title":543,"description":544,"date":545,"updated":9,"tags":546,"categories":547,"draft":15,"wordCount":548,"readingTime":318,"canonical":549,"series":550},"\u002Fithome-2025-day-12","Day 12：LINE Bot Image、Video、Audio、Location 訊息回覆","Day 11 文章中，我們針對 LINE Bot 可以回覆的Text及Sticker基礎型別進行了封裝，不僅新增了 line-message.ts模組，還讓開發者可以用最少的參數產生 LINE Message 所需要的格…","2025-09-25T18:08:09+08:00",[11,360,362,350],[11,362],2977,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10387598",{"name":366,"url":367,"day":225},{"path":552,"title":553,"description":554,"date":555,"updated":9,"tags":556,"categories":557,"draft":15,"wordCount":558,"readingTime":31,"canonical":559,"series":560},"\u002Fithome-2025-day-11","Day 11：LINE Bot Text Emoji 與 Sticker 訊息回覆","目前我們的 LINE Bot 主要使用 Text 方式回覆訊息。今天將探討 Text 類型的 Emoji 應用，以及 Sticker 回覆方式，基於 Day 8 版本進行改寫。","2025-09-24T23:21:11+08:00",[11,360,350,362],[11,362],5659,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10386993",{"name":366,"url":367,"day":236},{"path":562,"title":563,"description":564,"date":565,"updated":9,"tags":566,"categories":567,"draft":15,"wordCount":568,"readingTime":318,"canonical":569,"series":570},"\u002Fithome-2025-day-10","Day 10：LINE Rich Menu Switch Action 提升使用者體驗","在 Day 9 文章中，我們結合 LINE 平台的功能，將天氣服務與圖片上傳服務整合，打造出第一張 LINE 圖文選單，透過 URI action 的方式觸發平台提供的互動效果。接著，我們使用客製化選單製作出 9 格的客…","2025-09-23T15:02:57+08:00",[11,360,362,350],[11,362],2906,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10386165",{"name":366,"url":367,"day":247},{"path":572,"title":573,"description":574,"date":575,"updated":9,"tags":576,"categories":577,"draft":15,"wordCount":578,"readingTime":318,"canonical":579,"series":580},"\u002Fithome-2025-day-09","Day  9：打造 LINE Rich Menu - 後台設計 vs API 客製化","在 Day8 文章中，我們透過整合雲端服務 Cloudinary，學習如何處理使用者上傳的圖片檔案，並將其儲存至雲端。然而，LINE Bot 除了讓使用者輸入文字回覆的方式之外，更常見的是透過圖文選單(Rich Menu…","2025-09-22T21:54:25+08:00",[11,360,362,350],[11,362],3285,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10385658",{"name":366,"url":367,"day":76},{"path":582,"title":583,"description":584,"date":585,"updated":9,"tags":586,"categories":587,"draft":15,"wordCount":588,"readingTime":17,"canonical":589,"series":590},"\u002Fithome-2025-day-08","Day 8：Cloudinary 雲端圖片儲存整合","在 Day 6 中，我們透過整合 OpenWeatherMap API 與座標位置訊息學習了如何結合第三方服務。今天將探索 Cloudinary 雲端服務，解決 LINE 圖片資源會過期的問題，學習如何透過 LINE M…","2025-09-21T23:13:19+08:00",[11,360,362,350],[11,362],7215,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10384968",{"name":366,"url":367,"day":110},{"path":592,"title":593,"description":594,"date":595,"updated":9,"tags":596,"categories":597,"draft":15,"wordCount":598,"readingTime":122,"canonical":599,"series":600},"\u002Fithome-2025-day-07","Day 7：Joi 環境變數統一驗證，重構 LINE Bot 天氣服務模組","在 Day 6 開發 LINE Bot 結合 OpenWeatherMap API 的過程中，我們採用私有方法將 API 請求處理與資料格式化整合在一起。今天將對 Day 6 的實作進行架構重構，主要目標是建立更完善的環…","2025-09-20T23:07:08+08:00",[11,360,362,350],[11,362],5157,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10384302",{"name":366,"url":367,"day":17},{"path":602,"title":603,"description":604,"date":605,"updated":9,"tags":606,"categories":607,"draft":15,"wordCount":608,"readingTime":134,"canonical":609,"series":610},"\u002Fithome-2025-day-06","Day 6：整合第三方 API 天氣查詢服務","Day 5 帶大家了解 LINE Bot 能接收使用者傳遞的「6+1」種訊息類型。之所以這樣強調，是因為 File 類型僅能在群組聊天中使用，這個限制我自己也經常忘記，所以習慣用「6+1」來提醒自己。","2025-09-19T21:07:47+08:00",[11,360,362,350],[11,362],3892,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10383636",{"name":366,"url":367,"day":31},{"path":612,"title":613,"description":614,"date":615,"updated":9,"tags":616,"categories":617,"draft":15,"wordCount":618,"readingTime":122,"canonical":619,"series":620},"\u002Fithome-2025-day-05","Day 5：整合 Pino Logger 提升 LINE Bot 專案的可維護性","看著專案逐漸成型，現在該開始重視日誌記錄的規劃了。在實際部署時，我們通常會區分 develop(開發環境)和 production(正式環境)兩種不同的執行環境，針對不同環境採用相應的日誌策略。","2025-09-18T23:30:00+08:00",[11,360,362,350],[11,362],4746,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10382298",{"name":366,"url":367,"day":122},{"path":622,"title":623,"description":624,"date":625,"updated":9,"tags":626,"categories":627,"draft":15,"wordCount":628,"readingTime":31,"canonical":629,"series":630},"\u002Fithome-2025-day-04","Day 4：掌握 LINE Bot 七種訊息類型與 NestJS 架構優化","目前我們都只使用 LINE Message Event 中的純文字(text)格式進行回覆，但除了純文字之外，LINE Bot 後端伺服器其實可以接收多種不同類型的訊息。今天就讓我們一起來深入了解這些訊息類型吧！","2025-09-17T22:53:37+08:00",[11,360,362,350],[11,362],5828,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10381651",{"name":366,"url":367,"day":134},{"path":632,"title":633,"description":634,"date":635,"updated":9,"tags":636,"categories":637,"draft":15,"wordCount":638,"readingTime":122,"canonical":639,"series":640},"\u002Fithome-2025-day-03","Day 3：Webhook 簽章驗證與訊息回覆策略(Push & Reply)","上一篇帶大家透過「Webhook 模式」成功架設了專屬的 LINE Bot 代理人。相信大家在體驗基礎功能後，對於 LINE Bot Webhook 還能監聽哪些事件、支援哪些類型的訊息回覆，以及如何確保後端收到的訊息確…","2025-09-16T21:53:39+08:00",[11,360,362,350],[11,362],5360,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10381303",{"name":366,"url":367,"day":318},{"path":642,"title":643,"description":644,"date":645,"updated":9,"tags":646,"categories":647,"draft":15,"wordCount":648,"readingTime":31,"canonical":649,"series":650},"\u002Fithome-2025-day-02","Day 2：從 Webhook 到後端，打造你的專屬機器人","上一篇，帶大家透過「Chat 模式」，讓自身變成客服機器人的方式。這篇會從「Webhook 模式」切入，並以 NestJS 作為後端框架，教你如何在休息時間，也能讓後端伺服器當你的替身幫你解惑使用者的問題。","2025-09-15T21:20:49+08:00",[11,360,362,350],[11,362],6590,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10380524",{"name":366,"url":367,"day":329},{"path":652,"title":653,"description":654,"date":655,"updated":9,"tags":656,"categories":657,"draft":15,"wordCount":658,"readingTime":318,"canonical":659,"series":660},"\u002Fithome-2025-day-01","Day 1：Hello World LINE Bot","每個程式語言的開始通常都會以練習 Hello World！作為一個簡單的起手式，LINE Bot 也不意外。這一系列會著重在 LINE Bot 的相關應用，帶大家用輕鬆的方式一起建立屬於自己的 Line Bot 聊天機器…","2025-09-14T22:48:33+08:00",[11,360,362,350],[11,362],2723,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10379895",{"name":366,"url":367,"day":340},{"path":662,"title":663,"description":664,"date":665,"updated":9,"tags":666,"categories":671,"draft":15,"wordCount":674,"readingTime":134,"canonical":9,"series":9},"\u002Fdbdiagram-tool","關聯式資料庫設計必備 - dbdiagram.io ERD 繪圖工具","還在煩惱如何設計關聯式資料表實體關聯圖嗎？ 使用 dbdiagram.io 加快你與同事之間的距離","2024-11-05T20:18:24+08:00",[667,668,669,670],"ERD","dbdiagram.io","DBML","資料庫設計",[672,673],"Database","開發工具",3982,{"path":676,"title":677,"description":678,"date":679,"updated":9,"tags":680,"categories":687,"draft":15,"wordCount":690,"readingTime":122,"canonical":9,"series":9},"\u002FPostgreSQL-1","前端勇士大闖六角後端體驗營 - 初探 PostgreSQL DML 語法","初步踏入後端的世界，了解何謂後端以及資料庫常見語法 DDL、DML。","2024-10-30T22:43:49+08:00",[681,682,683,684,685,686],"PostgreSQL","SQL","DML","DDL","資料庫","六角學院",[672,688,689],"後端實戰","學習心得",5220,{"path":692,"title":693,"description":694,"date":695,"updated":9,"tags":696,"categories":700,"draft":15,"wordCount":703,"readingTime":329,"canonical":9,"series":9},"\u002Fcss-flex-1","CSS flex 軸線對齊技巧 - 預設屬性","CSS flex 排版技巧你都了解了嗎？回歸學習初心的認識 flex 預設屬性","2024-10-24T20:29:08+08:00",[697,698,699],"Flexbox","前端排版","切版技巧",[701,702],"CSS","前端開發",1856,{"path":705,"title":706,"description":707,"date":708,"updated":9,"tags":709,"categories":712,"draft":15,"wordCount":714,"readingTime":329,"canonical":715,"series":716},"\u002Fithome-2024-day-30","Vue 3 用實作帶你看過核心概念 - Day 30：新手村的鐵人證書 - 完賽心得","花了整整半年左右的時間，每天下班都很用心的準備範例或是看書，這一段旅程對我來說真的很重要。擔心、害怕跟不安的心情一直充斥自己心中，擔心寫錯或是寫不好，想讓自己再多準備久一點再開始，所以拖到中秋連假才開始，想下定決心讓自己…","2024-10-13T12:42:25+08:00",[11,710,711],"2024 鐵人賽","Vue 3",[11,713],"Vue",1381,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10367206",{"name":717,"url":718,"day":22},"2024 iThome 鐵人賽：Vue 3 初學者：用實作帶你看過核心概念","https:\u002F\u002Fithelp.ithome.com.tw\u002Fusers\u002F20116554\u002Fironman\u002F7800",{"path":720,"title":721,"description":722,"date":723,"updated":9,"tags":724,"categories":727,"draft":15,"wordCount":728,"readingTime":134,"canonical":729,"series":730},"\u002Fithome-2024-day-29","Vue 3 用實作帶你看過核心概念 - Day 29：Composables(組合式函數)","Composables是 Vue 3 中的一個重要概念，它是利用 Vue 的 Composition API 來創建和管理可重用的有狀態邏輯的函數。Composables 允許我們將組件邏輯抽象成可重用的函數，使得代碼更…","2024-10-12T15:07:55+08:00",[11,710,711,725,726],"Options API","Composition API",[11,713],4233,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10366865",{"name":717,"url":718,"day":34},{"path":732,"title":733,"description":734,"date":735,"updated":9,"tags":736,"categories":738,"draft":15,"wordCount":739,"readingTime":134,"canonical":740,"series":741},"\u002Fithome-2024-day-28","Vue 3 用實作帶你看過核心概念 - Day 28：官方 Vue Router 的應用與技巧","路由設定方式，一般可以分成兩種：","2024-10-11T17:14:44+08:00",[11,710,711,725,737],"Vue Router",[11,713],4095,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10366520",{"name":717,"url":718,"day":45},{"path":743,"title":744,"description":745,"date":746,"updated":9,"tags":747,"categories":748,"draft":15,"wordCount":749,"readingTime":122,"canonical":750,"series":751},"\u002Fithome-2024-day-27","Vue 3 用實作帶你看過核心概念 - Day 27：VeeValidate 表單驗證工具","在開發 Vue 應用程式時，表單驗證至關重要，它能確保使用者輸入的資料符合預期的格式和要求。今天來介紹一款專門用於 Vue 的表單驗證工具—VeeValidate v4。這個工具不僅能幫助開發者輕鬆實現表單驗證，還提供了…","2024-10-10T21:02:16+08:00",[11,710,711,725],[11,713],4461,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10366165",{"name":717,"url":718,"day":56},{"path":753,"title":754,"description":755,"date":756,"updated":9,"tags":757,"categories":758,"draft":15,"wordCount":759,"readingTime":318,"canonical":760,"series":761},"\u002Fithome-2024-day-26","Vue 3 用實作帶你看過核心概念 - Day 26：KeepAlive 與 Teleport 內置組件","預設情況下，切換組件會導致組件的創建及銷毀，無法保持組件內部的狀態。","2024-10-09T18:50:53+08:00",[11,710,711,725],[11,713],3158,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10365724",{"name":717,"url":718,"day":67},{"path":763,"title":764,"description":765,"date":766,"updated":9,"tags":767,"categories":768,"draft":15,"wordCount":769,"readingTime":318,"canonical":770,"series":771},"\u002Fithome-2024-day-25","Vue 3 用實作帶你看過核心概念 - Day 25：自定義指令(Custom Directives)","Vue不僅提供了豐富的內置指令用於操作DOM元素，還允許開發者創建自定義指令。透過自定義指令，我們可以對DOM元素進行更細緻的控制，並在指令的不同生命週期階段執行特定的邏輯，從而實現更靈活的功能擴展。","2024-10-08T22:05:32+08:00",[11,710,711,725],[11,713],3116,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10365355",{"name":717,"url":718,"day":79},{"path":773,"title":774,"description":775,"date":776,"updated":9,"tags":777,"categories":778,"draft":15,"wordCount":779,"readingTime":329,"canonical":780,"series":781},"\u002Fithome-2024-day-24","Vue 3 用實作帶你看過核心概念 - Day 24：異步加載(Lazy loading)","在大型項目中，我們通常需要將應用拆分為更小的代碼模塊，並僅在需要時才從服務器加載相關組件，以減少初次加載的資源量。Vue 提供了 defineAsyncComponent 方法來實現組件的異步加載，這樣可以有效提高應用的…","2024-10-07T20:28:27+08:00",[11,710,711,725],[11,713],2171,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10364861",{"name":717,"url":718,"day":90},{"path":783,"title":784,"description":785,"date":786,"updated":9,"tags":787,"categories":788,"draft":15,"wordCount":789,"readingTime":318,"canonical":790,"series":791},"\u002Fithome-2024-day-23","Vue 3 用實作帶你看過核心概念 - Day 23：依賴注入( Provide-Inject )","在Dayxx中提到過，父子組件之間的數據傳遞可以通過props來實現。然而，當祖孫層組件需要進行數據傳遞時，中間層級的組件可能並不需要這個props，但卻不得不為了使子組件獲取數據而被迫傳遞。","2024-10-06T15:14:51+08:00",[11,710,711,725],[11,713],3183,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10364252",{"name":717,"url":718,"day":101},{"path":793,"title":794,"description":795,"date":796,"updated":9,"tags":797,"categories":798,"draft":15,"wordCount":799,"readingTime":134,"canonical":800,"series":801},"\u002Fithome-2024-day-22","Vue 3 用實作帶你看過核心概念 - Day 22：v-slot 插槽使用","先前Day 18中提到父組件可以通過props將參數資料傳遞給子組件進行渲染，這樣可以有效地將資料處理與畫面渲染的工作分開。然而，當我們需要更加客製化的呈現內容，由父組件來控制子組件的部分顯示時，可以使用v-slot 指…","2024-10-05T12:32:51+08:00",[11,710,711,725],[11,713],4292,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10363713",{"name":717,"url":718,"day":113},{"path":803,"title":804,"description":805,"date":806,"updated":9,"tags":807,"categories":808,"draft":15,"wordCount":809,"readingTime":329,"canonical":810,"series":811},"\u002Fithome-2024-day-21","Vue 3 用實作帶你看過核心概念 - Day 21： 組件透傳屬性(Attributes)的應用","當父組件向子組件傳遞屬性或監聽器，而這些屬性未在子組件中定義為props或emits時，它們會自動繼承並附加到子組件的根元素上，常見的屬性包括class、style、id等。這些屬性可以透過$attrs屬性訪問並進行操作…","2024-10-04T22:42:54+08:00",[11,710,711,725],[11,713],2146,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10363469",{"name":717,"url":718,"day":125},{"path":813,"title":814,"description":815,"date":816,"updated":9,"tags":817,"categories":818,"draft":15,"wordCount":819,"readingTime":122,"canonical":820,"series":821},"\u002Fithome-2024-day-20","Vue 3 用實作帶你看過核心概念 - Day 20：組件使用 v-model 雙向綁定","在Day 13中，我們介紹了表單元素（例如輸入框）如何處理數據雙向綁定。當需要將表單元素與一個響應式變數綁定時，v-model提供雙向綁定功能。這代表當畫面上表單元素的變動會即時影響Vue數據，同時當Vue數據的值改變時…","2024-10-03T23:40:48+08:00",[11,710,711,725],[11,713],5191,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10362957",{"name":717,"url":718,"day":137},{"path":823,"title":824,"description":825,"date":826,"updated":9,"tags":827,"categories":828,"draft":15,"wordCount":829,"readingTime":318,"canonical":830,"series":831},"\u002Fithome-2024-day-19","Vue 3 用實作帶你看過核心概念 - Day 19：子組件向父組件發射事件 - emits","組件可以通過$emit(functionName, params)自定義事件名稱並傳遞參數。自定義事件名稱建議使用kebab-case來命名自定義事件名稱，以確保命名風格與HTML 屬性一致性。此外，自定義事件還支持事件…","2024-10-02T15:51:16+08:00",[11,710,711,725],[11,713],2877,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10362144",{"name":717,"url":718,"day":148},{"path":833,"title":834,"description":835,"date":836,"updated":9,"tags":837,"categories":838,"draft":15,"wordCount":839,"readingTime":31,"canonical":840,"series":841},"\u002Fithome-2024-day-18","Vue 3 用實作帶你看過核心概念 - Day 18：父組件向子組件傳值 - props","組件之間的傳值必須透過聲明 props 的方式，這樣可以避免與HTML的屬性(attribute)混淆。父組件傳遞參數給子組件的方式有以下兩種方式：","2024-10-01T22:28:48+08:00",[11,710,711,725],[11,713],5782,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10361721",{"name":717,"url":718,"day":159},{"path":843,"title":844,"description":845,"date":846,"updated":9,"tags":847,"categories":848,"draft":15,"wordCount":849,"readingTime":318,"canonical":850,"series":851},"\u002Fithome-2024-day-17","Vue 3 用實作帶你看過核心概念 - Day 17：組件基礎 - 全局註冊與區域註冊","在 Day 5 我們提到可以將應用拆分為根組件和多個組件實例，並將功能模塊化。","2024-09-30T23:30:10+08:00",[11,710,711,725],[11,713],2954,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10361253",{"name":717,"url":718,"day":170},{"path":853,"title":854,"description":855,"date":856,"updated":9,"tags":857,"categories":858,"draft":15,"wordCount":859,"readingTime":122,"canonical":860,"series":861},"\u002Fithome-2024-day-16","Vue 3 用實作帶你看過核心概念 - Day 16：使用 ref 屬性引用模板元素","雖然 Vue 透過模板幫助我們處理了大部分的DOM 操作，但在某些情況下，仍然需要手動操作 DOM。例如，在使用第三方套件（如 Bootstrap 的 Modal）時，或者需要調用像video.play()和video.…","2024-09-29T16:25:45+08:00",[11,710,711,725],[11,713],4608,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10360419",{"name":717,"url":718,"day":181},{"path":863,"title":864,"description":865,"date":866,"updated":9,"tags":867,"categories":868,"draft":15,"wordCount":488,"readingTime":122,"canonical":869,"series":870},"\u002Fithome-2024-day-15","Vue 3 用實作帶你看過核心概念 - Day 15：監聽器(Watchers)","在響應式狀態變化時執行特定操作，需要使用watch 監聽器。這些操作可能包含副作用 (side effects)，如發送請求、調用 API，或更新 DOM 以外的系統狀態，亦或是處理自定義的邏輯。","2024-09-28T18:30:31+08:00",[11,710,711,725],[11,713],"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10359958",{"name":717,"url":718,"day":192},{"path":872,"title":873,"description":874,"date":875,"updated":9,"tags":876,"categories":877,"draft":15,"wordCount":878,"readingTime":134,"canonical":879,"series":880},"\u002Fithome-2024-day-14","Vue 3 用實作帶你看過核心概念 - Day 14：生命週期鉤子(Lifecycle Hooks)","在 Vue 中，當一個組件創建時，它會經歷一系列的流程，這些流程決定了組件從初始化到渲染，再到最終銷毀的過程。","2024-09-27T21:57:32+08:00",[11,710,711,725],[11,713],3780,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10359419",{"name":717,"url":718,"day":203},{"path":882,"title":883,"description":884,"date":885,"updated":9,"tags":886,"categories":887,"draft":15,"wordCount":888,"readingTime":318,"canonical":889,"series":890},"\u002Fithome-2024-day-13","Vue 3 用實作帶你看過核心概念 - Day 13：v-model 雙向綁定控制 - 常用於表單輸入","表單輸入是開發中非常常見的需求，原始方式通常需要手動使用v-bind綁定表單元素的值 (value)，並透過v-on綁定input事件來監聽輸入變化。","2024-09-26T21:49:25+08:00",[11,710,711,725],[11,713],3153,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10358850",{"name":717,"url":718,"day":214},{"path":892,"title":893,"description":894,"date":895,"updated":9,"tags":896,"categories":897,"draft":15,"wordCount":898,"readingTime":134,"canonical":899,"series":900},"\u002Fithome-2024-day-12","Vue 3 用實作帶你看過核心概念 - Day 12：v-on 指令 - 事件處理","在 Vue 中，監聽 HTML DOM 元素的事件變化，可以使用v-on 指令將 JavaScript 事件處理器綁定到對應的DOM 事件上。這個指令的縮寫符號為@，例如：v-on:click，其縮寫方式為@click。","2024-09-25T21:42:59+08:00",[11,710,711,725],[11,713],3808,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10358241",{"name":717,"url":718,"day":225},{"path":902,"title":903,"description":904,"date":905,"updated":9,"tags":906,"categories":907,"draft":15,"wordCount":908,"readingTime":134,"canonical":909,"series":910},"\u002Fithome-2024-day-11","Vue 3 用實作帶你看過核心概念 - Day 11：v-for 指令的基本與進階應用","當數據類型是陣列或物件時，我們不會希望將重複的選項或元素直接硬編碼在模板中。這樣的寫法會導致代碼冗長且不具可維護性。","2024-09-24T23:11:25+08:00",[11,710,711,725],[11,713],4381,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10357705",{"name":717,"url":718,"day":236},{"path":912,"title":913,"description":914,"date":915,"updated":9,"tags":916,"categories":917,"draft":15,"wordCount":918,"readingTime":318,"canonical":919,"series":920},"\u002Fithome-2024-day-10","Vue 3 用實作帶你看過核心概念 - Day 10：條件渲染 - v-if 與 v-show 的區別與應用","開發中遇到需要處理【如果是...就要...】的情境時，Vue 提供了 v-if 指令來幫助我們根據條件進行元素的渲染。這樣可以在特定條件滿足時動態地顯示或隱藏某些元素。","2024-09-23T23:39:24+08:00",[11,710,711,725],[11,713],2827,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10357160",{"name":717,"url":718,"day":247},{"path":922,"title":923,"description":924,"date":925,"updated":9,"tags":926,"categories":927,"draft":15,"wordCount":928,"readingTime":122,"canonical":929,"series":930},"\u002Fithome-2024-day-09","Vue 3 用實作帶你看過核心概念 - Day 9：Class 與 Style 的樣式綁定","v-bind 指令通常用於綁定 HTML 屬性，但在實際開發中，最常見的應用場景之一還是綁定class和 style這兩個 HTML 屬性。","2024-09-22T15:05:53+08:00",[11,710,711,725],[11,713],4630,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10356119",{"name":717,"url":718,"day":76},{"path":932,"title":933,"description":934,"date":935,"updated":9,"tags":936,"categories":937,"draft":15,"wordCount":938,"readingTime":134,"canonical":939,"series":940},"\u002Fithome-2024-day-08","Vue 3 用實作帶你看過核心概念 - Day 8：計算屬性應用與實踐","在 Day 6 在使用 Vue 的Mustache語法時，可以用來放置表達式。不過，這邊建議避免在 Mustache 中撰寫過於複雜的邏輯。這樣的建議主要有兩個原因：","2024-09-21T21:33:29+08:00",[11,710,711,725],[11,713],4060,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10355474",{"name":717,"url":718,"day":110},{"path":942,"title":943,"description":944,"date":945,"updated":9,"tags":946,"categories":947,"draft":15,"wordCount":948,"readingTime":122,"canonical":949,"series":950},"\u002Fithome-2024-day-07","Vue 3 用實作帶你看過核心概念 - Day 7： 響應式基礎 - Options API","前面提到了模板搭配指令及 Mustache 的用法。今天則是要介紹所謂透過getter跟setter取值跟賦值的方式在 JavaScript 是怎麼做到的，這部分會跟 Vue 本身的響應式基礎有很大相關。此外，我也會帶著…","2024-09-20T23:41:42+08:00",[11,710,711],[11,713],4407,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10354781",{"name":717,"url":718,"day":17},{"path":952,"title":953,"description":954,"date":955,"updated":9,"tags":956,"categories":957,"draft":15,"wordCount":958,"readingTime":134,"canonical":959,"series":960},"\u002Fithome-2024-day-06","Vue 3 用實作帶你看過核心概念 - Day 6：數據綁定和模板(Template)","Vue 使用基於 HTML 的模板語法（Template Syntax），將 Vue 實例中的數據綁定到模板中進行顯示。根據綁定的類型不同，數據可以影響元素的內容、屬性或樣式。","2024-09-19T20:39:46+08:00",[11,710,711,725],[11,713],3402,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10354231",{"name":717,"url":718,"day":31},{"path":962,"title":963,"description":964,"date":965,"updated":9,"tags":966,"categories":967,"draft":15,"wordCount":968,"readingTime":318,"canonical":969,"series":970},"\u002Fithome-2024-day-05","Vue 3 用實作帶你看過核心概念 - Day 5：Options API vs Composition API","前面已經詳細說明了 Vue 的環境建置方式，接下來將逐步介紹 Vue 應用說明，並比較Options API與Composition API的撰寫風格。","2024-09-18T22:10:36+08:00",[11,710,711,725,726],[11,713],2902,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10353717",{"name":717,"url":718,"day":122},{"path":972,"title":973,"description":974,"date":975,"updated":9,"tags":976,"categories":977,"draft":15,"wordCount":658,"readingTime":318,"canonical":978,"series":979},"\u002Fithome-2024-day-04","Vue 3 用實作帶你看過核心概念 - Day 4：基於 Vite 建構工具的 Vue 專案結構解析","在 Day 3 的教學中，學習了如何使用 Vue 鷹架工具(Vue project scaffolding tool)來生成一個基於 Vite 環境的專案。今天，我將更進一步地解析這個專案的資料夾結構，幫助大家更好地理解…","2024-09-17T23:27:07+08:00",[11,710,711,725],[11,713],"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10352470",{"name":717,"url":718,"day":134},{"path":981,"title":982,"description":983,"date":984,"updated":9,"tags":985,"categories":986,"draft":15,"wordCount":987,"readingTime":329,"canonical":988,"series":989},"\u002Fithome-2024-day-03","Vue 3 用實作帶你看過核心概念 - Day 3：使用 Vite 建構工具搭建 Vue 專案","⭐ 需要特別注意，需要事先安裝Nodejs。若不確定是否已安裝 Nodejs 也可以開啟終端機，執行以下指令確認版本。","2024-09-16T23:29:45+08:00",[11,710,711,725],[11,713],2100,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10351398",{"name":717,"url":718,"day":318},{"path":991,"title":992,"description":993,"date":994,"updated":9,"tags":995,"categories":996,"draft":15,"wordCount":997,"readingTime":329,"canonical":998,"series":999},"\u002Fithome-2024-day-02","Vue 3 用實作帶你看過核心概念 - Day 2：命令式編程 vs 聲明式編程","還記得我們在使用純 HTML 和 JavaScript 時，如何實現按下按鈕來變更文字顏色嗎？讓我們一起回想一下什麼是命令式宣告。","2024-09-15T22:52:27+08:00",[11,710,711,725,726],[11,713],1881,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10350459",{"name":717,"url":718,"day":329},{"path":1001,"title":1002,"description":1003,"date":1004,"updated":9,"tags":1005,"categories":1006,"draft":15,"wordCount":1007,"readingTime":340,"canonical":1008,"series":1009},"\u002Fithome-2024-day-01","Vue 3 用實作帶你看過核心概念 - Day 1：前言介紹","大家好，我是 Antonio(安東尼奧)，目前是一名 Angular 的新手工程師，同時，也是一名熱愛寫程式的工程師。去年參加六角學院的 Vue 直播班，在那時候就深深著迷著 Vue 的語言，自此這半年多的時間裡，我白天…","2024-09-14T17:32:19+08:00",[11,710,711],[11,713],988,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10350457",{"name":717,"url":718,"day":340},{"path":1011,"title":1012,"description":1013,"date":1014,"updated":9,"tags":1015,"categories":1017,"draft":15,"wordCount":1019,"readingTime":329,"canonical":9,"series":9},"\u002Fhexschool-experience","六角學院 - 軟體工程師體驗營","這麼多線上課程? 你不想知道什麼是最吸引我的線上學習課程嗎?","2024-05-31T21:40:05+08:00",[686,1016],"軟體工程師體驗營",[689,1018],"前端成長記",1109,{"path":1021,"title":1022,"description":1023,"date":1024,"updated":9,"tags":1025,"categories":1033,"draft":15,"wordCount":1035,"readingTime":318,"canonical":9,"series":9},"\u002FJS-10","JavaScript：var、let、const之間的差異解析","var、let及const是JavaScript中宣告變數的關鍵字，它們在作用域、對於for迴圈的影響、提升 (Hoisting) 的差異及重複宣告的處理上有所不同。","2023-12-10T23:53:30+08:00",[1026,1027,1028,1029,1030,1031,1032],"ES6","var","let","const","Hoisting","Scope","TDZ",[1034,702],"JavaScript",2873,{"path":1037,"title":1038,"description":1039,"date":1040,"updated":9,"tags":1041,"categories":1048,"draft":15,"wordCount":1049,"readingTime":122,"canonical":9,"series":9},"\u002FJS-9","JavaScript：陣列的常見操作方法","掌握 JavaScript 陣列操作！從forEach、map、filter、findIndex、reduce、sort，深入了解這些方法，使你的程式碼更具靈活性和效率！","2023-12-01T15:01:06+08:00",[1042,1043,1044,1045,1046,1047],"forEach","map","filter","reduce","sort","findIndex",[1034,702],4846,{"path":1051,"title":1052,"description":1053,"date":1054,"updated":9,"tags":1055,"categories":1060,"draft":15,"wordCount":1061,"readingTime":318,"canonical":9,"series":9},"\u002FJS-8","JavaScript：ES module 匯入與匯出","使用\u003C script >標籤讓瀏覽器中的網頁能夠使用 ES 模組功能時，你了解不同的匯入及匯出方法了嗎？","2023-11-30T15:28:23+08:00",[1026,1056,1057,1058,1059],"ES Module","CommonJS","Node.js","模組化開發",[1034,702],2913,{"path":1063,"title":1064,"description":1065,"date":1066,"updated":9,"tags":1067,"categories":1070,"draft":15,"wordCount":1072,"readingTime":134,"canonical":9,"series":9},"\u002FReact-2","React：JSX 是什麼？為何在 React 中使用 JSX？","透過 JSX 語法糖，你能夠在一次 JavaScript 撰寫中包含 HTML 與 CSS 的內容","2023-11-29T16:03:40+08:00",[1068,1034,1069],"JSX","Babel",[1071,702],"React",3595,{"path":1074,"title":1075,"description":1076,"date":1077,"updated":9,"tags":1078,"categories":1081,"draft":15,"wordCount":1082,"readingTime":329,"canonical":9,"series":9},"\u002FReact-1","React：Pure Function 的概念及其在 React 中的應用","探索 Pure Function 概念及其與 React 的相互關係。","2023-11-29T15:50:17+08:00",[1034,1079,1080],"Pure Function","Functional Programming",[1071],1368,{"path":1084,"title":1085,"description":1086,"date":1087,"updated":9,"tags":1088,"categories":1093,"draft":15,"wordCount":1094,"readingTime":122,"canonical":9,"series":9},"\u002FJS-6","JavaScript：深入理解Promise的原理及實際應用","透過Promise，我們能夠有效解決JavaScript中的異步事件，使得程式碼更為清晰和可讀。","2023-11-29T14:49:18+08:00",[1089,1090,1091,1092],"Promise","AsyncAwait","Asynchronous Programming","異步處理",[1034,702],5479,{"path":1096,"title":1097,"description":1098,"date":1099,"updated":9,"tags":1100,"categories":1105,"draft":15,"wordCount":1106,"readingTime":122,"canonical":9,"series":9},"\u002FJS-5","JavaScript：物件傳參考特性(Pass by Reference)","淺拷貝(shallow copy)與深拷貝(deep copy)在JavaScript中的應用與理解","2023-11-29T09:55:50+08:00",[1101,1102,1103,1104],"Pass by Reference","Shallow Copy","Deep Copy","傳值與傳參考",[1034,702],4544,{"path":1108,"title":1109,"description":1110,"date":1111,"updated":9,"tags":1112,"categories":1118,"draft":15,"wordCount":1120,"readingTime":329,"canonical":9,"series":9},"\u002FJS-4","JavaScript：注重關注點的分離","透過關注點分離的設計方式，可顯著提高系統整體的可維護性。","2023-11-29T09:44:29+08:00",[1113,1114,1115,1116,1117],"SoC","MVC","Design Patterns","Clean Code","Refactoring",[1034,1119],"Software Engineering",1977,{"path":1122,"title":1123,"description":1124,"date":1125,"updated":9,"tags":1126,"categories":1132,"draft":15,"wordCount":1133,"readingTime":329,"canonical":9,"series":9},"\u002FJS-3","JavaScript：掌握箭頭函式，優雅簡約的程式寫作","深入解析ES6箭頭函數：揭開與傳統函式的差異。","2023-11-29T01:02:36+08:00",[1127,1128,1129,1130,1131],"Arrow Function","this","Lexical Scoping","Syntactic Sugar","Callback Function",[1034,702],2142,{"path":1135,"title":1136,"description":1137,"date":1138,"updated":9,"tags":1139,"categories":1143,"draft":15,"wordCount":1144,"readingTime":329,"canonical":9,"series":9},"\u002FJS-2","JavaScript：深入了解This的指向與應用","探索JavaScript This 的指向：深入剖析判斷的技巧。","2023-11-28T22:22:45+08:00",[1128,1140,1131,1141,1142],"Execution Context","Binding","Fundamentals",[1034,702],1963,{"path":1146,"title":1147,"description":1148,"date":1149,"updated":9,"tags":1150,"categories":1154,"draft":15,"wordCount":1155,"readingTime":340,"canonical":9,"series":9},"\u002FJS-1","JavaScript：淺談ES6常見縮寫","JavaScript ES6縮寫技巧：輕鬆簡化程式碼，提升效率！。","2023-11-28T13:38:14+08:00",[1026,1151,1152,1153],"Shorthand","Spread Operator","Object",[1034,702],818,{"path":1157,"title":1158,"description":1159,"date":1160,"updated":9,"tags":1161,"categories":1165,"draft":15,"wordCount":1166,"readingTime":340,"canonical":9,"series":9},"\u002FEmmet-1","前端開發神器：使用Emmet提升網頁開發效率","本文將介紹如何利用Emmet來大幅提高前端開發效率，讓你的編碼速度如專家般飛快。","2023-10-31T14:40:54+08:00",[1162,1163,1164],"Emmet","VSCode","HTML",[702,673],865,{"path":1168,"title":1169,"description":1170,"date":1171,"updated":9,"tags":1172,"categories":1177,"draft":15,"wordCount":1179,"readingTime":340,"canonical":9,"series":9},"\u002Fhexo-github-4","建立自己的部落格：了解Hexo指令，更換next部落格主題","今天的你跟我都是Hexo指令指揮官，讓我們將部落格造型大改造一下吧!!!","2023-10-20T14:33:38+08:00",[1173,1174,1175,1176],"Hexo","NexT","git clone","Hexo指令",[1178],"Blog",979,{"path":1181,"title":1182,"description":1183,"date":1184,"updated":9,"tags":1185,"categories":1189,"draft":15,"wordCount":1190,"readingTime":329,"canonical":9,"series":9},"\u002Fhexo-github-3","建立自己的部落格：修改Hexo設定檔中Site，查看其變化","今天的你跟我都是部落格工程師，我們一起來將網頁做一些小小的改變，有一天匯集在一起就會讓你的部落格變的與眾不同。","2023-10-18T20:50:31+08:00",[1173,1163,1186,1187,1188],"Sublime Text","YAML","SEO",[1178],1798,{"path":1192,"title":1193,"description":1194,"date":1195,"updated":9,"tags":1196,"categories":1199,"draft":15,"wordCount":1200,"readingTime":340,"canonical":9,"series":9},"\u002Fhexo-github-2","建立自己的部落格：創建Hexo Blog初始的模板","踏出那關鍵的第一步，從白紙到完整的部落格，一同見證你的部落格誕生的奇妙時刻。","2023-10-17T15:59:37+08:00",[1173,1197,1198],"Hexo-cli","hexo init",[1178],941,{"path":1202,"title":1203,"description":1204,"date":1205,"updated":9,"tags":1206,"categories":1208,"draft":15,"wordCount":1209,"readingTime":340,"canonical":9,"series":9},"\u002Fhexo-github-1","建立自己的部落格：認識Hexo及所其需工具(Nodejs & Git)","打造屬於自己風格的部落格其實不難，讓我們一步步手把手教你如何實現這個目標。","2023-10-16T08:30:27+08:00",[1173,1058,1207],"Git",[1178],790,{"id":1211,"title":523,"body":1212,"canonical":529,"categories":3477,"date":525,"description":524,"draft":15,"extension":3478,"meta":3479,"navigation":1561,"ogImage":9,"path":522,"rawbody":3480,"readingTime":31,"robots":9,"schemaOrg":9,"seo":3481,"series":3482,"sitemap":3483,"slug":3490,"stem":3491,"tags":3492,"updated":9,"wordCount":528,"__hash__":3493},"posts\u002F2025-09-27-ithome-2025-day-14.md",{"type":1213,"value":1214,"toc":3453},"minimark",[1215,1223,1227,1229,1245,1251,1264,1268,1284,1289,1295,1311,1327,1331,1343,1346,1356,1361,1476,1480,1485,1491,1496,1501,1513,1518,1530,1535,1664,1668,1675,1680,1845,1849,1854,1857,1868,1874,1879,2201,2205,2210,2229,2235,2238,2247,2252,2364,2367,2371,2484,2488,2493,2496,2502,2505,2510,2520,2525,2779,2782,2794,2798,2806,2810,2818,2824,2829,2969,2972,2975,2980,3172,3176,3181,3184,3187,3195,3201,3204,3207,3299,3302,3311,3440,3443,3446,3449],[1216,1217,1218],"p",{},[1219,1220],"img",{"alt":1221,"src":1222},"2025 鐵人賽背景圖","https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1758954048\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002FDay%2014%EF%BC%9ALINE%20Bot%20Template%20Message%20%E5%9B%9B%E7%A8%AE%E6%A8%A1%E6%9D%BF%E8%A8%8A%E6%81%AF%E5%9B%9E%E8%A6%86\u002F2025_%E9%90%B5%E4%BA%BA%E8%B3%BD%E4%BD%BF%E7%94%A8_aiizii.png",[1224,1225,1226],"h2",{"id":1226},"前言",[1216,1228,524],{},[1216,1230,1231,1232,1236,1237,1240,1241,1244],{},"在實際的 LINE Bot 開發場景中，除了六大基礎訊息類型外，LINE 官方還提供了三種進階訊息格式：",[1233,1234,1235],"code",{},"Template Message","、",[1233,1238,1239],{},"Imagemap Message"," 及 ",[1233,1242,1243],{},"Flex Message","。",[1216,1246,1247,1248,1250],{},"今天，我們將深入探索第一種進階訊息格式 ",[1233,1249,1235],{},"，學習如何運用預設的模板佈局，快速打造出視覺統一且互動豐富的訊息回覆。",[1252,1253,1254],"blockquote",{},[1216,1255,1256,1257],{},"本日程式碼的",[1258,1259,1263],"a",{"href":1260,"rel":1261},"https:\u002F\u002Fgithub.com\u002FLING-JUN-HAO\u002Fnestjs-linebot-ironman\u002Ftree\u002Fday11",[1262],"nofollow","範例連結",[1265,1266,1235],"h3",{"id":1267},"template-message",[1252,1269,1270],{},[1216,1271,1272,1276,1277,1240,1280,1283],{},[1258,1273,1275],{"href":539,"rel":1274},[1262],"Day 13","提到的訊息共通參數 ",[1233,1278,1279],{},"Sender",[1233,1281,1282],{},"Quick Reply"," 同樣適用於所有進階訊息格式(Template Message、ImageMapMessage、FlexMessage）。",[1216,1285,1286,1288],{},[1233,1287,1235],{}," 可以理解為 LINE 官方預先設計的訊息模板佈局系統。開發者只需將所需參數代入模板中，即可快速產生具有統一視覺風格的互動式訊息。這種設計大幅提升了開發效率，但相對地在客製化程度上會有一定的限制。",[1216,1290,1291],{},[1292,1293,1294],"strong",{},"模板訊息總共有四種：",[1296,1297,1298,1302,1305,1308],"ol",{},[1299,1300,1301],"li",{},"Buttons template",[1299,1303,1304],{},"Confirm template",[1299,1306,1307],{},"Carousel template",[1299,1309,1310],{},"Image carousel template",[1216,1312,1313,1316,1319,1320,1322,1323,1326],{},[1292,1314,1315],{},"四種模板訊息的共通屬性",[1317,1318],"br",{},"\n所有 ",[1233,1321,1235],{}," 都必須包含 ",[1233,1324,1325],{},"altText"," 屬性，作為 LINE 通知顯示的替代文字。當使用者收到推播通知時，會顯示此文字內容。",[1265,1328,1330],{"id":1329},"messageeventhandlermap-型別調整","messageEventHandlerMap 型別調整",[1252,1332,1333],{},[1216,1334,1335,1338,1339,1342],{},[1233,1336,1337],{},"Message"," 型別是 ",[1233,1340,1341],{},"LINE SDK"," 提供的所有訊息回覆類型的聯合型別",[1216,1344,1345],{},"在先前的實作中，我們採用「輸入什麼型別，就回覆什麼型別」的對應模式。舉例來說：使用者輸入文字訊息，LINE Bot 就回應文字訊息。這種設計主要是為了方便展示六大基礎訊息類型的對照效果。",[1216,1347,1348,1349,1352,1353,1355],{},"然而在實際開發場景中，我們不應該被這種限制束縛。當收到文字訊息時，我們應該能夠靈活回覆各種訊息類型，只要符合 ",[1233,1350,1351],{},"LINE Bot"," 支援的回覆格式即可。因此，我們將型別調整為更通用的 ",[1233,1354,1337],{}," 類型，讓訊息回覆更加靈活。",[1216,1357,1358],{},[1292,1359,1360],{},"line-webhook\u002Fline-webhook.types.ts",[1362,1363,1368],"pre",{"className":1364,"code":1365,"language":1366,"meta":1367,"style":1367},"language-ts shiki shiki-themes github-light github-dark-dimmed","export type MessageEventHandlerMap = {\n  [K in EventMessage['type']]: (\n    event: Extract\u003CEventMessage, { type: K }>,\n  ) => Message;  \u002F\u002F 主要調整這個部分，讓回傳型別不被限制\n};\n","ts","",[1233,1369,1370,1392,1422,1453,1471],{"__ignoreMap":1367},[1371,1372,1374,1378,1381,1385,1388],"span",{"class":1373,"line":340},"line",[1371,1375,1377],{"class":1376},"s7YZ4","export",[1371,1379,1380],{"class":1376}," type",[1371,1382,1384],{"class":1383},"sOLd2"," MessageEventHandlerMap",[1371,1386,1387],{"class":1376}," =",[1371,1389,1391],{"class":1390},"sYgZi"," {\n",[1371,1393,1394,1397,1400,1403,1406,1409,1413,1416,1419],{"class":1373,"line":329},[1371,1395,1396],{"class":1390},"  [",[1371,1398,1399],{"class":1383},"K",[1371,1401,1402],{"class":1376}," in",[1371,1404,1405],{"class":1383}," EventMessage",[1371,1407,1408],{"class":1390},"[",[1371,1410,1412],{"class":1411},"s-HuK","'type'",[1371,1414,1415],{"class":1390},"]]",[1371,1417,1418],{"class":1376},":",[1371,1420,1421],{"class":1390}," (\n",[1371,1423,1424,1428,1430,1433,1436,1439,1442,1445,1447,1450],{"class":1373,"line":318},[1371,1425,1427],{"class":1426},"stnAF","    event",[1371,1429,1418],{"class":1376},[1371,1431,1432],{"class":1383}," Extract",[1371,1434,1435],{"class":1390},"\u003C",[1371,1437,1438],{"class":1383},"EventMessage",[1371,1440,1441],{"class":1390},", { ",[1371,1443,1444],{"class":1426},"type",[1371,1446,1418],{"class":1376},[1371,1448,1449],{"class":1383}," K",[1371,1451,1452],{"class":1390}," }>,\n",[1371,1454,1455,1458,1461,1464,1467],{"class":1373,"line":134},[1371,1456,1457],{"class":1390},"  ) ",[1371,1459,1460],{"class":1376},"=>",[1371,1462,1463],{"class":1383}," Message",[1371,1465,1466],{"class":1390},";  ",[1371,1468,1470],{"class":1469},"sDN9O","\u002F\u002F 主要調整這個部分，讓回傳型別不被限制\n",[1371,1472,1473],{"class":1373,"line":122},[1371,1474,1475],{"class":1390},"};\n",[1265,1477,1479],{"id":1478},"button-template","Button Template",[1252,1481,1482],{},[1216,1483,1484],{},"支援可選標題及縮圖配置，並提供 1-4 個按鈕的互動選項。",[1216,1486,1487],{},[1219,1488],{"alt":1489,"src":1490},"LINE Button Template Message","https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1758956758\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002FDay%2014%EF%BC%9ALINE%20Bot%20Template%20Message%20%E5%9B%9B%E7%A8%AE%E6%A8%A1%E6%9D%BF%E8%A8%8A%E6%81%AF%E5%9B%9E%E8%A6%86\u002FLINE_Button_Template_Message_zsufpk.png",[1492,1493,1495],"h4",{"id":1494},"step-1新增模板訊息請求的型別","Step 1：新增模板訊息請求的型別",[1216,1497,1498],{},[1292,1499,1500],{},"核心參數：",[1502,1503,1504,1507,1510],"ul",{},[1299,1505,1506],{},"altText：Line 通知顯示的文字",[1299,1508,1509],{},"text：顯示內文(如：「按鈕小精靈出來吧」)",[1299,1511,1512],{},"action：按鈕陣列(支援 1-4 個按鈕)",[1216,1514,1515],{},[1292,1516,1517],{},"可選參數：",[1502,1519,1520,1523],{},[1299,1521,1522],{},"title：模板標題",[1299,1524,1525,1526,1529],{},"thumbnailImageUrl：模板縮圖(如圖中的狗狗圖片)，預設使用",[1233,1527,1528],{},"rectangle(長寬比：1.51:1)","顯示。",[1216,1531,1532],{},[1292,1533,1534],{},"line-message\u002Ftypes\u002Ftemplate-button-message.ts",[1362,1536,1538],{"className":1364,"code":1537,"language":1366,"meta":1367,"style":1367},"import { Action } from '@line\u002Fbot-sdk';\n\ntype HttpsURL = `https:\u002F\u002F${string}`;\n\nexport type TemplateButtonMessageReq = {\n  altText: string;\n  text: string;\n  action: Action[];\n  title?: string;\n  thumbnailImageUrl?: HttpsURL;\n};\n",[1233,1539,1540,1557,1563,1584,1588,1601,1613,1624,1637,1649,1660],{"__ignoreMap":1367},[1371,1541,1542,1545,1548,1551,1554],{"class":1373,"line":340},[1371,1543,1544],{"class":1376},"import",[1371,1546,1547],{"class":1390}," { Action } ",[1371,1549,1550],{"class":1376},"from",[1371,1552,1553],{"class":1411}," '@line\u002Fbot-sdk'",[1371,1555,1556],{"class":1390},";\n",[1371,1558,1559],{"class":1373,"line":329},[1371,1560,1562],{"emptyLinePlaceholder":1561},true,"\n",[1371,1564,1565,1567,1570,1572,1575,1579,1582],{"class":1373,"line":318},[1371,1566,1444],{"class":1376},[1371,1568,1569],{"class":1383}," HttpsURL",[1371,1571,1387],{"class":1376},[1371,1573,1574],{"class":1411}," `https:\u002F\u002F${",[1371,1576,1578],{"class":1577},"sviXB","string",[1371,1580,1581],{"class":1411},"}`",[1371,1583,1556],{"class":1390},[1371,1585,1586],{"class":1373,"line":134},[1371,1587,1562],{"emptyLinePlaceholder":1561},[1371,1589,1590,1592,1594,1597,1599],{"class":1373,"line":122},[1371,1591,1377],{"class":1376},[1371,1593,1380],{"class":1376},[1371,1595,1596],{"class":1383}," TemplateButtonMessageReq",[1371,1598,1387],{"class":1376},[1371,1600,1391],{"class":1390},[1371,1602,1603,1606,1608,1611],{"class":1373,"line":31},[1371,1604,1605],{"class":1426},"  altText",[1371,1607,1418],{"class":1376},[1371,1609,1610],{"class":1577}," string",[1371,1612,1556],{"class":1390},[1371,1614,1615,1618,1620,1622],{"class":1373,"line":17},[1371,1616,1617],{"class":1426},"  text",[1371,1619,1418],{"class":1376},[1371,1621,1610],{"class":1577},[1371,1623,1556],{"class":1390},[1371,1625,1626,1629,1631,1634],{"class":1373,"line":110},[1371,1627,1628],{"class":1426},"  action",[1371,1630,1418],{"class":1376},[1371,1632,1633],{"class":1383}," Action",[1371,1635,1636],{"class":1390},"[];\n",[1371,1638,1639,1642,1645,1647],{"class":1373,"line":76},[1371,1640,1641],{"class":1426},"  title",[1371,1643,1644],{"class":1376},"?:",[1371,1646,1610],{"class":1577},[1371,1648,1556],{"class":1390},[1371,1650,1651,1654,1656,1658],{"class":1373,"line":247},[1371,1652,1653],{"class":1426},"  thumbnailImageUrl",[1371,1655,1644],{"class":1376},[1371,1657,1569],{"class":1383},[1371,1659,1556],{"class":1390},[1371,1661,1662],{"class":1373,"line":236},[1371,1663,1475],{"class":1390},[1492,1665,1667],{"id":1666},"step-2建立模板訊息的封裝函式","Step 2：建立模板訊息的封裝函式",[1216,1669,1670,1671,1674],{},"這裡透過 ",[1233,1672,1673],{},"createButtonTemplateMessage"," 函式來封裝複雜的模板訊息結構，讓開發者只需專注在必要參數的配置上，簡化訊息建立流程。",[1216,1676,1677],{},[1292,1678,1679],{},"line-message\u002Fline-message.service.ts",[1362,1681,1683],{"className":1364,"code":1682,"language":1366,"meta":1367,"style":1367},"  createButtonTemplateMessage(\n    templateButtonMessageReq: TemplateButtonMessageReq,\n  ): TemplateMessage {\n    const { altText, text, actions, thumbnailImageUrl, title } =\n      templateButtonMessageReq;\n\n    const buttonTemplateMessage: TemplateMessage = {\n      type: MessageType.Template,\n      altText,\n      template: {\n        type: MessageType.TemplateButton,\n        text,\n        actions,\n        title,\n        ...(thumbnailImageUrl && { thumbnailImageUrl }), \u002F\u002F 可選參數的處理\n      },\n    };\n\n    return buttonTemplateMessage;\n  }\n",[1233,1684,1685,1694,1699,1704,1741,1746,1750,1766,1771,1776,1781,1786,1791,1796,1801,1818,1823,1828,1832,1840],{"__ignoreMap":1367},[1371,1686,1687,1691],{"class":1373,"line":340},[1371,1688,1690],{"class":1689},"sPO5f","  createButtonTemplateMessage",[1371,1692,1693],{"class":1390},"(\n",[1371,1695,1696],{"class":1373,"line":329},[1371,1697,1698],{"class":1390},"    templateButtonMessageReq: TemplateButtonMessageReq,\n",[1371,1700,1701],{"class":1373,"line":318},[1371,1702,1703],{"class":1390},"  ): TemplateMessage {\n",[1371,1705,1706,1709,1712,1714,1717,1720,1722,1725,1727,1730,1732,1735,1738],{"class":1373,"line":134},[1371,1707,1708],{"class":1376},"    const",[1371,1710,1711],{"class":1390}," { ",[1371,1713,1325],{"class":1577},[1371,1715,1716],{"class":1390},", ",[1371,1718,1719],{"class":1577},"text",[1371,1721,1716],{"class":1390},[1371,1723,1724],{"class":1577},"actions",[1371,1726,1716],{"class":1390},[1371,1728,1729],{"class":1577},"thumbnailImageUrl",[1371,1731,1716],{"class":1390},[1371,1733,1734],{"class":1577},"title",[1371,1736,1737],{"class":1390}," } ",[1371,1739,1740],{"class":1376},"=\n",[1371,1742,1743],{"class":1373,"line":122},[1371,1744,1745],{"class":1390},"      templateButtonMessageReq;\n",[1371,1747,1748],{"class":1373,"line":31},[1371,1749,1562],{"emptyLinePlaceholder":1561},[1371,1751,1752,1754,1757,1759,1762,1764],{"class":1373,"line":17},[1371,1753,1708],{"class":1376},[1371,1755,1756],{"class":1577}," buttonTemplateMessage",[1371,1758,1418],{"class":1376},[1371,1760,1761],{"class":1383}," TemplateMessage",[1371,1763,1387],{"class":1376},[1371,1765,1391],{"class":1390},[1371,1767,1768],{"class":1373,"line":110},[1371,1769,1770],{"class":1390},"      type: MessageType.Template,\n",[1371,1772,1773],{"class":1373,"line":76},[1371,1774,1775],{"class":1390},"      altText,\n",[1371,1777,1778],{"class":1373,"line":247},[1371,1779,1780],{"class":1390},"      template: {\n",[1371,1782,1783],{"class":1373,"line":236},[1371,1784,1785],{"class":1390},"        type: MessageType.TemplateButton,\n",[1371,1787,1788],{"class":1373,"line":225},[1371,1789,1790],{"class":1390},"        text,\n",[1371,1792,1793],{"class":1373,"line":214},[1371,1794,1795],{"class":1390},"        actions,\n",[1371,1797,1798],{"class":1373,"line":203},[1371,1799,1800],{"class":1390},"        title,\n",[1371,1802,1803,1806,1809,1812,1815],{"class":1373,"line":192},[1371,1804,1805],{"class":1376},"        ...",[1371,1807,1808],{"class":1390},"(thumbnailImageUrl ",[1371,1810,1811],{"class":1376},"&&",[1371,1813,1814],{"class":1390}," { thumbnailImageUrl }), ",[1371,1816,1817],{"class":1469},"\u002F\u002F 可選參數的處理\n",[1371,1819,1820],{"class":1373,"line":181},[1371,1821,1822],{"class":1390},"      },\n",[1371,1824,1825],{"class":1373,"line":170},[1371,1826,1827],{"class":1390},"    };\n",[1371,1829,1830],{"class":1373,"line":159},[1371,1831,1562],{"emptyLinePlaceholder":1561},[1371,1833,1834,1837],{"class":1373,"line":148},[1371,1835,1836],{"class":1376},"    return",[1371,1838,1839],{"class":1390}," buttonTemplateMessage;\n",[1371,1841,1842],{"class":1373,"line":137},[1371,1843,1844],{"class":1390},"  }\n",[1492,1846,1848],{"id":1847},"step-3在接收到使用者發送訊息-button-時回傳模板訊息","Step 3：在接收到使用者發送訊息 button 時回傳模板訊息",[1252,1850,1851],{},[1216,1852,1853],{},"Button Template Message Action 最多只能四個！！",[1216,1855,1856],{},"在 Action 類型的選擇上，常用的有三種：",[1502,1858,1859,1862,1865],{},[1299,1860,1861],{},"message(訊息回傳)：點擊後會發送預設文字訊息",[1299,1863,1864],{},"postback(資料回傳)：點擊後會回傳資料給後端，不會在聊天室顯示訊息",[1299,1866,1867],{},"uri(開啟連結)：點擊後會開啟指定的網址",[1216,1869,1870,1871,1873],{},"當使用者傳送 button 文字時，我們會回覆事先準備好的 ",[1233,1872,1479],{}," 訊息。",[1216,1875,1876],{},[1292,1877,1878],{},"line-webhook\u002Fline-webhook.service",[1362,1880,1882],{"className":1364,"code":1881,"language":1366,"meta":1367,"style":1367},"private async handleMessageEvent(event: MessageEvent): Promise\u003Cvoid> {\n     const messageEventHandlerMap = {\n      text: (message) {\n        const { text } = message;\n        \u002F\u002F text 是使用者傳送的文字內容\n        if (text === 'button') {\n          return this.lineMessageService.createButtonTemplateMessage({\n            altText: '按鈕小精靈通知',\n            thumbnailImageUrl: 'https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1753953684\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002Fdog_icon_grxcsl.jpg',\n            title: '標題',\n            text: '按鈕小精靈出來吧',\n            actions: [\n              {\n                type: 'message',\n                label: '我是按鈕 1',\n                text: '我是按鈕 1 號',\n              },\n              {\n                type: 'message',\n                label: '我是按鈕 2',\n                text: '我是按鈕 2 號',\n              },\n              {\n                type: 'message',\n                label: '我是按鈕 3',\n                text: '我是按鈕 3 號',\n              },\n              {\n                type: 'message',\n                label: '我是按鈕～',\n                text: '我是按鈕 4 號',\n              },\n            ],\n          });\n        }\n      },\n    } satisfies Partial\u003CMessageEventHandlerMap>;\n}\n",[1233,1883,1884,1902,1912,1917,1922,1927,1946,1962,1973,1983,1993,2003,2008,2013,2023,2033,2043,2048,2052,2060,2069,2078,2082,2086,2094,2103,2112,2116,2120,2128,2137,2147,2152,2158,2164,2170,2175,2195],{"__ignoreMap":1367},[1371,1885,1886,1889,1892,1895,1897,1900],{"class":1373,"line":340},[1371,1887,1888],{"class":1390},"private async ",[1371,1890,1891],{"class":1689},"handleMessageEvent",[1371,1893,1894],{"class":1390},"(event: MessageEvent): ",[1371,1896,1089],{"class":1577},[1371,1898,1899],{"class":1376},"\u003Cvoid>",[1371,1901,1391],{"class":1390},[1371,1903,1904,1907,1910],{"class":1373,"line":329},[1371,1905,1906],{"class":1390},"     const messageEventHandlerMap ",[1371,1908,1909],{"class":1376},"=",[1371,1911,1391],{"class":1390},[1371,1913,1914],{"class":1373,"line":318},[1371,1915,1916],{"class":1390},"      text: (message) {\n",[1371,1918,1919],{"class":1373,"line":134},[1371,1920,1921],{"class":1390},"        const { text } = message;\n",[1371,1923,1924],{"class":1373,"line":122},[1371,1925,1926],{"class":1469},"        \u002F\u002F text 是使用者傳送的文字內容\n",[1371,1928,1929,1932,1935,1937,1940,1943],{"class":1373,"line":31},[1371,1930,1931],{"class":1689},"        if",[1371,1933,1934],{"class":1390}," (",[1371,1936,1719],{"class":1426},[1371,1938,1939],{"class":1390}," === ",[1371,1941,1942],{"class":1411},"'button'",[1371,1944,1945],{"class":1390},") {\n",[1371,1947,1948,1951,1954,1957,1959],{"class":1373,"line":17},[1371,1949,1950],{"class":1376},"          return",[1371,1952,1953],{"class":1577}," this",[1371,1955,1956],{"class":1390},".lineMessageService.",[1371,1958,1673],{"class":1689},[1371,1960,1961],{"class":1390},"({\n",[1371,1963,1964,1967,1970],{"class":1373,"line":110},[1371,1965,1966],{"class":1390},"            altText: ",[1371,1968,1969],{"class":1411},"'按鈕小精靈通知'",[1371,1971,1972],{"class":1390},",\n",[1371,1974,1975,1978,1981],{"class":1373,"line":76},[1371,1976,1977],{"class":1390},"            thumbnailImageUrl: ",[1371,1979,1980],{"class":1411},"'https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1753953684\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002Fdog_icon_grxcsl.jpg'",[1371,1982,1972],{"class":1390},[1371,1984,1985,1988,1991],{"class":1373,"line":247},[1371,1986,1987],{"class":1390},"            title: ",[1371,1989,1990],{"class":1411},"'標題'",[1371,1992,1972],{"class":1390},[1371,1994,1995,1998,2001],{"class":1373,"line":236},[1371,1996,1997],{"class":1390},"            text: ",[1371,1999,2000],{"class":1411},"'按鈕小精靈出來吧'",[1371,2002,1972],{"class":1390},[1371,2004,2005],{"class":1373,"line":225},[1371,2006,2007],{"class":1390},"            actions: [\n",[1371,2009,2010],{"class":1373,"line":214},[1371,2011,2012],{"class":1390},"              {\n",[1371,2014,2015,2018,2021],{"class":1373,"line":203},[1371,2016,2017],{"class":1390},"                type: ",[1371,2019,2020],{"class":1411},"'message'",[1371,2022,1972],{"class":1390},[1371,2024,2025,2028,2031],{"class":1373,"line":192},[1371,2026,2027],{"class":1390},"                label: ",[1371,2029,2030],{"class":1411},"'我是按鈕 1'",[1371,2032,1972],{"class":1390},[1371,2034,2035,2038,2041],{"class":1373,"line":181},[1371,2036,2037],{"class":1390},"                text: ",[1371,2039,2040],{"class":1411},"'我是按鈕 1 號'",[1371,2042,1972],{"class":1390},[1371,2044,2045],{"class":1373,"line":170},[1371,2046,2047],{"class":1390},"              },\n",[1371,2049,2050],{"class":1373,"line":159},[1371,2051,2012],{"class":1390},[1371,2053,2054,2056,2058],{"class":1373,"line":148},[1371,2055,2017],{"class":1390},[1371,2057,2020],{"class":1411},[1371,2059,1972],{"class":1390},[1371,2061,2062,2064,2067],{"class":1373,"line":137},[1371,2063,2027],{"class":1390},[1371,2065,2066],{"class":1411},"'我是按鈕 2'",[1371,2068,1972],{"class":1390},[1371,2070,2071,2073,2076],{"class":1373,"line":125},[1371,2072,2037],{"class":1390},[1371,2074,2075],{"class":1411},"'我是按鈕 2 號'",[1371,2077,1972],{"class":1390},[1371,2079,2080],{"class":1373,"line":113},[1371,2081,2047],{"class":1390},[1371,2083,2084],{"class":1373,"line":101},[1371,2085,2012],{"class":1390},[1371,2087,2088,2090,2092],{"class":1373,"line":90},[1371,2089,2017],{"class":1390},[1371,2091,2020],{"class":1411},[1371,2093,1972],{"class":1390},[1371,2095,2096,2098,2101],{"class":1373,"line":79},[1371,2097,2027],{"class":1390},[1371,2099,2100],{"class":1411},"'我是按鈕 3'",[1371,2102,1972],{"class":1390},[1371,2104,2105,2107,2110],{"class":1373,"line":67},[1371,2106,2037],{"class":1390},[1371,2108,2109],{"class":1411},"'我是按鈕 3 號'",[1371,2111,1972],{"class":1390},[1371,2113,2114],{"class":1373,"line":56},[1371,2115,2047],{"class":1390},[1371,2117,2118],{"class":1373,"line":45},[1371,2119,2012],{"class":1390},[1371,2121,2122,2124,2126],{"class":1373,"line":34},[1371,2123,2017],{"class":1390},[1371,2125,2020],{"class":1411},[1371,2127,1972],{"class":1390},[1371,2129,2130,2132,2135],{"class":1373,"line":22},[1371,2131,2027],{"class":1390},[1371,2133,2134],{"class":1411},"'我是按鈕～'",[1371,2136,1972],{"class":1390},[1371,2138,2140,2142,2145],{"class":1373,"line":2139},31,[1371,2141,2037],{"class":1390},[1371,2143,2144],{"class":1411},"'我是按鈕 4 號'",[1371,2146,1972],{"class":1390},[1371,2148,2150],{"class":1373,"line":2149},32,[1371,2151,2047],{"class":1390},[1371,2153,2155],{"class":1373,"line":2154},33,[1371,2156,2157],{"class":1390},"            ],\n",[1371,2159,2161],{"class":1373,"line":2160},34,[1371,2162,2163],{"class":1390},"          });\n",[1371,2165,2167],{"class":1373,"line":2166},35,[1371,2168,2169],{"class":1390},"        }\n",[1371,2171,2173],{"class":1373,"line":2172},36,[1371,2174,1822],{"class":1390},[1371,2176,2178,2181,2184,2187,2189,2192],{"class":1373,"line":2177},37,[1371,2179,2180],{"class":1390},"    } ",[1371,2182,2183],{"class":1376},"satisfies",[1371,2185,2186],{"class":1383}," Partial",[1371,2188,1435],{"class":1390},[1371,2190,2191],{"class":1383},"MessageEventHandlerMap",[1371,2193,2194],{"class":1390},">;\n",[1371,2196,2198],{"class":1373,"line":2197},38,[1371,2199,2200],{"class":1390},"}\n",[1265,2202,2204],{"id":2203},"confirm-template","Confirm Template",[1252,2206,2207],{},[1216,2208,2209],{},"專為決策判斷場景設計的模板訊息，必須且只能擁有兩個按鈕",[1216,2211,2212,2214,2215,2217,2218,2220,2221,2224,2225,2228],{},[1233,2213,2204],{}," 是最簡潔的模板格式，適用於需要使用者做出「是\u002F否」、「確認\u002F取消」等二選一決策的情境。與 ",[1233,2216,1479],{}," 不同，",[1233,2219,2204],{}," 沒有",[1233,2222,2223],{},"標題","和",[1233,2226,2227],{},"縮圖","功能",[1216,2230,2231],{},[1219,2232],{"alt":2233,"src":2234},"LINE Bot Confirm Template 訊息回覆","https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1758957578\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002FDay%2014%EF%BC%9ALINE%20Bot%20Template%20Message%20%E5%9B%9B%E7%A8%AE%E6%A8%A1%E6%9D%BF%E8%A8%8A%E6%81%AF%E5%9B%9E%E8%A6%86\u002FLINE_Bot_Confirm_Template_%E8%A8%8A%E6%81%AF%E5%9B%9E%E8%A6%86_fdx6n6.png",[1492,2236,2237],{"id":2237},"型別定義",[1252,2239,2240],{},[1216,2241,2242,2243,2246],{},"透過 Tuple 型別明確定義需要兩個 ",[1233,2244,2245],{},"Action","，編譯時期避免參數數量錯誤的情況發生",[1216,2248,2249],{},[1292,2250,2251],{},"line-message\u002Ftypes\u002Ftemplate-confirm-message",[1362,2253,2255],{"className":1364,"code":2254,"language":1366,"meta":1367,"style":1367},"import { QuickReplyItem, Sender } from '@line\u002Fbot-sdk';\n\nexport type TemplateConfirmMessageReq = {\n  altText: string;\n  text: string;\n  actions: [Action, Action];\n  sender?: Sender;\n  quickReplyItems?: Omit\u003CQuickReplyItem, 'type'>[];\n};\n",[1233,2256,2257,2270,2274,2287,2297,2307,2326,2338,2360],{"__ignoreMap":1367},[1371,2258,2259,2261,2264,2266,2268],{"class":1373,"line":340},[1371,2260,1544],{"class":1376},[1371,2262,2263],{"class":1390}," { QuickReplyItem, Sender } ",[1371,2265,1550],{"class":1376},[1371,2267,1553],{"class":1411},[1371,2269,1556],{"class":1390},[1371,2271,2272],{"class":1373,"line":329},[1371,2273,1562],{"emptyLinePlaceholder":1561},[1371,2275,2276,2278,2280,2283,2285],{"class":1373,"line":318},[1371,2277,1377],{"class":1376},[1371,2279,1380],{"class":1376},[1371,2281,2282],{"class":1383}," TemplateConfirmMessageReq",[1371,2284,1387],{"class":1376},[1371,2286,1391],{"class":1390},[1371,2288,2289,2291,2293,2295],{"class":1373,"line":134},[1371,2290,1605],{"class":1426},[1371,2292,1418],{"class":1376},[1371,2294,1610],{"class":1577},[1371,2296,1556],{"class":1390},[1371,2298,2299,2301,2303,2305],{"class":1373,"line":122},[1371,2300,1617],{"class":1426},[1371,2302,1418],{"class":1376},[1371,2304,1610],{"class":1577},[1371,2306,1556],{"class":1390},[1371,2308,2309,2312,2314,2317,2319,2321,2323],{"class":1373,"line":31},[1371,2310,2311],{"class":1426},"  actions",[1371,2313,1418],{"class":1376},[1371,2315,2316],{"class":1390}," [",[1371,2318,2245],{"class":1383},[1371,2320,1716],{"class":1390},[1371,2322,2245],{"class":1383},[1371,2324,2325],{"class":1390},"];\n",[1371,2327,2328,2331,2333,2336],{"class":1373,"line":17},[1371,2329,2330],{"class":1426},"  sender",[1371,2332,1644],{"class":1376},[1371,2334,2335],{"class":1383}," Sender",[1371,2337,1556],{"class":1390},[1371,2339,2340,2343,2345,2348,2350,2353,2355,2357],{"class":1373,"line":110},[1371,2341,2342],{"class":1426},"  quickReplyItems",[1371,2344,1644],{"class":1376},[1371,2346,2347],{"class":1383}," Omit",[1371,2349,1435],{"class":1390},[1371,2351,2352],{"class":1383},"QuickReplyItem",[1371,2354,1716],{"class":1390},[1371,2356,1412],{"class":1411},[1371,2358,2359],{"class":1390},">[];\n",[1371,2361,2362],{"class":1373,"line":76},[1371,2363,1475],{"class":1390},[1492,2365,2366],{"id":2366},"處理函式",[1216,2368,2369],{},[1292,2370,1679],{},[1362,2372,2374],{"className":1364,"code":2373,"language":1366,"meta":1367,"style":1367},"  createConfirmTemplateMessage(\n    templateConfirmMessageReq: TemplateConfirmMessageReq,\n  ): TemplateMessage {\n    const { altText, text, actions } =\n      templateConfirmMessageReq;\n\n    const templateConfirmMessage: TemplateMessage = {\n      type: MessageType.Template,\n      altText,\n      template: {\n        type: MessageType.TemplateConfirm,\n        text,\n        actions,\n      },\n    };\n\n    return templateConfirmMessage;\n  }\n",[1233,2375,2376,2383,2388,2392,2412,2417,2421,2436,2440,2444,2448,2453,2457,2461,2465,2469,2473,2480],{"__ignoreMap":1367},[1371,2377,2378,2381],{"class":1373,"line":340},[1371,2379,2380],{"class":1689},"  createConfirmTemplateMessage",[1371,2382,1693],{"class":1390},[1371,2384,2385],{"class":1373,"line":329},[1371,2386,2387],{"class":1390},"    templateConfirmMessageReq: TemplateConfirmMessageReq,\n",[1371,2389,2390],{"class":1373,"line":318},[1371,2391,1703],{"class":1390},[1371,2393,2394,2396,2398,2400,2402,2404,2406,2408,2410],{"class":1373,"line":134},[1371,2395,1708],{"class":1376},[1371,2397,1711],{"class":1390},[1371,2399,1325],{"class":1577},[1371,2401,1716],{"class":1390},[1371,2403,1719],{"class":1577},[1371,2405,1716],{"class":1390},[1371,2407,1724],{"class":1577},[1371,2409,1737],{"class":1390},[1371,2411,1740],{"class":1376},[1371,2413,2414],{"class":1373,"line":122},[1371,2415,2416],{"class":1390},"      templateConfirmMessageReq;\n",[1371,2418,2419],{"class":1373,"line":31},[1371,2420,1562],{"emptyLinePlaceholder":1561},[1371,2422,2423,2425,2428,2430,2432,2434],{"class":1373,"line":17},[1371,2424,1708],{"class":1376},[1371,2426,2427],{"class":1577}," templateConfirmMessage",[1371,2429,1418],{"class":1376},[1371,2431,1761],{"class":1383},[1371,2433,1387],{"class":1376},[1371,2435,1391],{"class":1390},[1371,2437,2438],{"class":1373,"line":110},[1371,2439,1770],{"class":1390},[1371,2441,2442],{"class":1373,"line":76},[1371,2443,1775],{"class":1390},[1371,2445,2446],{"class":1373,"line":247},[1371,2447,1780],{"class":1390},[1371,2449,2450],{"class":1373,"line":236},[1371,2451,2452],{"class":1390},"        type: MessageType.TemplateConfirm,\n",[1371,2454,2455],{"class":1373,"line":225},[1371,2456,1790],{"class":1390},[1371,2458,2459],{"class":1373,"line":214},[1371,2460,1795],{"class":1390},[1371,2462,2463],{"class":1373,"line":203},[1371,2464,1822],{"class":1390},[1371,2466,2467],{"class":1373,"line":192},[1371,2468,1827],{"class":1390},[1371,2470,2471],{"class":1373,"line":181},[1371,2472,1562],{"emptyLinePlaceholder":1561},[1371,2474,2475,2477],{"class":1373,"line":170},[1371,2476,1836],{"class":1376},[1371,2478,2479],{"class":1390}," templateConfirmMessage;\n",[1371,2481,2482],{"class":1373,"line":159},[1371,2483,1844],{"class":1390},[1265,2485,2487],{"id":2486},"carousel-template","Carousel Template",[1252,2489,2490],{},[1216,2491,2492],{},"常被使用的模板訊息 ⭐⭐⭐",[1216,2494,2495],{},"支援最多 10 張卡片，每張卡片最多 3 個按鈕，且所有卡片的按鈕數量必須相同。",[1216,2497,2498],{},[1219,2499],{"alt":2500,"src":2501},"LINE Bot Carousel Template","https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1758958083\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002FDay%2014%EF%BC%9ALINE%20Bot%20Template%20Message%20%E5%9B%9B%E7%A8%AE%E6%A8%A1%E6%9D%BF%E8%A8%8A%E6%81%AF%E5%9B%9E%E8%A6%86\u002FLINE_Bot_Carousel_Template_rkr8ga.png",[1492,2503,2237],{"id":2504},"型別定義-1",[1252,2506,2507],{},[1216,2508,2509],{},"建議可以限制一下 action 數量，避免 action 數量不一致的行為",[1216,2511,2512,2513,2516,2517,2519],{},"這裡透過泛型約束的方式，讓原先的函數能夠在編譯時期驗證每張卡片的按鈕數量是否一致，確保所有卡片的 ",[1233,2514,2515],{},"action"," 數量都符合 ",[1233,2518,2487],{}," 的規範要求。",[1216,2521,2522],{},[1292,2523,2524],{},"line-message\u002Ftypes\u002Ftemplate-carousel-message.ts",[1362,2526,2528],{"className":1364,"code":2527,"language":1366,"meta":1367,"style":1367},"import { QuickReplyItem, Sender, TemplateColumn } from '@line\u002Fbot-sdk';\n\ntype FixedArray\u003CT, N extends number> = T[] & { length: N };\n\ntype LimitedActionColumn\u003CN extends number> = Omit\u003C\n  TemplateColumn,\n  'defaultAction' | 'imageBackgroundColor' | 'actions'\n> & {\n  actions: FixedArray\u003CTemplateColumn['actions'][number], N>;\n};\n\nexport type TemplateCarouselMessageReq\u003CN extends number = number> = {\n  altText: string;\n  cards: LimitedActionColumn\u003CN>[];\n  sender?: Sender;\n  quickReplyItems?: Omit\u003CQuickReplyItem, 'type'>[];\n};\n",[1233,2529,2530,2543,2547,2597,2601,2625,2632,2648,2656,2687,2691,2695,2722,2732,2747,2757,2775],{"__ignoreMap":1367},[1371,2531,2532,2534,2537,2539,2541],{"class":1373,"line":340},[1371,2533,1544],{"class":1376},[1371,2535,2536],{"class":1390}," { QuickReplyItem, Sender, TemplateColumn } ",[1371,2538,1550],{"class":1376},[1371,2540,1553],{"class":1411},[1371,2542,1556],{"class":1390},[1371,2544,2545],{"class":1373,"line":329},[1371,2546,1562],{"emptyLinePlaceholder":1561},[1371,2548,2549,2551,2554,2556,2559,2561,2564,2567,2570,2573,2575,2578,2581,2584,2586,2589,2591,2594],{"class":1373,"line":318},[1371,2550,1444],{"class":1376},[1371,2552,2553],{"class":1383}," FixedArray",[1371,2555,1435],{"class":1390},[1371,2557,2558],{"class":1383},"T",[1371,2560,1716],{"class":1390},[1371,2562,2563],{"class":1383},"N",[1371,2565,2566],{"class":1376}," extends",[1371,2568,2569],{"class":1577}," number",[1371,2571,2572],{"class":1390},"> ",[1371,2574,1909],{"class":1376},[1371,2576,2577],{"class":1383}," T",[1371,2579,2580],{"class":1390},"[] ",[1371,2582,2583],{"class":1376},"&",[1371,2585,1711],{"class":1390},[1371,2587,2588],{"class":1426},"length",[1371,2590,1418],{"class":1376},[1371,2592,2593],{"class":1383}," N",[1371,2595,2596],{"class":1390}," };\n",[1371,2598,2599],{"class":1373,"line":134},[1371,2600,1562],{"emptyLinePlaceholder":1561},[1371,2602,2603,2605,2608,2610,2612,2614,2616,2618,2620,2622],{"class":1373,"line":122},[1371,2604,1444],{"class":1376},[1371,2606,2607],{"class":1383}," LimitedActionColumn",[1371,2609,1435],{"class":1390},[1371,2611,2563],{"class":1383},[1371,2613,2566],{"class":1376},[1371,2615,2569],{"class":1577},[1371,2617,2572],{"class":1390},[1371,2619,1909],{"class":1376},[1371,2621,2347],{"class":1383},[1371,2623,2624],{"class":1390},"\u003C\n",[1371,2626,2627,2630],{"class":1373,"line":31},[1371,2628,2629],{"class":1383},"  TemplateColumn",[1371,2631,1972],{"class":1390},[1371,2633,2634,2637,2640,2643,2645],{"class":1373,"line":17},[1371,2635,2636],{"class":1411},"  'defaultAction'",[1371,2638,2639],{"class":1376}," |",[1371,2641,2642],{"class":1411}," 'imageBackgroundColor'",[1371,2644,2639],{"class":1376},[1371,2646,2647],{"class":1411}," 'actions'\n",[1371,2649,2650,2652,2654],{"class":1373,"line":110},[1371,2651,2572],{"class":1390},[1371,2653,2583],{"class":1376},[1371,2655,1391],{"class":1390},[1371,2657,2658,2660,2662,2664,2666,2669,2671,2674,2677,2680,2683,2685],{"class":1373,"line":76},[1371,2659,2311],{"class":1426},[1371,2661,1418],{"class":1376},[1371,2663,2553],{"class":1383},[1371,2665,1435],{"class":1390},[1371,2667,2668],{"class":1383},"TemplateColumn",[1371,2670,1408],{"class":1390},[1371,2672,2673],{"class":1411},"'actions'",[1371,2675,2676],{"class":1390},"][",[1371,2678,2679],{"class":1577},"number",[1371,2681,2682],{"class":1390},"], ",[1371,2684,2563],{"class":1383},[1371,2686,2194],{"class":1390},[1371,2688,2689],{"class":1373,"line":247},[1371,2690,1475],{"class":1390},[1371,2692,2693],{"class":1373,"line":236},[1371,2694,1562],{"emptyLinePlaceholder":1561},[1371,2696,2697,2699,2701,2704,2706,2708,2710,2712,2714,2716,2718,2720],{"class":1373,"line":225},[1371,2698,1377],{"class":1376},[1371,2700,1380],{"class":1376},[1371,2702,2703],{"class":1383}," TemplateCarouselMessageReq",[1371,2705,1435],{"class":1390},[1371,2707,2563],{"class":1383},[1371,2709,2566],{"class":1376},[1371,2711,2569],{"class":1577},[1371,2713,1387],{"class":1376},[1371,2715,2569],{"class":1577},[1371,2717,2572],{"class":1390},[1371,2719,1909],{"class":1376},[1371,2721,1391],{"class":1390},[1371,2723,2724,2726,2728,2730],{"class":1373,"line":214},[1371,2725,1605],{"class":1426},[1371,2727,1418],{"class":1376},[1371,2729,1610],{"class":1577},[1371,2731,1556],{"class":1390},[1371,2733,2734,2737,2739,2741,2743,2745],{"class":1373,"line":203},[1371,2735,2736],{"class":1426},"  cards",[1371,2738,1418],{"class":1376},[1371,2740,2607],{"class":1383},[1371,2742,1435],{"class":1390},[1371,2744,2563],{"class":1383},[1371,2746,2359],{"class":1390},[1371,2748,2749,2751,2753,2755],{"class":1373,"line":192},[1371,2750,2330],{"class":1426},[1371,2752,1644],{"class":1376},[1371,2754,2335],{"class":1383},[1371,2756,1556],{"class":1390},[1371,2758,2759,2761,2763,2765,2767,2769,2771,2773],{"class":1373,"line":181},[1371,2760,2342],{"class":1426},[1371,2762,1644],{"class":1376},[1371,2764,2347],{"class":1383},[1371,2766,1435],{"class":1390},[1371,2768,2352],{"class":1383},[1371,2770,1716],{"class":1390},[1371,2772,1412],{"class":1411},[1371,2774,2359],{"class":1390},[1371,2776,2777],{"class":1373,"line":170},[1371,2778,1475],{"class":1390},[1492,2780,2366],{"id":2781},"處理函式-1",[1216,2783,2784,2786,2787,2789,2790,2793],{},[1233,2785,2487],{}," 與 ",[1233,2788,1479],{}," 的主要差異在於 ",[1233,2791,2792],{},"cards"," 參數，每張卡片支援以下配置：",[1216,2795,2796],{},[1292,2797,1500],{},[1502,2799,2800,2803],{},[1299,2801,2802],{},"text：卡片內文",[1299,2804,2805],{},"actions：卡片按鈕陣列(最多 3 個)",[1216,2807,2808],{},[1292,2809,1517],{},[1502,2811,2812,2815],{},[1299,2813,2814],{},"title：卡片標題",[1299,2816,2817],{},"thumbnailImageUrl：卡片縮圖",[1216,2819,2820,2821,2823],{},"卡片的參數配置與 ",[1233,2822,1479],{}," 基本相同，但透過陣列形式支援多張卡片的輪播展示。",[1216,2825,2826],{},[1292,2827,2828],{},"line-message.service\u002Fline-message.service.ts",[1362,2830,2832],{"className":1364,"code":2831,"language":1366,"meta":1367,"style":1367},"  createTemplateCarouselMessage\u003CN extends number>(\n    templateCarouselMessageReq: TemplateCarouselMessageReq\u003CN>,\n  ): TemplateMessage {\n    const { altText, cards, sender, quickReplyItems } =\n      templateCarouselMessageReq;\n\n    const templateCarouselMessage: TemplateMessage = {\n      type: MessageType.Template,\n      altText,\n      template: {\n        type: MessageType.TemplateCarousel,\n        columns: [...cards],\n      },\n    };\n\n    return templateCarouselMessage;\n  }\n",[1233,2833,2834,2851,2864,2868,2894,2899,2903,2918,2922,2926,2930,2935,2946,2950,2954,2958,2965],{"__ignoreMap":1367},[1371,2835,2836,2839,2841,2843,2846,2849],{"class":1373,"line":340},[1371,2837,2838],{"class":1390},"  createTemplateCarouselMessage",[1371,2840,1435],{"class":1376},[1371,2842,2563],{"class":1577},[1371,2844,2845],{"class":1390}," extends number",[1371,2847,2848],{"class":1376},">",[1371,2850,1693],{"class":1390},[1371,2852,2853,2856,2858,2860,2862],{"class":1373,"line":329},[1371,2854,2855],{"class":1390},"    templateCarouselMessageReq: TemplateCarouselMessageReq",[1371,2857,1435],{"class":1376},[1371,2859,2563],{"class":1577},[1371,2861,2848],{"class":1376},[1371,2863,1972],{"class":1390},[1371,2865,2866],{"class":1373,"line":318},[1371,2867,1703],{"class":1390},[1371,2869,2870,2872,2874,2876,2878,2880,2882,2885,2887,2890,2892],{"class":1373,"line":134},[1371,2871,1708],{"class":1376},[1371,2873,1711],{"class":1390},[1371,2875,1325],{"class":1577},[1371,2877,1716],{"class":1390},[1371,2879,2792],{"class":1577},[1371,2881,1716],{"class":1390},[1371,2883,2884],{"class":1577},"sender",[1371,2886,1716],{"class":1390},[1371,2888,2889],{"class":1577},"quickReplyItems",[1371,2891,1737],{"class":1390},[1371,2893,1740],{"class":1376},[1371,2895,2896],{"class":1373,"line":122},[1371,2897,2898],{"class":1390},"      templateCarouselMessageReq;\n",[1371,2900,2901],{"class":1373,"line":31},[1371,2902,1562],{"emptyLinePlaceholder":1561},[1371,2904,2905,2907,2910,2912,2914,2916],{"class":1373,"line":17},[1371,2906,1708],{"class":1376},[1371,2908,2909],{"class":1577}," templateCarouselMessage",[1371,2911,1418],{"class":1376},[1371,2913,1761],{"class":1383},[1371,2915,1387],{"class":1376},[1371,2917,1391],{"class":1390},[1371,2919,2920],{"class":1373,"line":110},[1371,2921,1770],{"class":1390},[1371,2923,2924],{"class":1373,"line":76},[1371,2925,1775],{"class":1390},[1371,2927,2928],{"class":1373,"line":247},[1371,2929,1780],{"class":1390},[1371,2931,2932],{"class":1373,"line":236},[1371,2933,2934],{"class":1390},"        type: MessageType.TemplateCarousel,\n",[1371,2936,2937,2940,2943],{"class":1373,"line":225},[1371,2938,2939],{"class":1390},"        columns: [",[1371,2941,2942],{"class":1376},"...",[1371,2944,2945],{"class":1390},"cards],\n",[1371,2947,2948],{"class":1373,"line":214},[1371,2949,1822],{"class":1390},[1371,2951,2952],{"class":1373,"line":203},[1371,2953,1827],{"class":1390},[1371,2955,2956],{"class":1373,"line":192},[1371,2957,1562],{"emptyLinePlaceholder":1561},[1371,2959,2960,2962],{"class":1373,"line":181},[1371,2961,1836],{"class":1376},[1371,2963,2964],{"class":1390}," templateCarouselMessage;\n",[1371,2966,2967],{"class":1373,"line":170},[1371,2968,1844],{"class":1390},[2970,2971],"hr",{},[1216,2973,2974],{},"透過泛型參數指定每張卡片的按鈕數量，實現編譯時期的靜態檢查：",[1216,2976,2977],{},[1292,2978,2979],{},"line-webhook.service\u002Fline-webhook.service.ts",[1362,2981,2983],{"className":1364,"code":2982,"language":1366,"meta":1367,"style":1367},"\u002F\u002F 指定每張卡片只能有 1 個按鈕\nthis.lineMessageService.createTemplateCarouselMessage\u003C1>({\n    altText: '最新活動消息！！',\n    cards: [\n      {\n        text: '新生代狗狗寵物展',\n        thumbnailImageUrl:\n          'https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1753953684\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002Fdog_icon_grxcsl.jpg',\n        actions: [\n          {\n            type: 'message',\n            label: '搶先第一手資訊',\n            text: '可愛狗狗展',\n          },\n        ],\n      },\n      {\n        text: '可愛貓貓展',\n        thumbnailImageUrl:\n          'https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1753953684\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002Fdog_icon_grxcsl.jpg',\n        actions: [\n          {\n            type: 'message',\n            label: '搶先第一手資訊',\n            text: '可愛貓貓展',\n          },\n        ],\n      },\n    ],\n",[1233,2984,2985,2990,3006,3016,3021,3026,3036,3041,3048,3053,3058,3067,3077,3086,3091,3096,3100,3104,3113,3117,3123,3127,3131,3139,3147,3155,3159,3163,3167],{"__ignoreMap":1367},[1371,2986,2987],{"class":1373,"line":340},[1371,2988,2989],{"class":1469},"\u002F\u002F 指定每張卡片只能有 1 個按鈕\n",[1371,2991,2992,2994,2997,2999,3002,3004],{"class":1373,"line":329},[1371,2993,1128],{"class":1577},[1371,2995,2996],{"class":1390},".lineMessageService.createTemplateCarouselMessage",[1371,2998,1435],{"class":1376},[1371,3000,3001],{"class":1577},"1",[1371,3003,2848],{"class":1376},[1371,3005,1961],{"class":1390},[1371,3007,3008,3011,3014],{"class":1373,"line":318},[1371,3009,3010],{"class":1390},"    altText: ",[1371,3012,3013],{"class":1411},"'最新活動消息！！'",[1371,3015,1972],{"class":1390},[1371,3017,3018],{"class":1373,"line":134},[1371,3019,3020],{"class":1390},"    cards: [\n",[1371,3022,3023],{"class":1373,"line":122},[1371,3024,3025],{"class":1390},"      {\n",[1371,3027,3028,3031,3034],{"class":1373,"line":31},[1371,3029,3030],{"class":1390},"        text: ",[1371,3032,3033],{"class":1411},"'新生代狗狗寵物展'",[1371,3035,1972],{"class":1390},[1371,3037,3038],{"class":1373,"line":17},[1371,3039,3040],{"class":1390},"        thumbnailImageUrl:\n",[1371,3042,3043,3046],{"class":1373,"line":110},[1371,3044,3045],{"class":1411},"          'https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1753953684\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002Fdog_icon_grxcsl.jpg'",[1371,3047,1972],{"class":1390},[1371,3049,3050],{"class":1373,"line":76},[1371,3051,3052],{"class":1390},"        actions: [\n",[1371,3054,3055],{"class":1373,"line":247},[1371,3056,3057],{"class":1390},"          {\n",[1371,3059,3060,3063,3065],{"class":1373,"line":236},[1371,3061,3062],{"class":1390},"            type: ",[1371,3064,2020],{"class":1411},[1371,3066,1972],{"class":1390},[1371,3068,3069,3072,3075],{"class":1373,"line":225},[1371,3070,3071],{"class":1390},"            label: ",[1371,3073,3074],{"class":1411},"'搶先第一手資訊'",[1371,3076,1972],{"class":1390},[1371,3078,3079,3081,3084],{"class":1373,"line":214},[1371,3080,1997],{"class":1390},[1371,3082,3083],{"class":1411},"'可愛狗狗展'",[1371,3085,1972],{"class":1390},[1371,3087,3088],{"class":1373,"line":203},[1371,3089,3090],{"class":1390},"          },\n",[1371,3092,3093],{"class":1373,"line":192},[1371,3094,3095],{"class":1390},"        ],\n",[1371,3097,3098],{"class":1373,"line":181},[1371,3099,1822],{"class":1390},[1371,3101,3102],{"class":1373,"line":170},[1371,3103,3025],{"class":1390},[1371,3105,3106,3108,3111],{"class":1373,"line":159},[1371,3107,3030],{"class":1390},[1371,3109,3110],{"class":1411},"'可愛貓貓展'",[1371,3112,1972],{"class":1390},[1371,3114,3115],{"class":1373,"line":148},[1371,3116,3040],{"class":1390},[1371,3118,3119,3121],{"class":1373,"line":137},[1371,3120,3045],{"class":1411},[1371,3122,1972],{"class":1390},[1371,3124,3125],{"class":1373,"line":125},[1371,3126,3052],{"class":1390},[1371,3128,3129],{"class":1373,"line":113},[1371,3130,3057],{"class":1390},[1371,3132,3133,3135,3137],{"class":1373,"line":101},[1371,3134,3062],{"class":1390},[1371,3136,2020],{"class":1411},[1371,3138,1972],{"class":1390},[1371,3140,3141,3143,3145],{"class":1373,"line":90},[1371,3142,3071],{"class":1390},[1371,3144,3074],{"class":1411},[1371,3146,1972],{"class":1390},[1371,3148,3149,3151,3153],{"class":1373,"line":79},[1371,3150,1997],{"class":1390},[1371,3152,3110],{"class":1411},[1371,3154,1972],{"class":1390},[1371,3156,3157],{"class":1373,"line":67},[1371,3158,3090],{"class":1390},[1371,3160,3161],{"class":1373,"line":56},[1371,3162,3095],{"class":1390},[1371,3164,3165],{"class":1373,"line":45},[1371,3166,1822],{"class":1390},[1371,3168,3169],{"class":1373,"line":34},[1371,3170,3171],{"class":1390},"    ],\n",[1265,3173,3175],{"id":3174},"imagecarousel-template","ImageCarousel Template",[1252,3177,3178],{},[1216,3179,3180],{},"實務開發中的熱門選擇 ⭐⭐⭐",[1216,3182,3183],{},"以圖片為主軸的輪播卡片模板，版型固定，只能調整圖片及按鈕。",[1216,3185,3186],{},"每張卡片均必須填寫以下配置：",[1502,3188,3189,3192],{},[1299,3190,3191],{},"imageUrl：卡片背景圖片",[1299,3193,3194],{},"action：互動按鈕(限定一個)",[1216,3196,3197],{},[1219,3198],{"alt":3199,"src":3200},"LINE ImageCarousel Message","https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1758959239\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002FDay%2014%EF%BC%9ALINE%20Bot%20Template%20Message%20%E5%9B%9B%E7%A8%AE%E6%A8%A1%E6%9D%BF%E8%A8%8A%E6%81%AF%E5%9B%9E%E8%A6%86\u002FLINE_ImageCarousel_Message_qzo82r.png",[1492,3202,2237],{"id":3203},"型別定義-2",[1216,3205,3206],{},"定義上會跟 Carousel Template 蠻類似的，但是這邊因為只能設定一個按鈕，所以會相對單純。",[1362,3208,3210],{"className":1364,"code":3209,"language":1366,"meta":1367,"style":1367},"import { QuickReplyItem, Sender, TemplateImageColumn } from '@line\u002Fbot-sdk';\n\nexport type TemplateImageCarouselMessageReq = {\n  altText: string;\n  cards: TemplateImageColumn[]; \u002F\u002F 這邊的型別跟 Carousel Template 不同喔！！！\n  sender?: Sender;\n  quickReplyItems?: Omit\u003CQuickReplyItem, 'type'>[];\n};\n",[1233,3211,3212,3225,3229,3242,3252,3267,3277,3295],{"__ignoreMap":1367},[1371,3213,3214,3216,3219,3221,3223],{"class":1373,"line":340},[1371,3215,1544],{"class":1376},[1371,3217,3218],{"class":1390}," { QuickReplyItem, Sender, TemplateImageColumn } ",[1371,3220,1550],{"class":1376},[1371,3222,1553],{"class":1411},[1371,3224,1556],{"class":1390},[1371,3226,3227],{"class":1373,"line":329},[1371,3228,1562],{"emptyLinePlaceholder":1561},[1371,3230,3231,3233,3235,3238,3240],{"class":1373,"line":318},[1371,3232,1377],{"class":1376},[1371,3234,1380],{"class":1376},[1371,3236,3237],{"class":1383}," TemplateImageCarouselMessageReq",[1371,3239,1387],{"class":1376},[1371,3241,1391],{"class":1390},[1371,3243,3244,3246,3248,3250],{"class":1373,"line":134},[1371,3245,1605],{"class":1426},[1371,3247,1418],{"class":1376},[1371,3249,1610],{"class":1577},[1371,3251,1556],{"class":1390},[1371,3253,3254,3256,3258,3261,3264],{"class":1373,"line":122},[1371,3255,2736],{"class":1426},[1371,3257,1418],{"class":1376},[1371,3259,3260],{"class":1383}," TemplateImageColumn",[1371,3262,3263],{"class":1390},"[]; ",[1371,3265,3266],{"class":1469},"\u002F\u002F 這邊的型別跟 Carousel Template 不同喔！！！\n",[1371,3268,3269,3271,3273,3275],{"class":1373,"line":31},[1371,3270,2330],{"class":1426},[1371,3272,1644],{"class":1376},[1371,3274,2335],{"class":1383},[1371,3276,1556],{"class":1390},[1371,3278,3279,3281,3283,3285,3287,3289,3291,3293],{"class":1373,"line":17},[1371,3280,2342],{"class":1426},[1371,3282,1644],{"class":1376},[1371,3284,2347],{"class":1383},[1371,3286,1435],{"class":1390},[1371,3288,2352],{"class":1383},[1371,3290,1716],{"class":1390},[1371,3292,1412],{"class":1411},[1371,3294,2359],{"class":1390},[1371,3296,3297],{"class":1373,"line":110},[1371,3298,1475],{"class":1390},[1492,3300,2366],{"id":3301},"處理函式-2",[1216,3303,3304,3305,3307,3308,3310],{},"使用上與 ",[1233,3306,2487],{}," 相似，但 ",[1233,3309,3175],{}," 的每張卡片都必須設置圖片和按鈕。",[1362,3312,3314],{"className":1364,"code":3313,"language":1366,"meta":1367,"style":1367},"  createTemplateImageCarouselMessage(\n    templateImageCarouselMessageReq: TemplateImageCarouselMessageReq,\n  ): TemplateMessage {\n    const { altText, cards, sender, quickReplyItems } =\n      templateImageCarouselMessageReq;\n\n    const templateImageCarouselMessage: TemplateMessage = {\n      type: MessageType.Template,\n      altText,\n      template: {\n        type: MessageType.TemplateImageCarousel,\n        columns: [...cards],\n      },\n      ...this.buildCommonMessageProps(sender, quickReplyItems),\n    };\n    return templateImageCarouselMessage;\n  }\n",[1233,3315,3316,3323,3328,3332,3356,3361,3365,3380,3384,3388,3392,3397,3405,3409,3425,3429,3436],{"__ignoreMap":1367},[1371,3317,3318,3321],{"class":1373,"line":340},[1371,3319,3320],{"class":1689},"  createTemplateImageCarouselMessage",[1371,3322,1693],{"class":1390},[1371,3324,3325],{"class":1373,"line":329},[1371,3326,3327],{"class":1390},"    templateImageCarouselMessageReq: TemplateImageCarouselMessageReq,\n",[1371,3329,3330],{"class":1373,"line":318},[1371,3331,1703],{"class":1390},[1371,3333,3334,3336,3338,3340,3342,3344,3346,3348,3350,3352,3354],{"class":1373,"line":134},[1371,3335,1708],{"class":1376},[1371,3337,1711],{"class":1390},[1371,3339,1325],{"class":1577},[1371,3341,1716],{"class":1390},[1371,3343,2792],{"class":1577},[1371,3345,1716],{"class":1390},[1371,3347,2884],{"class":1577},[1371,3349,1716],{"class":1390},[1371,3351,2889],{"class":1577},[1371,3353,1737],{"class":1390},[1371,3355,1740],{"class":1376},[1371,3357,3358],{"class":1373,"line":122},[1371,3359,3360],{"class":1390},"      templateImageCarouselMessageReq;\n",[1371,3362,3363],{"class":1373,"line":31},[1371,3364,1562],{"emptyLinePlaceholder":1561},[1371,3366,3367,3369,3372,3374,3376,3378],{"class":1373,"line":17},[1371,3368,1708],{"class":1376},[1371,3370,3371],{"class":1577}," templateImageCarouselMessage",[1371,3373,1418],{"class":1376},[1371,3375,1761],{"class":1383},[1371,3377,1387],{"class":1376},[1371,3379,1391],{"class":1390},[1371,3381,3382],{"class":1373,"line":110},[1371,3383,1770],{"class":1390},[1371,3385,3386],{"class":1373,"line":76},[1371,3387,1775],{"class":1390},[1371,3389,3390],{"class":1373,"line":247},[1371,3391,1780],{"class":1390},[1371,3393,3394],{"class":1373,"line":236},[1371,3395,3396],{"class":1390},"        type: MessageType.TemplateImageCarousel,\n",[1371,3398,3399,3401,3403],{"class":1373,"line":225},[1371,3400,2939],{"class":1390},[1371,3402,2942],{"class":1376},[1371,3404,2945],{"class":1390},[1371,3406,3407],{"class":1373,"line":214},[1371,3408,1822],{"class":1390},[1371,3410,3411,3414,3416,3419,3422],{"class":1373,"line":203},[1371,3412,3413],{"class":1376},"      ...",[1371,3415,1128],{"class":1577},[1371,3417,3418],{"class":1390},".",[1371,3420,3421],{"class":1689},"buildCommonMessageProps",[1371,3423,3424],{"class":1390},"(sender, quickReplyItems),\n",[1371,3426,3427],{"class":1373,"line":192},[1371,3428,1827],{"class":1390},[1371,3430,3431,3433],{"class":1373,"line":181},[1371,3432,1836],{"class":1376},[1371,3434,3435],{"class":1390}," templateImageCarouselMessage;\n",[1371,3437,3438],{"class":1373,"line":170},[1371,3439,1844],{"class":1390},[1265,3441,3442],{"id":3442},"本日結語",[1216,3444,3445],{},"今天我們完成了第一種進階回覆訊息 Template Message 的實作。這類模板的使用方式相當直觀，只需準備好必要參數，就能快速產生對應的模板訊息。",[1216,3447,3448],{},"然而，正如開頭提到的，Template Message 的客製化程度有限。例如想為商品模板加上「特價標籤」或其他個性化元素，Template Message 無法直接實現。這種標準化的限制，讓模板訊息比較難凸顯獨特的設計特色。",[3450,3451,3452],"style",{},"html pre.shiki code .s7YZ4, html code.shiki .s7YZ4{--shiki-default:#D73A49;--shiki-dark:#F47067}html pre.shiki code .sOLd2, html code.shiki .sOLd2{--shiki-default:#6F42C1;--shiki-dark:#F69D50}html pre.shiki code .sYgZi, html code.shiki .sYgZi{--shiki-default:#24292E;--shiki-dark:#ADBAC7}html pre.shiki code .s-HuK, html code.shiki .s-HuK{--shiki-default:#032F62;--shiki-dark:#96D0FF}html pre.shiki code .stnAF, html code.shiki .stnAF{--shiki-default:#E36209;--shiki-dark:#F69D50}html pre.shiki code .sDN9O, html code.shiki .sDN9O{--shiki-default:#6A737D;--shiki-dark:#768390}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sviXB, html code.shiki .sviXB{--shiki-default:#005CC5;--shiki-dark:#6CB6FF}html pre.shiki code .sPO5f, html code.shiki .sPO5f{--shiki-default:#6F42C1;--shiki-dark:#DCBDFB}",{"title":1367,"searchDepth":134,"depth":134,"links":3454},[3455],{"id":1226,"depth":329,"text":1226,"children":3456},[3457,3458,3459,3464,3468,3472,3476],{"id":1267,"depth":318,"text":1235},{"id":1329,"depth":318,"text":1330},{"id":1478,"depth":318,"text":1479,"children":3460},[3461,3462,3463],{"id":1494,"depth":134,"text":1495},{"id":1666,"depth":134,"text":1667},{"id":1847,"depth":134,"text":1848},{"id":2203,"depth":318,"text":2204,"children":3465},[3466,3467],{"id":2237,"depth":134,"text":2237},{"id":2366,"depth":134,"text":2366},{"id":2486,"depth":318,"text":2487,"children":3469},[3470,3471],{"id":2504,"depth":134,"text":2237},{"id":2781,"depth":134,"text":2366},{"id":3174,"depth":318,"text":3175,"children":3473},[3474,3475],{"id":3203,"depth":134,"text":2237},{"id":3301,"depth":134,"text":2366},{"id":3442,"depth":318,"text":3442},[11,362],"md",{},"---\ntitle: \"Day 14：LINE Bot Template Message 訊息回覆\"\ndate: 2025-09-27 15:54:06\ntags:\n  - \"iThome 鐵人賽\"\n  - \"2025 鐵人賽\"\n  - \"Line Bot\"\n  - \"NestJS\"\ncategories:\n  - \"iThome 鐵人賽\"\n  - \"Line Bot\"\ndescription: \"經過前幾天的學習，我們已經成功掌握了 LINE Bot 六大基礎訊息類型的發送技巧，為訊息互動奠定了穩固的基礎。今天，我們將踏入更具挑戰性的進階應用領域！\"\ncanonical: https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10388976\nseries:\n  name: \"2025 iThome 鐵人賽：Line Bot × NestJS：30 天開發日記\"\n  url: https:\u002F\u002Fithelp.ithome.com.tw\u002Fusers\u002F20116554\u002Fironman\u002F8779\n  day: 14\n---\n\n![2025 鐵人賽背景圖](https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1758954048\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002FDay%2014%EF%BC%9ALINE%20Bot%20Template%20Message%20%E5%9B%9B%E7%A8%AE%E6%A8%A1%E6%9D%BF%E8%A8%8A%E6%81%AF%E5%9B%9E%E8%A6%86\u002F2025_%E9%90%B5%E4%BA%BA%E8%B3%BD%E4%BD%BF%E7%94%A8_aiizii.png)\n\n## 前言\n\n經過前幾天的學習，我們已經成功掌握了 LINE Bot 六大基礎訊息類型的發送技巧，為訊息互動奠定了穩固的基礎。今天，我們將踏入更具挑戰性的進階應用領域！\n\n在實際的 LINE Bot 開發場景中，除了六大基礎訊息類型外，LINE 官方還提供了三種進階訊息格式：`Template Message`、`Imagemap Message` 及 `Flex Message`。\n\n今天，我們將深入探索第一種進階訊息格式 `Template Message`，學習如何運用預設的模板佈局，快速打造出視覺統一且互動豐富的訊息回覆。\n\n> 本日程式碼的[範例連結](https:\u002F\u002Fgithub.com\u002FLING-JUN-HAO\u002Fnestjs-linebot-ironman\u002Ftree\u002Fday11)\n\n### Template Message\n\n> [Day 13](https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10388037)提到的訊息共通參數 `Sender` 及 `Quick Reply` 同樣適用於所有進階訊息格式(Template Message、ImageMapMessage、FlexMessage）。\n\n`Template Message` 可以理解為 LINE 官方預先設計的訊息模板佈局系統。開發者只需將所需參數代入模板中，即可快速產生具有統一視覺風格的互動式訊息。這種設計大幅提升了開發效率，但相對地在客製化程度上會有一定的限制。\n\n**模板訊息總共有四種：**\n\n1. Buttons template\n2. Confirm template\n3. Carousel template\n4. Image carousel template\n\n**四種模板訊息的共通屬性**  \n所有 `Template Message` 都必須包含 `altText` 屬性，作為 LINE 通知顯示的替代文字。當使用者收到推播通知時，會顯示此文字內容。\n\n### messageEventHandlerMap 型別調整\n\n> `Message` 型別是 `LINE SDK` 提供的所有訊息回覆類型的聯合型別\n\n在先前的實作中，我們採用「輸入什麼型別，就回覆什麼型別」的對應模式。舉例來說：使用者輸入文字訊息，LINE Bot 就回應文字訊息。這種設計主要是為了方便展示六大基礎訊息類型的對照效果。\n\n然而在實際開發場景中，我們不應該被這種限制束縛。當收到文字訊息時，我們應該能夠靈活回覆各種訊息類型，只要符合 `LINE Bot` 支援的回覆格式即可。因此，我們將型別調整為更通用的 `Message` 類型，讓訊息回覆更加靈活。\n\n**line-webhook\u002Fline-webhook.types.ts**\n\n```ts\nexport type MessageEventHandlerMap = {\n  [K in EventMessage['type']]: (\n    event: Extract\u003CEventMessage, { type: K }>,\n  ) => Message;  \u002F\u002F 主要調整這個部分，讓回傳型別不被限制\n};\n```\n\n### Button Template\n\n> 支援可選標題及縮圖配置，並提供 1-4 個按鈕的互動選項。\n\n![LINE Button Template Message](https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1758956758\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002FDay%2014%EF%BC%9ALINE%20Bot%20Template%20Message%20%E5%9B%9B%E7%A8%AE%E6%A8%A1%E6%9D%BF%E8%A8%8A%E6%81%AF%E5%9B%9E%E8%A6%86\u002FLINE_Button_Template_Message_zsufpk.png)\n\n#### Step 1：新增模板訊息請求的型別\n\n**核心參數：**\n\n- altText：Line 通知顯示的文字\n- text：顯示內文(如：「按鈕小精靈出來吧」)\n- action：按鈕陣列(支援 1-4 個按鈕)\n\n**可選參數：**\n\n- title：模板標題\n- thumbnailImageUrl：模板縮圖(如圖中的狗狗圖片)，預設使用`rectangle(長寬比：1.51:1)`顯示。\n\n**line-message\u002Ftypes\u002Ftemplate-button-message.ts**\n\n```ts\nimport { Action } from '@line\u002Fbot-sdk';\n\ntype HttpsURL = `https:\u002F\u002F${string}`;\n\nexport type TemplateButtonMessageReq = {\n  altText: string;\n  text: string;\n  action: Action[];\n  title?: string;\n  thumbnailImageUrl?: HttpsURL;\n};\n```\n\n#### Step 2：建立模板訊息的封裝函式\n\n這裡透過 `createButtonTemplateMessage` 函式來封裝複雜的模板訊息結構，讓開發者只需專注在必要參數的配置上，簡化訊息建立流程。\n\n**line-message\u002Fline-message.service.ts**\n\n```ts\n  createButtonTemplateMessage(\n    templateButtonMessageReq: TemplateButtonMessageReq,\n  ): TemplateMessage {\n    const { altText, text, actions, thumbnailImageUrl, title } =\n      templateButtonMessageReq;\n\n    const buttonTemplateMessage: TemplateMessage = {\n      type: MessageType.Template,\n      altText,\n      template: {\n        type: MessageType.TemplateButton,\n        text,\n        actions,\n        title,\n        ...(thumbnailImageUrl && { thumbnailImageUrl }), \u002F\u002F 可選參數的處理\n      },\n    };\n\n    return buttonTemplateMessage;\n  }\n```\n\n#### Step 3：在接收到使用者發送訊息 button 時回傳模板訊息\n\n> Button Template Message Action 最多只能四個！！\n\n在 Action 類型的選擇上，常用的有三種：\n\n- message(訊息回傳)：點擊後會發送預設文字訊息\n- postback(資料回傳)：點擊後會回傳資料給後端，不會在聊天室顯示訊息\n- uri(開啟連結)：點擊後會開啟指定的網址\n\n當使用者傳送 button 文字時，我們會回覆事先準備好的 `Button Template` 訊息。\n\n**line-webhook\u002Fline-webhook.service**\n\n```ts\nprivate async handleMessageEvent(event: MessageEvent): Promise\u003Cvoid> {\n     const messageEventHandlerMap = {\n      text: (message) {\n        const { text } = message;\n        \u002F\u002F text 是使用者傳送的文字內容\n        if (text === 'button') {\n          return this.lineMessageService.createButtonTemplateMessage({\n            altText: '按鈕小精靈通知',\n            thumbnailImageUrl: 'https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1753953684\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002Fdog_icon_grxcsl.jpg',\n            title: '標題',\n            text: '按鈕小精靈出來吧',\n            actions: [\n              {\n                type: 'message',\n                label: '我是按鈕 1',\n                text: '我是按鈕 1 號',\n              },\n              {\n                type: 'message',\n                label: '我是按鈕 2',\n                text: '我是按鈕 2 號',\n              },\n              {\n                type: 'message',\n                label: '我是按鈕 3',\n                text: '我是按鈕 3 號',\n              },\n              {\n                type: 'message',\n                label: '我是按鈕～',\n                text: '我是按鈕 4 號',\n              },\n            ],\n          });\n        }\n      },\n    } satisfies Partial\u003CMessageEventHandlerMap>;\n}\n```\n\n### Confirm Template\n\n> 專為決策判斷場景設計的模板訊息，必須且只能擁有兩個按鈕\n\n`Confirm Template` 是最簡潔的模板格式，適用於需要使用者做出「是\u002F否」、「確認\u002F取消」等二選一決策的情境。與 `Button Template` 不同，`Confirm Template` 沒有`標題`和`縮圖`功能\n\n![LINE Bot Confirm Template 訊息回覆](https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1758957578\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002FDay%2014%EF%BC%9ALINE%20Bot%20Template%20Message%20%E5%9B%9B%E7%A8%AE%E6%A8%A1%E6%9D%BF%E8%A8%8A%E6%81%AF%E5%9B%9E%E8%A6%86\u002FLINE_Bot_Confirm_Template_%E8%A8%8A%E6%81%AF%E5%9B%9E%E8%A6%86_fdx6n6.png)\n\n#### 型別定義\n\n> 透過 Tuple 型別明確定義需要兩個 `Action`，編譯時期避免參數數量錯誤的情況發生\n\n**line-message\u002Ftypes\u002Ftemplate-confirm-message**\n\n```ts\nimport { QuickReplyItem, Sender } from '@line\u002Fbot-sdk';\n\nexport type TemplateConfirmMessageReq = {\n  altText: string;\n  text: string;\n  actions: [Action, Action];\n  sender?: Sender;\n  quickReplyItems?: Omit\u003CQuickReplyItem, 'type'>[];\n};\n```\n\n#### 處理函式\n\n**line-message\u002Fline-message.service.ts**\n\n```ts\n  createConfirmTemplateMessage(\n    templateConfirmMessageReq: TemplateConfirmMessageReq,\n  ): TemplateMessage {\n    const { altText, text, actions } =\n      templateConfirmMessageReq;\n\n    const templateConfirmMessage: TemplateMessage = {\n      type: MessageType.Template,\n      altText,\n      template: {\n        type: MessageType.TemplateConfirm,\n        text,\n        actions,\n      },\n    };\n\n    return templateConfirmMessage;\n  }\n```\n\n### Carousel Template\n\n> 常被使用的模板訊息 ⭐⭐⭐\n\n支援最多 10 張卡片，每張卡片最多 3 個按鈕，且所有卡片的按鈕數量必須相同。\n\n![LINE Bot Carousel Template](https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1758958083\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002FDay%2014%EF%BC%9ALINE%20Bot%20Template%20Message%20%E5%9B%9B%E7%A8%AE%E6%A8%A1%E6%9D%BF%E8%A8%8A%E6%81%AF%E5%9B%9E%E8%A6%86\u002FLINE_Bot_Carousel_Template_rkr8ga.png)\n\n#### 型別定義\n\n> 建議可以限制一下 action 數量，避免 action 數量不一致的行為\n\n這裡透過泛型約束的方式，讓原先的函數能夠在編譯時期驗證每張卡片的按鈕數量是否一致，確保所有卡片的 `action` 數量都符合 `Carousel Template` 的規範要求。\n\n**line-message\u002Ftypes\u002Ftemplate-carousel-message.ts**\n\n```ts\nimport { QuickReplyItem, Sender, TemplateColumn } from '@line\u002Fbot-sdk';\n\ntype FixedArray\u003CT, N extends number> = T[] & { length: N };\n\ntype LimitedActionColumn\u003CN extends number> = Omit\u003C\n  TemplateColumn,\n  'defaultAction' | 'imageBackgroundColor' | 'actions'\n> & {\n  actions: FixedArray\u003CTemplateColumn['actions'][number], N>;\n};\n\nexport type TemplateCarouselMessageReq\u003CN extends number = number> = {\n  altText: string;\n  cards: LimitedActionColumn\u003CN>[];\n  sender?: Sender;\n  quickReplyItems?: Omit\u003CQuickReplyItem, 'type'>[];\n};\n```\n\n#### 處理函式\n\n`Carousel Template` 與 `Button Template` 的主要差異在於 `cards` 參數，每張卡片支援以下配置：\n\n**核心參數：**\n\n- text：卡片內文\n- actions：卡片按鈕陣列(最多 3 個)\n\n**可選參數：**\n\n- title：卡片標題\n- thumbnailImageUrl：卡片縮圖\n\n卡片的參數配置與 `Button Template` 基本相同，但透過陣列形式支援多張卡片的輪播展示。\n\n**line-message.service\u002Fline-message.service.ts**\n\n```ts\n  createTemplateCarouselMessage\u003CN extends number>(\n    templateCarouselMessageReq: TemplateCarouselMessageReq\u003CN>,\n  ): TemplateMessage {\n    const { altText, cards, sender, quickReplyItems } =\n      templateCarouselMessageReq;\n\n    const templateCarouselMessage: TemplateMessage = {\n      type: MessageType.Template,\n      altText,\n      template: {\n        type: MessageType.TemplateCarousel,\n        columns: [...cards],\n      },\n    };\n\n    return templateCarouselMessage;\n  }\n```\n\n* * *\n\n透過泛型參數指定每張卡片的按鈕數量，實現編譯時期的靜態檢查：\n\n**line-webhook.service\u002Fline-webhook.service.ts**\n\n```ts\n\u002F\u002F 指定每張卡片只能有 1 個按鈕\nthis.lineMessageService.createTemplateCarouselMessage\u003C1>({\n    altText: '最新活動消息！！',\n    cards: [\n      {\n        text: '新生代狗狗寵物展',\n        thumbnailImageUrl:\n          'https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1753953684\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002Fdog_icon_grxcsl.jpg',\n        actions: [\n          {\n            type: 'message',\n            label: '搶先第一手資訊',\n            text: '可愛狗狗展',\n          },\n        ],\n      },\n      {\n        text: '可愛貓貓展',\n        thumbnailImageUrl:\n          'https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1753953684\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002Fdog_icon_grxcsl.jpg',\n        actions: [\n          {\n            type: 'message',\n            label: '搶先第一手資訊',\n            text: '可愛貓貓展',\n          },\n        ],\n      },\n    ],\n```\n\n### ImageCarousel Template\n\n> 實務開發中的熱門選擇 ⭐⭐⭐\n\n以圖片為主軸的輪播卡片模板，版型固定，只能調整圖片及按鈕。\n\n每張卡片均必須填寫以下配置：\n\n- imageUrl：卡片背景圖片\n- action：互動按鈕(限定一個)\n\n![LINE ImageCarousel Message](https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1758959239\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002FDay%2014%EF%BC%9ALINE%20Bot%20Template%20Message%20%E5%9B%9B%E7%A8%AE%E6%A8%A1%E6%9D%BF%E8%A8%8A%E6%81%AF%E5%9B%9E%E8%A6%86\u002FLINE_ImageCarousel_Message_qzo82r.png)\n\n#### 型別定義\n\n定義上會跟 Carousel Template 蠻類似的，但是這邊因為只能設定一個按鈕，所以會相對單純。\n\n```ts\nimport { QuickReplyItem, Sender, TemplateImageColumn } from '@line\u002Fbot-sdk';\n\nexport type TemplateImageCarouselMessageReq = {\n  altText: string;\n  cards: TemplateImageColumn[]; \u002F\u002F 這邊的型別跟 Carousel Template 不同喔！！！\n  sender?: Sender;\n  quickReplyItems?: Omit\u003CQuickReplyItem, 'type'>[];\n};\n```\n\n#### 處理函式\n\n使用上與 `Carousel Template` 相似，但 `ImageCarousel Template` 的每張卡片都必須設置圖片和按鈕。\n\n```ts\n  createTemplateImageCarouselMessage(\n    templateImageCarouselMessageReq: TemplateImageCarouselMessageReq,\n  ): TemplateMessage {\n    const { altText, cards, sender, quickReplyItems } =\n      templateImageCarouselMessageReq;\n\n    const templateImageCarouselMessage: TemplateMessage = {\n      type: MessageType.Template,\n      altText,\n      template: {\n        type: MessageType.TemplateImageCarousel,\n        columns: [...cards],\n      },\n      ...this.buildCommonMessageProps(sender, quickReplyItems),\n    };\n    return templateImageCarouselMessage;\n  }\n```\n\n### 本日結語\n\n今天我們完成了第一種進階回覆訊息 Template Message 的實作。這類模板的使用方式相當直觀，只需準備好必要參數，就能快速產生對應的模板訊息。\n\n然而，正如開頭提到的，Template Message 的客製化程度有限。例如想為商品模板加上「特價標籤」或其他個性化元素，Template Message 無法直接實現。這種標準化的限制，讓模板訊息比較難凸顯獨特的設計特色。\n",{"title":523,"description":524},{"name":366,"url":367,"day":203},{"loc":522,"images":3484,"lastmod":525},[3485,3486,3487,3488,3489],{"loc":1222},{"loc":1490},{"loc":2234},{"loc":2501},{"loc":3200},"ithome-2025-day-14","2025-09-27-ithome-2025-day-14",[11,360,362,350],"oLktZ2wCCoxDWETdc9ska_vgCrNt_3bRypejypCPvbo",1792575189284]