# WGroupTags

Description:

### Props

Name | Type | Default value | Required? | Description
--- | --- | --- | --- | ---
`value` | Array | `[]` | No | 輸入項目的字串陣列或物件陣列，預設[]
`enableActive` | Boolean | `false` | No | 輸入項目是否使用點擊成為活耀狀態布林值，預設false
`valueActive` | Object | `null` | No | 輸入活耀項目物件，預設null
`keyText` | String | `'text'` | No | 輸入當項目為物件時，存放顯示文字之欄位字串，預設'text'
`keyIcon` | String | `'icon'` | No | 輸入當項目為物件時，存放圖標之欄位字串，預設'icon'
`keyTooltip` | String | `'tooltip'` | No | 輸入當項目為物件時，存放提示之欄位字串，預設'tooltip'
`enableColorsFromItem` | Boolean | `false` | No | 輸入當當項目為物件時是否使用其內相關顏色設定用以覆蓋預設值布林值，預設false
`icon` | String | `''` | No | 輸入左側圖標字串，預設''
`iconColor` | String | `'black'` | No | 輸入圖標顏色字串，預設'black'
`iconColorHover` | String | `'grey darken-3'` | No | 輸入滑鼠移入時圖標顏色字串，預設'grey darken-3'
`iconColorActive` | String | `'white'` | No | 輸入主動模式時圖標顏色字串，預設'white'
`iconSize` | Number | `22` | No | 輸入左側圖標之尺寸數字，單位px，預設22
`progColor` | String | `'rgba(150,150,150,0.4)'` | No | 輸入進度條背景顏色字串，預設'rgba(150,150,150,0.4)'
`progBackgroundColor` | String | `'rgba(150,150,150,0.075)'` | No | 輸入進度條顏色字串，預設'rgba(150,150,150,0.075)'
`textColor` | String | `'black'` | No | 輸入文字顏色字串，預設'black'
`textColorHover` | String | `'grey darken-3'` | No | 輸入滑鼠移入時文字顏色字串，預設'grey darken-3'
`textColorActive` | String | `'white'` | No | 輸入主動模式時文字顏色字串，預設'white'
`textFontSize` | String | `'0.85rem'` | No | 輸入文字字型大小字串，預設'0.85rem'
`borderRadius` | Number | `30` | No | 輸入框圓角度數字，單位為px，預設30
`borderColor` | String | `'transparent'` | No | 輸入邊框顏色字串，預設'transparent'
`borderColorHover` | String | `'transparent'` | No | 輸入滑鼠移入時邊框顏色字串，預設'transparent'
`borderColorActive` | String | `'transparent'` | No | 輸入主動模式時邊框顏色字串，預設'transparent'
`backgroundColor` | String | `'transparent'` | No | 輸入背景顏色字串，預設'transparent'
`backgroundColorHover` | String | `'rgba(200,200,200,0.25)'` | No | 輸入滑鼠移入時背景顏色字串，預設'rgba(200,200,200,0.25)'
`backgroundColorActive` | String | `'orange'` | No | 輸入主動模式時背景顏色字串，預設'orange'
`marginStyle` | Object | `{top:10,bottom:10,left:0,right:10}` | No | 輸入外距設定物件，可用鍵值為v、h、left、right、top、bottom，v代表同時設定top與bottom，h代表設定left與right，若有重複設定時後面鍵值會覆蓋前面，各鍵值為寬度數字，單位為px，預設{top:10,bottom:10,left:0,right:10}
`shadow` | Boolean | `true` | No | 輸入是否顯示陰影布林值，預設true
`shadowStyle` | String | `''` | No | 輸入陰影顏色字串，預設值詳見props
`shadowActive` | Boolean | `true` | No | 輸入主動模式時是否顯示陰影布林值，預設true
`shadowActiveStyle` | String | `''` | No | 輸入主動模式時陰影顏色字串，預設值詳見props
`paddingStyle` | Object | `{v:3,h:15}` | No | 輸入內寬距離物件，可用鍵值為v、h、left、right、top、bottom，v代表同時設定top與bottom，h代表設定left與right，若有重複設定時後面鍵值會覆蓋前面，各鍵值為寬度數字，單位為px，預設{v:3,h:15}
`shiftLeft` | Number | `0` | No | 輸入左側內寬平移距離數字，會對paddingStyle設定再添加，可調整例如圖標與左側邊框距離，單位px，預設0
`shiftRight` | Number | `0` | No | 輸入右側內寬平移距離數字，會對paddingStyle設定再添加，可調整例如關閉圖標與右側邊框距離，單位px，預設0
`suggests` | Array | `[]` | No | 輸入可選(建議)項目陣列，預設[]
`keySuggestText` | String | `'text'` | No | 輸入當可選(建議)項目為物件時，存放顯示文字之欄位字串，預設'text'
`placeholder` | String | `''` | No | 輸入無文字時的替代字符字串，預設''
`noResultsText` | String | `'No results'` | No | 輸入無過濾結果字串，預設'No results'
`addMode` | String | `'auto'` | No | 輸入新增模式字串，可使用'auto'、'input'、'button'，預設'auto'
`inputTextWidth` | Number | `150` | No | 輸入新增按鈕或輸入框區寬度數字，單位px，預設150
`inputKeyText` | String | `'text'` | No | 輸入若可選(建議)項目為元素陣列時，輸入框之提取選擇項目物件內鍵值字串，預設'text'
`inputTextFontSize` | String | `'0.85rem'` | No | 輸入輸入框文字大小字串，預設'0.85rem'
`inputTextColor` | String | `'black'` | No | 輸入輸入框文字顏色字串，預設'black'
`inputTextBackgroundColor` | String | `'white'` | No | 輸入輸入框背景顏色字串，預設'white'
`inputTextBackgroundColorHover` | String | `'white'` | No | 輸入滑鼠移入時輸入框背景顏色字串，預設'white'
`inputTextBackgroundColorFocus` | String | `'grey lighten-5'` | No | 輸入取得焦點時輸入框背景顏色字串，預設'grey lighten-5'
`inputTextBorderColor` | String | `'grey lighten-1'` | No | 輸入輸入框邊框顏色字串，預設'grey lighten-1'
`inputTextBorderColorHover` | String | `'grey'` | No | 輸入滑鼠移入時輸入框邊框字串，預設'grey'
`inputTextBorderColorFocus` | String | `'grey'` | No | 輸入取得焦點時輸入框文字邊框字串，預設'grey'
`inputTextButtonIcon` | String | `mdiPlusCircle` | No | 輸入新增按鈕圖標字串，可為mdi,md,fa代號或mdi/js路徑，預設mdiPlusCircle
`inputTextButtonColor` | String | `'grey lighten-1'` | No | 輸入輸入框按鈕顏色字串，預設'grey lighten-1'
`inputTextButtonColorHover` | String | `'grey'` | No | 輸入滑鼠移入時輸入框按鈕顏色字串，預設'grey'
`inputTextButtonColorFocus` | String | `'grey'` | No | 輸入取得焦點時輸入框按鈕顏色字串，預設'grey'
`inputTextButtonTooltip` | String | `'Add'` | No | 輸入輸入框右側按鈕提示文字字串，預設'Add'
`inputExpansionIconColor` | String | `'grey'` | No | 輸入輸入框右側圖標顏色字串，預設'grey'
`suggectItemTextColor` | String | `'grey darken-3'` | No | 輸入輸入框下拉選單項目文字顏色字串，預設'grey darken-3'
`suggectItemTextColorHover` | String | `'light-blue darken-2'` | No | 輸入輸入框下拉選單項目文字Hover顏色字串，預設'light-blue darken-2'
`suggectItemFontSize` | String | `'0.9rem'` | No | 輸入輸入框下拉選單項目顯示文字大小字串，預設'0.9rem'
`suggectItemBackgroundColor` | String | `'white'` | No | 輸入輸入框下拉選單項目背景顏色字串，預設'white'
`suggectItemBackgroundColorHover` | String | `'light-blue lighten-5'` | No | 輸入輸入框下拉選單項目背景Hover顏色字串，預設'light-blue lighten-5'
`addButtonText` | String | `'Add'` | No | 輸入新增按鈕文字字串，預設'Add'
`addButtonTextColor` | String | `'black'` | No | 輸入新增按鈕文字顏色字串，預設'black'
`addButtonTextColorHover` | String | `'black'` | No | 輸入滑鼠移入時新增按鈕文字顏色字串，預設'black'
`addButtonIcon` | String | `mdiPlusCircle` | No | 輸入新增按鈕圖標字串，可為mdi,md,fa代號或mdi/js路徑，預設mdiPlusCircle
`addButtonIconColor` | String | `'pink darken-1'` | No | 輸入新增按鈕圖標顏色字串，預設'pink darken-1'
`addButtonIconColorHover` | String | `'pink darken-1'` | No | 輸入滑鼠移入時新增按鈕圖標顏色字串，預設'pink darken-1'
`addButtonBackgroundColor` | String | `'white'` | No | 輸入新增按鈕背景顏色字串，預設'white'
`addButtonBackgroundColorHover` | String | `'white'` | No | 輸入滑鼠移入時新增按鈕背景顏色字串，預設'white'
`addButtonTooltip` | String | `'Add'` | No | 輸入新增按鈕提示文字字串，預設'Add'
`addWhenInputByOutside` | Boolean | `false` | No | 輸入當指定或自動使用input並新增時，是否強制使用click-add事件進行新增處理布林值，預設false
`closeWithInterceptor` | Boolean | `false` | No | 輸入是否通過攔截器來決定是否進行關閉布林值，此處之攔截器係用promise來控制，當使用者點擊關閉時可先行確認或提示。當closeWithInterceptor=true時，於click-close事件所接收物件資訊中的pm，使用pm.resolve()則代表確定關閉，反之pm.reject()則取消關閉事件，預設false
`draggable` | Boolean | `true` | No | 輸入是否可拖曳模式布林值，預設true
`editable` | Boolean | `true` | No | 輸入是否為編輯模式布林值，預設true
`editableClose` | Boolean | `true` | No | 輸入editable=true時是否顯示關閉按鈕布林值，預設true
`editableInput` | Boolean | `true` | No | 輸入editable=true時是否使用預設的slot input布林值，預設true
`enableCloseEventOnly` | Boolean | `false` | No | 輸入點擊移除按鈕時是否僅開啟關閉事件，代表不自動刪除項目，需通過監聽關閉事件@click-close自行處理刪除功能，預設false
`enableNodata` | Boolean | `false` | No | 輸入是否使用nodata展示布林值，預設false
`nodata` | String | `'Empty'` | No | 輸入無任何字串陣列時的預設文字字串，預設'Empty'

