一名專業(yè)的設(shè)計師，交互文檔是日常工作最重要的輸出件，尤其交互說明，它承載著我們的設(shè)計思路、交互邏輯、頁面規(guī)則說明等，是設(shè)計師與開發(fā)溝通與協(xié)作的重要橋梁。

然而部分同學(xué)沒有專門練習(xí)過說明文檔撰寫，在寫說明時，總或多或少有遺漏的點(diǎn)，導(dǎo)致產(chǎn)品開發(fā)過程中被發(fā)現(xiàn)重新補(bǔ)齊，增加了溝通與時間成本。

因此，今天想從字段說明、頁面排版、元素交互規(guī)則、頁面/彈窗交互四方面與大家分享如何把交互說明撰寫清晰，避免出現(xiàn)返工情況。

一、字段說明

字段是組成界面的重要元素，一款產(chǎn)品中肯定會有數(shù)據(jù)信息錄入功能，如創(chuàng)建活動界面，我們需要填寫活動標(biāo)題、活動內(nèi)容或者圖片。

那么在頁面設(shè)計時，必須要對字段進(jìn)行解釋。

字段說明主要包括 5 個信息：

1. 字段名稱
2. 數(shù)據(jù)類型
3. 字符長度（最小最大值）
4. 是否必填
5. 備注。

例如新增活動頁中字段說明如下：

1. 活動主題：必填，字符串類型，最多 30 個字符，超過 30 字符禁止輸入；
2. 活動海報：必填，點(diǎn)擊活動海報同樣調(diào)起手機(jī)圖片功能，讓用戶選擇活動海報圖片；
3. 報名人數(shù)：必填，數(shù)字類型，最多 7 位字符；
4. 活動開始時間：必填，點(diǎn)擊調(diào)用時間選擇組件，精確到分鐘，如 2023-12-30 17:16
5. 活動結(jié)束時間：必填，點(diǎn)擊調(diào)用時間選擇組件，同樣精確到分鐘，但活動結(jié)束時間不能小于開始時間”

PS：字段說明的形式有兩種：直接撰寫文字說明或者列表格進(jìn)行說明都可。

二、頁面排版布局說明

在做內(nèi)容頁面或者頁面詳情展示時，需要對可變參數(shù)的極限值以及展示方式進(jìn)行說明。

什么是可變參數(shù)？就是字段是通過參數(shù)（如用戶配置）而并非系統(tǒng)固定的，譬如淘寶中商品信息列表的商品名稱，不同商品字符長度并不固定，倘若名稱太長，則需要考慮換行顯示或省略符。

所以當(dāng)設(shè)計可變字符組成的界面時，我們需要說明：

1. 一行最多顯示多少字符？
2. 超過后是否換行？
3. 最多顯示多少行？
4. 是否需要用...（省略符）省略。

看個活動列表與活動詳情案例，當(dāng)活動名稱與內(nèi)容過長時候，規(guī)則如下：

三、元素交互規(guī)則

元素交互有三種：按鈕、信息輸入框、以及圖片。

① 按鈕的交互包括默認(rèn)狀態(tài)、可點(diǎn)擊狀態(tài)、點(diǎn)擊后交互，這些按鈕交互我們在設(shè)計時需要考慮仔細(xì)，例如在登錄/注冊時：

1.  未輸入手機(jī)號與手機(jī)驗(yàn)證碼，按鈕默認(rèn)置灰（不可點(diǎn)擊）；
2. 用戶輸入手機(jī)號與驗(yàn)證碼后，注冊/登錄按鈕狀態(tài)從置灰轉(zhuǎn)化成可點(diǎn)擊狀態(tài)；
3.  按鈕點(diǎn)擊后跳轉(zhuǎn)到產(chǎn)品首頁（點(diǎn)擊后交互）”

② 信息輸入框交互包括默認(rèn)狀態(tài)、選中狀態(tài)、信息輸入狀態(tài)與輸入后狀態(tài)。例如在注冊/登錄頁面中，手機(jī)號輸入框交互：

1. 輸入框默認(rèn)顯示「請輸入手機(jī)號」；
2. 點(diǎn)擊輸入：輸入框獲取焦點(diǎn)，喚起「數(shù)字鍵盤」；
3. 輸入過程：輸入框非空且在輸入狀態(tài)時，末尾顯示一鍵刪除按鈕；
4. 輸入完成且失去焦點(diǎn)時，顯示完整號碼；
5. 用正則表達(dá)式判斷用戶是否符合手機(jī)號規(guī)則，否則提醒「請輸入正確的手機(jī)號」；（必要時我會對內(nèi)容進(jìn)行實(shí)時校驗(yàn)）”

③ 圖片交互更多在 banner 與信息列表/詳情頁面中出現(xiàn)，例如淘寶首頁 banner、商品詳情。

Banner 的交互包括輪播時間，手勢切換，圖片點(diǎn)擊后交互，如 JD 首頁 banner 輪播間隔是 5 秒，可以通過左滑或右滑切換，點(diǎn)擊后跳轉(zhuǎn)到商品詳情；

信息列表/詳情則需要說明圖片點(diǎn)擊后放大還是鏈接跳轉(zhuǎn)、長按交互以及圖片放大后能夠繼續(xù)左右切換；

④ 頁面/彈窗交互

頁面或彈窗跳轉(zhuǎn)以一般都是用戶交互進(jìn)行作為前置條件觸發(fā)。

例如最常見的按鈕單擊跳轉(zhuǎn)頁面、從左向右滑動返回上一頁或者上往下滑喚醒小程序等，這些在界面設(shè)計時都需要手勢+交互形式進(jìn)行說明。

此外還有稍微復(fù)雜的彈窗或界面跳轉(zhuǎn)交互，如：初次登錄時彈窗廣告、倒計時 x 秒彈窗關(guān)閉，搖一搖跳轉(zhuǎn)廣告頁面，我們都需要把每一個交互邏輯交代清晰。

例如在設(shè)計用戶首日登錄彈窗時，彈窗說明文檔：

1. 用戶當(dāng)日首次登錄時，彈出簽到彈窗，點(diǎn)擊領(lǐng)福利則獲取獎勵，隨后關(guān)閉彈窗，或者點(diǎn)擊 X 按鈕直接關(guān)閉彈窗，關(guān)閉后當(dāng)天不再顯示。
2. 如果用戶不操作，彈窗倒計時 15S 后自動關(guān)閉?！?/li>

其他細(xì)節(jié)交互說明

其實(shí)，除了上文提及的核心交互外，在界面設(shè)計時還可能會遇到更多的交互方式。

如果想把產(chǎn)品做到極致，那么在寫交互文檔時需要我們細(xì)心把每一個交互點(diǎn)寫清晰明了，最后產(chǎn)品落地后才能避免返工。

作者：北沐而川