Android 圖片資原始檔命名規範(非官方,僅供參考)
對於Android的資原始檔的命名,Google官方並沒有提供統一的規範,民間的命名方式可謂是百花齊放、相容幷包,比較知名的有阿里巴巴開發規範,以及Blankj的AndroidStandardDevelop,以下內容是筆者參考了其他的一些命名規範,加上自己總結的一些命名方式所得。由於專案比較小,專案所涉及的資原始檔型別並不多,所以總結得並不全面,僅供參考。
圖片命名規則:圖片型別_邏輯名稱_功能名稱{_顏色}{_大小}{_狀態}
{}
中的內容為可選;
1.常用圖片型別表格:
圖片型別縮寫表 | ||
中文名 | 名稱 | 縮寫 |
背景 | background | bg |
圖示 | icon | ic |
圖片 | image | img |
文字 | text | txt(主要用於藝術字) |
2.常用邏輯名稱表格:
邏輯名稱縮寫表 | ||
中文名 | 名稱 | 縮寫 |
按鈕 | Button | btn |
選單 | Menu | menu |
標籤頁 | Tab | tab |
卡片 | Card | card |
橫幅 | Banner | banner |
箭頭 | Arrow | arrow |
列表 | List | list |
列表子項 | Item | item |
佈局 | Layout | layout(整個頁面佈局或子佈局) |
文字 | TextView | tv |
可編輯文字 | EditText | et |
多選框 | CheckBox | cb |
單選框 | RadioButtion | rb |
進度條 | ProgressBar | pb |
拖動條 | SeekBar | sb |
下拉選擇框 | Spinner | spn |
3.功能名稱不使用縮寫,如果由多個單片語成,不同的單詞之間用下劃線'_'隔開,否則Android Studio會警告單詞拼寫錯誤。
舉個例子:
(1)選單欄返回圖示:ic_menu_back,back就是功能名稱,代表此圖示的功能是返回
(2)充值頁橫幅背景圖:bg_banner_recharge,recharge就是功能名稱,代表此橫幅用於充值頁面
(3)選擇國家下拉框背景圖:bg_spn_choose_country:choose_country就是功能名稱,代表此下拉框用於選擇國家,兩個單詞用下劃線'_'隔開
4.如果同一張圖片有多個顏色,則在命名中連綴顏色屬性(例如:_black、_white、_yellow),否則不新增顏色屬性。
5.如果同一張圖片分為小圖和大圖,則在命名中連綴大小屬性(例如:_big、_small),否則不新增大小屬性。
6.如果同一張圖片有多個狀態,則在命名中連綴狀態屬性,否則不新增狀態屬性。
常用狀態表格:
名稱 | 說明 |
normal | 普通狀態(如果有多種狀態,normal必寫) |
pressed | 按下狀態 |
selected | 選中狀態 |
checked | 勾選狀態 |
disabled | 不可用狀態 |
focused | 聚焦狀態 |
狀態屬性放在命名最後,如果有一張圖片有多種狀態,則普通狀態效果後必須連綴_normal,因為不同狀態的圖片會放在同一個選擇器中,選擇器將以這張圖片無狀態屬性的名字命名。
舉個例子:
確認按鈕背景圖按下狀態:bg_btn_ok_pressed
確認按鈕背景圖普通狀態:bg_btn_ok_normal
這兩張背景圖會放在一個選擇器中,選擇器名字為bg_btn_ok,這個選擇器將被設定為按鈕的背景圖。如果普通狀態效果後沒有連綴_normal,則會和此選擇器命名衝突。
7.再多舉幾個例子?我不......我舉!
個人中心標籤圖示普通狀態:ic_tab_me_normal
個人中心標籤圖示選擇狀態:ic_tab_me_selected
確認按鈕背景普通狀態:bg_btn_ok_normal
確認按鈕背景按下狀態:bg_btn_ok_pressed
列表空圖:img_list_empty
列表載入中圖:img_list_loading
列表載入失敗圖:img_list_error
月卡背景圖:bg_card_monthly
選單欄充值歷史記錄圖示:ic_menu_recharge_history
輸入邀請碼文字框背景圖:bg_et_enter_invitation_code
登入頁背景圖:bg_layout_login
訊息列表子項未讀圖示:ic_item_message_unread
訊息列表子項已讀圖示:ic_item_message_have_read
充值列表單選框圖示普通狀態:ic_rb_recharge_normal
充值列表單選框圖示選中狀態:ic_rb_recharge_selected
......
以上,就是Android圖片資源命名規範。