Papo do SlotMINI APP ← 回桌機版論壇
miniapp/ · 設計目錄

依規格圖重建的 Telegram Mini App

版面取自 7 張規格圖:不用卡片,分區靠整寬分隔線切段。配色回到 Papo do Slot 站內的四色語意——綠主行動、金獎勵、紅警示、藍 Telegram 與外站。

分頁為首頁/遊戲/比賽/社群/我的,紅黑榜收進社群的論壇分類。樣式分四層(tokens / base / components / sim),外殼行為在 assets/shell.js,狀態在 assets/session.js。

平台 Telegram Mini App 主題 深/淺自動切換 導覽 底部五分頁 視窗 390 × 844

畫面

12 支 · 未綁定時 兩態版面 導去綁定 不適用

00 · 進場 首次進入綁定onboarding.html 這一頁就是綁定流程

Telegram 已驗證身分、四項授權開關、既有帳號與新帳號兩種去向,18 歲條款閘住主行動。

  • MainButton 停用 → 啟用
  • 無分頁列
檢視 →
01 · 分頁 首頁home.html 換一整套:好處、綁定入口、逛社群

問候、三欄今日概況與參賽鍵、任務積分一格讀數(底下一顆通往商城的鍵,與「我的」同一個形狀)、每日簽到、今日主要任務、三則待處理、每週決賽狀態。

  • stats c3
  • 簽到展開七天面板,漏簽可補
檢視 →
02 · 堆疊 今日問答quiz.html 導去綁定流程 · 首頁沒有連到這裡

一般問答與真實經驗兩題,選一題展開作答框,另一題自動變灰;送出後徽章轉為已完成。

  • 兩題互斥
  • 字數閘門 15 字
檢視 →
03 · 分頁 遊戲games.html 只換空狀態的說明與 CTA

第一階段不做遊戲清單或儲值入口,維持明確的空狀態並導回首頁。

  • 空狀態
  • 單一綠色 CTA
檢視 →
04 · 分頁 賽事大廳contests.html 賽制與獎勵照常看得到,收掉參賽鍵

三欄概況、今日資格賽、本週大型決賽。兩張卡的卡尾都是一列兩欄:左邊原地開規則面板,右邊去看自己的紀錄。

  • 確認對話框之後才扣參賽券
  • 未開放與參賽券已用完兩態禁用
檢視 →
05 · 分頁 玩家社群community.html 唯讀:搜尋與版位照常,收掉發起討論

搜尋、發起討論、八個論壇版位兩欄清單、今日熱門討論。黑網舉報與玩家推薦在這裡。

  • 即時搜尋過濾
  • 版位四色語意
檢視 →
06 · 堆疊 討論詳情topic.html 唯讀:主題與回覆照常,收掉留言框

主題內容、玩家回覆串、直接留言。送出後即時插入自己的回覆並累加計數。

  • 回覆即時插入
  • 返回社群
檢視 →
07 · 分頁 我的profile.html 導去綁定流程

身分與代號、任務積分一格讀數(底下一顆通往商城的鍵)、邀請好友進度與邀請碼,以及參賽紀錄與帳號兩個去處。

  • 分享邀請連結
  • 一鍵複製邀請碼
檢視 →
08 · 堆疊 積分商城shop.html 導去綁定流程

商品/我的商品/積分紀錄三個子頁。兌換走確認對話框,確認後扣積分、發票券;票券那一份紀錄自成一頁,入口在「我的商品」。

  • 兌換確認對話框
  • 積分不足的禁用態
檢視 →
09 · 堆疊 票券紀錄tickets.html 導去綁定流程

參賽券的取得、使用與失效。入口在商城的「我的商品」—— 手上有幾張、那幾張怎麼來怎麼去,是同一件事的兩面。

  • 進入比賽與兌換各多一列
  • 與商城的積分紀錄共用同一份建列
檢視 →
10 · 堆疊 參賽紀錄與排名matches.html 導去綁定流程

兩個子頁:資格賽看本週的週排名、週總分與今日排名,底下是本週每一場的成績(計入週總分的那三場打勾)與前三週的名次;決賽看該週的決賽成績與過去的決賽紀錄。本週差幾名晉級由名次算出。

  • 兩張賽事卡各自落在對應的子頁
  • 與積分紀錄的扣券對得上
檢視 →
11 · 堆疊 本週大型決賽final.html 規則與排行榜照常,收掉自己的名次

決賽詳情(時間、資格、賽制、獎勵)與前 20 名完整排行榜。晉級線依門檻畫,已綁定時標出自己那一列。

  • 賽事大廳決賽卡兩顆鍵直達
  • 晉級線跟著 QUALIFY
檢視 →

排版語言

取自規格圖。樣式在 assets/components.css,狀態回饋由 assets/shell.js 提供

