From efdd70a391a0bcda8e2b7ed3b198be624512d3c9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Merve=20=C3=96z=C3=A7if=C3=A7i?= <merveozcifci7@gmail.com>
Date: Fri, 22 Mar 2019 11:55:10 +0300
Subject: [PATCH] Chips doc added

---
 src/components/chips/Chips.vue |   2 +-
 src/views/chips/ChipsDemo.vue  |   7 ++
 src/views/chips/ChipsDoc.vue   | 199 +++++++++++++++++++++++++++++++++
 3 files changed, 207 insertions(+), 1 deletion(-)
 create mode 100644 src/views/chips/ChipsDoc.vue

diff --git a/src/components/chips/Chips.vue b/src/components/chips/Chips.vue
index c222bd839..88e2b3d39 100644
--- a/src/components/chips/Chips.vue
+++ b/src/components/chips/Chips.vue
@@ -35,7 +35,7 @@ export default {
             this.focused = true;
             this.$emit('focus', event);
         },
-        onBlur() {
+        onBlur(event) {
             this.focused = false;
             this.$emit('blur', event);
         },
diff --git a/src/views/chips/ChipsDemo.vue b/src/views/chips/ChipsDemo.vue
index cfcbdb8f9..686c2b64c 100644
--- a/src/views/chips/ChipsDemo.vue
+++ b/src/views/chips/ChipsDemo.vue
@@ -21,16 +21,23 @@
                 </template>
             </Chips>
         </div>
+
+        <ChipsDoc />
     </div>
 </template>
 
 <script>
+import ChipsDoc from './ChipsDoc';
+
 export default {
     data() {
         return {
             value1: null,
             value2: null
         }
+    },
+    components: {
+        'ChipsDoc': ChipsDoc
     }
 }
 </script>
diff --git a/src/views/chips/ChipsDoc.vue b/src/views/chips/ChipsDoc.vue
new file mode 100644
index 000000000..23a3ac42e
--- /dev/null
+++ b/src/views/chips/ChipsDoc.vue
@@ -0,0 +1,199 @@
+<template>
+	<div class="content-section documentation">
+		<TabView>
+			<TabPanel header="Documentation">
+				<h3>Import</h3>
+<CodeHighlight lang="javascript">
+import Chips from 'primevue/chips';
+</CodeHighlight>
+
+				<h3>Getting Started</h3>
+				<p>Chips requires an array as its model.</p>
+<CodeHighlight>
+&lt;Chips v-model=&quot;value&quot; /&gt;
+</CodeHighlight>
+
+				<h3>Custom Content</h3>
+				<p>A chip is customized using a template element where the value is passed as the implicit variable.</p>
+<CodeHighlight>
+<template v-pre>
+&lt;Chips v-model=&quot;value&quot;&gt;
+	&lt;template #chip=&quot;slotProps&quot;&gt;
+		&lt;div&gt;
+			&lt;span&gt;{{slotProps.value}} - (active) &lt;/span&gt;
+			&lt;i class=&quot;pi pi-user-plus&quot; style=&quot;font-size: 14px&quot;&gt;&lt;/i&gt;
+		&lt;/div&gt;
+	&lt;/template&gt;
+&lt;/Chips&gt;
+</template>
+</CodeHighlight>
+
+				<h3>Properties</h3>
+				<div class="doc-tablewrapper">
+					<table class="doc-table">
+						<thead>
+						<tr>
+							<th>Name</th>
+							<th>Type</th>
+							<th>Default</th>
+							<th>Description</th>
+						</tr>
+						</thead>
+						<tbody>
+						<tr>
+							<td>value</td>
+							<td>array</td>
+							<td>null</td>
+							<td>Value of the component.</td>
+						</tr>
+						<tr>
+							<td>disabled</td>
+							<td>boolean</td>
+							<td>false</td>
+							<td>When present, it specifies that the element should be disabled.</td>
+						</tr>
+						<tr>
+							<td>max</td>
+							<td>number</td>
+							<td>null</td>
+							<td>Maximum number of entries allowed.</td>
+						</tr>
+						</tbody>
+					</table>
+				</div>
+
+				<h3>Events</h3>
+				<div class="doc-tablewrapper">
+					<table class="doc-table">
+						<thead>
+						<tr>
+							<th>Name</th>
+							<th>Parameters</th>
+							<th>Description</th>
+						</tr>
+						</thead>
+						<tbody>
+						<tr>
+							<td>input</td>
+							<td>value: New value of the component</td>
+							<td>Callback to invoke on input event of input field.</td>
+						</tr>
+						<tr>
+							<td>focus</td>
+							<td>event: Browser event</td>
+							<td>Callback to invoke when a input is focused.</td>
+						</tr>
+						<tr>
+							<td>blur</td>
+							<td>event: Browser event</td>
+							<td>Callback to invoke when a input loses focus.</td>
+						</tr>
+						<tr>
+							<td>add</td>
+							<td>originalEvent: Browser event <br/>
+								value: Added item value</td>
+							<td>Callback to invoke when a chip is added.</td>
+						</tr>
+						<tr>
+							<td>remove</td>
+							<td>originalEvent: Browser event <br/>
+								value: Removed item value</td>
+							<td>Callback to invoke when a chip is removed.</td>
+						</tr>
+						</tbody>
+					</table>
+				</div>
+
+				<h3>Styling</h3>
+				<p>Following is the list of structural style classes, for theming classes visit <router-link to="/theming">theming</router-link> page.</p>
+				<div class="doc-tablewrapper">
+					<table class="doc-table">
+						<thead>
+						<tr>
+							<th>Name</th>
+							<th>Element</th>
+						</tr>
+						</thead>
+						<tbody>
+						<tr>
+							<td>p-chips</td>
+							<td>Container element</td>
+						</tr>
+						<tr>
+							<td>p-chips-token</td>
+							<td>Chip element container.</td>
+						</tr>
+						<tr>
+							<td>p-chips-token-icon</td>
+							<td>Icon of a chip.</td>
+						</tr>
+						<tr>
+							<td>p-chips-token-label</td>
+							<td>label of a chip.</td>
+						</tr>
+						<tr>
+							<td>p-chips-input-token</td>
+							<td>Container of input element.</td>
+						</tr>
+						</tbody>
+					</table>
+				</div>
+
+				<h3>Dependencies</h3>
+				<p>None.</p>
+			</TabPanel>
+
+			<TabPanel header="Source">
+				<a href="https://github.com/primefaces/primevue/tree/master/src/views/chips" class="btn-viewsource" target="_blank" rel="noopener noreferrer">
+					<span>View on GitHub</span>
+				</a>
+<CodeHighlight>
+<template v-pre>
+&lt;template&gt;
+	&lt;div&gt;
+		&lt;div class=&quot;content-section introduction&quot;&gt;
+			&lt;div class=&quot;feature-intro&quot;&gt;
+				&lt;h1&gt;Chips&lt;/h1&gt;
+				&lt;p&gt;Chips is used to enter multiple values on an input field.&lt;/p&gt;
+			&lt;/div&gt;
+		&lt;/div&gt;
+
+		&lt;div class=&quot;content-section implementation&quot;&gt;
+			&lt;h3 class=&quot;first&quot;&gt;Basic&lt;/h3&gt;
+			&lt;Chips v-model=&quot;value1&quot; /&gt;
+
+			&lt;h3&gt;Template&lt;/h3&gt;
+			&lt;Chips v-model=&quot;value2&quot;&gt;
+				&lt;template #chip=&quot;slotProps&quot;&gt;
+					&lt;div&gt;
+						&lt;span&gt;{{slotProps.value}} - (active) &lt;/span&gt;
+						&lt;i class=&quot;pi pi-user-plus&quot; style=&quot;font-size: 14px&quot;&gt;&lt;/i&gt;
+					&lt;/div&gt;
+				&lt;/template&gt;
+			&lt;/Chips&gt;
+		&lt;/div&gt;
+	&lt;/div&gt;
+&lt;/template&gt;
+</template>
+</CodeHighlight>
+
+<CodeHighlight lang="javascript">
+export default {
+	data() {
+		return {
+			value1: null,
+			value2: null
+		}
+	}
+}
+</CodeHighlight>
+
+<CodeHighlight lang="css">
+.p-chips .p-inputtext {
+	width: 100%;
+}
+</CodeHighlight>
+			</TabPanel>
+		</TabView>
+	</div>
+</template>
\ No newline at end of file