### Props

Name | Type | Default value | Required? | Description
--- | --- | --- | --- | ---
`value` | Array | `[]` | No | 輸入項目的字串陣列或物件陣列，預設[]
`enableActive` | Boolean | `false` | No | 輸入項目是否使用點擊成為活耀狀態布林值，預設false
`valueActive` | Object | `null` | No | 輸入活耀項目物件，預設null
`keyText` | String | `'text'` | No | 輸入當項目為物件時，存放顯示文字之欄位字串，預設'text'
`keyIcon` | String | `'icon'` | No | 輸入當項目為物件時，存放圖標之欄位字串，預設'icon'
`keyTooltip` | String | `'tooltip'` | No | 輸入當項目為物件時，存放提示之欄位字串，預設'tooltip'
`enableColorsFromItem` | Boolean | `false` | No | 輸入當當項目為物件時是否使用其內相關顏色設定用以覆蓋預設值布林值，預設false
`icon` | String | `''` | No | 輸入左側圖標字串，預設''
`iconColor` | String | `'black'` | No | 輸入圖標顏色字串，預設'black'
`iconColorHover` | String | `'grey darken-3'` | No | 輸入滑鼠移入時圖標顏色字串，預設'grey darken-3'
`iconColorActive` | String | `'white'` | No | 輸入主動模式時圖標顏色字串，預設'white'
`iconSize` | Number | `22` | No | 輸入左側圖標之尺寸數字，單位px，預設22
`progColor` | String | `'rgba(150,150,150,0.4)'` | No | 輸入進度條背景顏色字串，預設'rgba(150,150,150,0.4)'
`progBackgroundColor` | String | `'rgba(150,150,150,0.075)'` | No | 輸入進度條顏色字串，預設'rgba(150,150,150,0.075)'
`textColor` | String | `'black'` | No | 輸入文字顏色字串，預設'black'
`textColorHover` | String | `'grey darken-3'` | No | 輸入滑鼠移入時文字顏色字串，預設'grey darken-3'
`textColorActive` | String | `'white'` | No | 輸入主動模式時文字顏色字串，預設'white'
`textFontSize` | String | `'0.85rem'` | No | 輸入文字字型大小字串，預設'0.85rem'
`borderRadius` | Number | `30` | No | 輸入框圓角度數字，單位為px，預設30
`borderColor` | String | `'transparent'` | No | 輸入邊框顏色字串，預設'transparent'
`borderColorHover` | String | `'transparent'` | No | 輸入滑鼠移入時邊框顏色字串，預設'transparent'
`borderColorActive` | String | `'transparent'` | No | 輸入主動模式時邊框顏色字串，預設'transparent'
`backgroundColor` | String | `'transparent'` | No | 輸入背景顏色字串，預設'transparent'
`backgroundColorHover` | String | `'rgba(200,200,200,0.25)'` | No | 輸入滑鼠移入時背景顏色字串，預設'rgba(200,200,200,0.25)'
`backgroundColorActive` | String | `'orange'` | No | 輸入主動模式時背景顏色字串，預設'orange'
`marginStyle` | Object | `{top:10,bottom:10,left:0,right:10}` | No | 輸入外距設定物件，可用鍵值為v、h、left、right、top、bottom，v代表同時設定top與bottom，h代表設定left與right，若有重複設定時後面鍵值會覆蓋前面，各鍵值為寬度數字，單位為px，預設{top:10,bottom:10,left:0,right:10}
`shadow` | Boolean | `true` | No | 輸入是否顯示陰影布林值，預設true
`shadowStyle` | String | `''` | No | 輸入陰影顏色字串，預設值詳見props
`shadowActive` | Boolean | `true` | No | 輸入主動模式時是否顯示陰影布林值，預設true
`shadowActiveStyle` | String | `''` | No | 輸入主動模式時陰影顏色字串，預設值詳見props
`paddingStyle` | Object | `{v:3,h:15}` | No | 輸入內寬距離物件，可用鍵值為v、h、left、right、top、bottom，v代表同時設定top與bottom，h代表設定left與right，若有重複設定時後面鍵值會覆蓋前面，各鍵值為寬度數字，單位為px，預設{v:3,h:15}
`shiftLeft` | Number | `0` | No | 輸入左側內寬平移距離數字，會對paddingStyle設定再添加，可調整例如圖標與左側邊框距離，單位px，預設0
`shiftRight` | Number | `0` | No | 輸入右側內寬平移距離數字，會對paddingStyle設定再添加，可調整例如關閉圖標與右側邊框距離，單位px，預設0
`suggests` | Array | `[]` | No | 輸入可選(建議)項目陣列，預設[]
`keySuggestText` | String | `'text'` | No | 輸入當可選(建議)項目為物件時，存放顯示文字之欄位字串，預設'text'
`placeholder` | String | `''` | No | 輸入無文字時的替代字符字串，預設''
`noResultsText` | String | `'No results'` | No | 輸入無過濾結果字串，預設'No results'
`addMode` | String | `'auto'` | No | 輸入新增模式字串，可使用'auto'、'input'、'button'，預設'auto'
`inputTextWidth` | Number | `150` | No | 輸入新增按鈕或輸入框區寬度數字，單位px，預設150
`inputKeyText` | String | `'text'` | No | 輸入若可選(建議)項目為元素陣列時，輸入框之提取選擇項目物件內鍵值字串，預設'text'
`inputTextFontSize` | String | `'0.85rem'` | No | 輸入輸入框文字大小字串，預設'0.85rem'
`inputTextColor` | String | `'black'` | No | 輸入輸入框文字顏色字串，預設'black'
`inputTextBackgroundColor` | String | `'white'` | No | 輸入輸入框背景顏色字串，預設'white'
`inputTextBackgroundColorHover` | String | `'white'` | No | 輸入滑鼠移入時輸入框背景顏色字串，預設'white'
`inputTextBackgroundColorFocus` | String | `'grey lighten-5'` | No | 輸入取得焦點時輸入框背景顏色字串，預設'grey lighten-5'
`inputTextBorderColor` | String | `'grey lighten-1'` | No | 輸入輸入框邊框顏色字串，預設'grey lighten-1'
`inputTextBorderColorHover` | String | `'grey'` | No | 輸入滑鼠移入時輸入框邊框字串，預設'grey'
`inputTextBorderColorFocus` | String | `'grey'` | No | 輸入取得焦點時輸入框文字邊框字串，預設'grey'
`inputTextButtonIcon` | String | `mdiPlusCircle` | No | 輸入新增按鈕圖標字串，可為mdi,md,fa代號或mdi/js路徑，預設mdiPlusCircle
`inputTextButtonColor` | String | `'grey lighten-1'` | No | 輸入輸入框按鈕顏色字串，預設'grey lighten-1'
`inputTextButtonColorHover` | String | `'grey'` | No | 輸入滑鼠移入時輸入框按鈕顏色字串，預設'grey'
`inputTextButtonColorFocus` | String | `'grey'` | No | 輸入取得焦點時輸入框按鈕顏色字串，預設'grey'
`inputTextButtonTooltip` | String | `'Add'` | No | 輸入輸入框右側按鈕提示文字字串，預設'Add'
`inputExpansionIconColor` | String | `'grey'` | No | 輸入輸入框右側圖標顏色字串，預設'grey'
`suggectItemTextColor` | String | `'grey darken-3'` | No | 輸入輸入框下拉選單項目文字顏色字串，預設'grey darken-3'
`suggectItemTextColorHover` | String | `'light-blue darken-2'` | No | 輸入輸入框下拉選單項目文字Hover顏色字串，預設'light-blue darken-2'
`suggectItemFontSize` | String | `'0.9rem'` | No | 輸入輸入框下拉選單項目顯示文字大小字串，預設'0.9rem'
`suggectItemBackgroundColor` | String | `'white'` | No | 輸入輸入框下拉選單項目背景顏色字串，預設'white'
`suggectItemBackgroundColorHover` | String | `'light-blue lighten-5'` | No | 輸入輸入框下拉選單項目背景Hover顏色字串，預設'light-blue lighten-5'
`addButtonText` | String | `'Add'` | No | 輸入新增按鈕文字字串，預設'Add'
`addButtonTextColor` | String | `'black'` | No | 輸入新增按鈕文字顏色字串，預設'black'
`addButtonTextColorHover` | String | `'black'` | No | 輸入滑鼠移入時新增按鈕文字顏色字串，預設'black'
`addButtonIcon` | String | `mdiPlusCircle` | No | 輸入新增按鈕圖標字串，可為mdi,md,fa代號或mdi/js路徑，預設mdiPlusCircle
`addButtonIconColor` | String | `'pink darken-1'` | No | 輸入新增按鈕圖標顏色字串，預設'pink darken-1'
`addButtonIconColorHover` | String | `'pink darken-1'` | No | 輸入滑鼠移入時新增按鈕圖標顏色字串，預設'pink darken-1'
`addButtonBackgroundColor` | String | `'white'` | No | 輸入新增按鈕背景顏色字串，預設'white'
`addButtonBackgroundColorHover` | String | `'white'` | No | 輸入滑鼠移入時新增按鈕背景顏色字串，預設'white'
`addButtonTooltip` | String | `'Add'` | No | 輸入新增按鈕提示文字字串，預設'Add'
`addWhenInputByOutside` | Boolean | `false` | No | 輸入當指定或自動使用input並新增時，是否強制使用click-add事件進行新增處理布林值，預設false
`closeWithInterceptor` | Boolean | `false` | No | 輸入是否通過攔截器來決定是否進行關閉布林值，此處之攔截器係用promise來控制，當使用者點擊關閉時可先行確認或提示。當closeWithInterceptor=true時，於click-close事件所接收物件資訊中的pm，使用pm.resolve()則代表確定關閉，反之pm.reject()則取消關閉事件，預設false
`draggable` | Boolean | `true` | No | 輸入是否可拖曳模式布林值，預設true
`editable` | Boolean | `true` | No | 輸入是否為編輯模式布林值，預設true
`editableClose` | Boolean | `true` | No | 輸入editable=true時是否顯示關閉按鈕布林值，預設true
`editableInput` | Boolean | `true` | No | 輸入editable=true時是否使用預設的slot input布林值，預設true
`enableCloseEventOnly` | Boolean | `false` | No | 輸入點擊移除按鈕時是否僅開啟關閉事件，代表不自動刪除項目，需通過監聽關閉事件@click-close自行處理刪除功能，預設false
`enableNodata` | Boolean | `false` | No | 輸入是否使用nodata展示布林值，預設false
`nodata` | String | `'Empty'` | No | 輸入無任何字串陣列時的預設文字字串，預設'Empty'