分區不用卡片。每個 .sec / .item 之間一條整寬 1px 分隔線,背景維持單一底色。分區裡的第一塊加 .flush-top 抵銷 .rows / .stats 的上外距。
分區標頭.sec-h:左側粗體標題,右側徽章或小字 meta 對齊同一行。
數據列.stats.c3 / .c4:等分欄位、細直線分隔,上方等寬數字、下方小標。欄位可以是唯讀的 div,也可以換成帶去向的 a(首頁四欄都有)—— 後者靠按壓底色與焦點環表達可點,不畫 chevron,那是清單列的約定。已達成的數值加 .v.done 換成 --on-tint 綠。
按鈕.btn-primary 綠色漸層主行動、.btn-ghost 描邊次行動,加上破壞性動作專用的 .btn-danger(描邊紅,目前只用在「我的」的解除連結)。禁用寫 .btn-off 或標記上的 disabled,兩者同外觀。基底(邊框、min-height、轉場屬性、狀態規則)與桌機版 .btn 同一套,差別只有高度 44、圓角 8 與按壓縮放三處平台差異。成對時左主右次,不出現第二顆實心按鈕。
成對按鈕.btn-row.spread:左主右次,內容寬度,不強制等分。
徽章.badge 預設綠=正向/可參加/已完成;.b-warn 金=獎勵積分、.b-bad 紅=警示熱門、.b-info 藍=Telegram 與外站、.b-mute 灰=未達成。
進度條.prog 6px 綠色,獎勵型進度(簽到、邀請、晉級)加 .gold。寬度寫在 data-w,外殼進場後才補上以產生動畫,同時補上 role="progressbar" 與 aria-valuenow,名稱取自相鄰的說明文字。
清單列.row:細線圖示 + 標題(可帶副標)+ 右側動作字、徽章或 chevron。
兩欄清單.grid2:論壇版位用,圖示可帶語意色(.c-good / .c-bad / .c-warn)。
身分列.me:頭像 + 名稱 + 副標(+右側次行動)。.me.tg 是 Telegram 身分變體,頭像走藍、標題降一級。
討論列.thread 標題+meta 兩行;.reply 名稱+內容+右側時間。長串用 .more-wrap 的描邊「載入更多」分頁,底下標示已顯示幾則。
空狀態.empty:置中圖示 + 標題 + 說明 + 單一綠色 CTA。
表單.search / .ta-wrap / .opt / .switch / .check。輸入字級一律 --fs-md(16px)—— 低於 16 時 iOS 的 WKWebView 會在聚焦時自動放大整頁且不縮回,那是平台硬行為,不是排印偏好。焦點環走共用的 --focus-ring,不各自刻一份。每個欄位都要有真的 label(可用 .sr-only),placeholder 聚焦後就消失,不算標籤;.search 的清除鍵是 .sf-x,有字才出現。
回饋送出中=ODShell.pending():轉圈、禁用、aria-busy,解除時還原原本的標記。表單層錯誤=.err 紅底加一次性抖動。全域結果=ODShell.toast(text, kind),kind 省略=成功綠勾、warn=金三角、bad=紅圈叉並把 aria-live 提到 assertive。成功與失敗不共用同一個外觀。
觸控目標所有可點元素不小於 --hit(44px)。視覺重量要小的(.btn-sm、通知鈴、開關、分區標頭的 .meta-btn)維持原尺寸,命中區用偽元素或負外距外擴,不動版面。
頂欄品牌 + 目前分頁綠膠囊 + 通知鈴,由外殼依 data-section 注入。通知鈴是連到首頁「待處理」(#inbox)的連結,只在已綁定時出現;紅點在待處理看過之後熄掉。與底部分頁列的 active 同色,是同一個「你在這裡」訊號。
accent 預算一屏一顆綠色實心主行動;導覽狀態(頂欄膠囊 + 分頁 active)算導覽 chrome 不佔預算。獎勵一律金、警示一律紅、Telegram 與外站一律藍。

目錄約定

新增畫面照這份契約走,外殼行為就會一致

token 來源品牌 token 由 ../colors_and_type.css 與 ../tokens.css 提供(../brand-spec.md 明訂的實作真值),assets/tokens.css 只放兩種東西:Mini App 增量(--gut / --sec-y / --hit / 外殼三高度)與刻意的平台覆寫(圓角 12/8、控制項高度 44/34)。字級、間距、動態與焦點環一律引用共用階制,不新增品牌 token、不寫死品牌色。
主題策略預設 auto:真機讀 Telegram colorScheme,瀏覽器讀 prefers-color-scheme。模擬外框上的切換僅供評估。
頁面契約data-tab 決定分頁 active、data-section 為頂欄膠囊、data-tg-back="1" 顯示返回鍵、data-tg-back-to 宣告上層頁面、data-topbar="0" 隱藏頂欄。
返回堆疊層畫面一定要同時宣告 data-tg-back="1" 與 data-tg-back-to。從站內點進來時走 history.back() 保留捲動位置;直接開網址或冷啟動時導向宣告的上層頁面,返回鍵不會按了沒反應。
分頁列已經在該頁時再點同一個分頁=捲回頂部,不重新載入。堆疊層畫面點自己的分頁則真的導回分頁根層。
深連結支援 頁面.html#區塊 id(例如 profile.html#invite)。捲動的是 .app 而非文件,外殼會自行計算並扣掉黏性頂欄高度。
內容容器內容放在 <div id="app">;外殼負責捲動、底部留白與模擬外框。沒有 #app 的頁面(本頁)不套外框。
高度不用 100vh。真機由 viewportStableHeight 寫入 --tg-vh,安全區走 --tg-safe-b。
未完成去向任何元素加 data-soon="名稱",外殼自動接上「畫面尚未設計」提示,不留死連結。
這些頁面是設計稿,資料為靜態範例。真機上線時身分驗證必須由後端以 Bot Token 驗證 Telegram 傳來的簽章,前端不得自行信任任何身分欄位。