本文將從字段說明、頁面排版、元素交互規則等多個角度，分享如何撰寫清晰、詳盡的交互文檔，幫助設計師們提升工作效率，減少不必要的返工。

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

然鵝，部分童鞋沒有專門練習過說明文檔撰寫，在寫說明時，總或多或少有遺漏的點，導致產品開發過程中被發現重新補齊，增加了溝通與時間成本。

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

一、字段說明

字段是組成界面的重要元素，一款產品中肯定會有數據信息錄入功能，如創建活動界面，我們需要填寫活動標題、活動內容或者圖片。

那么在頁面設計時，必須要對字段進行解釋。

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

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

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

“1、活動主題：必填，字符串類型，最多30個字符，超過30字符禁止輸入；

2、活動海報：必填，點擊活動海報同樣調起手機圖片功能，讓用戶選擇活動海報圖片；

3、報名人數：必填，數字類型，最多7位字符；

4、活動開始時間：必填，點擊調用時間選擇組件，精確到分鐘，如2023-12-30 17:16

5、活動結束時間：必填，點擊調用時間選擇組件，同樣精確到分鐘，但活動結束時間不能小于開始時間”

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

二、頁面排版布局說明

在做內容頁面或者頁面詳情展示時，需要對可變參數的極限值以及展示方式進行說明。

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

所以當設計可變字符組成的界面時，我們需要說明：

“1、一行最多顯示多少字符？

2、超過后是否換行？

3、最多顯示多少行？

4、是否需要用…（省略符）省略?！?/p>

看個活動列表與活動詳情案例，當活動名稱與內容過長時候，規則如下：

三、元素交互規則

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

1. 按鈕的交互包括默認狀態、可點擊狀態、點擊后交互，這些按鈕交互我們在設計時需要考慮仔細，例如在登錄/注冊時：未輸入手機號與手機驗證碼，按鈕默認置灰（不可點擊）；
2. 用戶輸入手機號與驗證碼后，注冊/登錄按鈕狀態從置灰轉化成可點擊狀態；
3. 按鈕點擊后跳轉到產品首頁（點擊后交互）”

2. 信息輸入框交互包括默認狀態、選中狀態、信息輸入狀態與輸入后狀態。

例如在注冊/登錄頁面中，手機號輸入框交互：

“1輸入框默認顯示【請輸入手機號】；

2、 點擊輸入：輸入框獲取焦點，喚起【數字鍵盤】；

3、 輸入過程：輸入框非空且在輸入狀態時，末尾顯示一鍵刪除按鈕；

4、 輸入完成且失去焦點時，顯示完整號碼；

5、 用正則表達式判斷用戶是否符合手機號規則，否則提醒【請輸入正確的手機號】；（必要時我會對內容進行實時校驗）”

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

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

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

四、頁面/彈窗交互

1. 頁面或彈窗跳轉以一般都是用戶交互進行作為前置條件觸發

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

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

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

用戶當日首次登錄時，彈出簽到彈窗，點擊領福利則獲取獎勵，隨后關閉彈窗，或者點擊X按鈕直接關閉彈窗，關閉后當天不再顯示。

2. 如果用戶不操作，彈窗倒計時15S后自動關閉

五、其他細節交互說明

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

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