doc.8edf934a.js 7.3 KB

1
  1. import{e as s,o as a,G as t}from"./vendor.92dabd7f.js";const n={class:"markdown-body"},l=[t('<h1>InputNumber 数字输入框</h1><h3>介绍</h3><p>通过点击按钮控制数字增减。</p><h3>安装</h3><pre><code class="language-javascript"><span class="hljs-keyword">import</span> { createApp } <span class="hljs-keyword">from</span> <span class="hljs-string">&#39;vue&#39;</span>;\n<span class="hljs-comment">// vue</span>\n<span class="hljs-keyword">import</span> { InputNumber,Icon } <span class="hljs-keyword">from</span> <span class="hljs-string">&#39;@nutui/nutui&#39;</span>;\n<span class="hljs-comment">// taro</span>\n<span class="hljs-keyword">import</span> { InputNumber,Icon } <span class="hljs-keyword">from</span> <span class="hljs-string">&#39;@nutui/nutui-taro&#39;</span>;\n\n<span class="hljs-keyword">const</span> app = createApp();\napp.use(InputNumber).use(Icon);\n\n</code></pre><h2>代码演示</h2><h3>基础用法</h3><p>初始化一个默认值</p><pre><code class="language-html"><span class="hljs-tag">&lt;<span class="hljs-name">nut-inputnumber</span> <span class="hljs-attr">v-model</span>=<span class="hljs-string">&quot;value&quot;</span> /&gt;</span>\n</code></pre><pre><code class="language-javascript"><span class="hljs-keyword">import</span> { ref } <span class="hljs-keyword">from</span> <span class="hljs-string">&#39;vue&#39;</span>;\n\n<span class="hljs-keyword">export</span> <span class="hljs-keyword">default</span> {\n <span class="hljs-function"><span class="hljs-title">setup</span>(<span class="hljs-params"></span>)</span> {\n <span class="hljs-keyword">const</span> value = ref(<span class="hljs-number">1</span>);\n <span class="hljs-keyword">return</span> { value };\n },\n};\n</code></pre><h3>步长设置</h3><p>设置步长 <code>step</code> 5</p><pre><code class="language-html"><span class="hljs-tag">&lt;<span class="hljs-name">nut-inputnumber</span> <span class="hljs-attr">v-model</span>=<span class="hljs-string">&quot;value&quot;</span> <span class="hljs-attr">step</span>=<span class="hljs-string">&quot;5&quot;</span> /&gt;</span>\n</code></pre><h3>限制输入范围</h3><p><code>min</code> 和 <code>max</code> 属性分别表示最小值和最大值</p><pre><code class="language-html"><span class="hljs-tag">&lt;<span class="hljs-name">nut-inputnumber</span> <span class="hljs-attr">v-model</span>=<span class="hljs-string">&quot;value&quot;</span> <span class="hljs-attr">min</span>=<span class="hljs-string">&quot;10&quot;</span> <span class="hljs-attr">max</span>=<span class="hljs-string">&quot;20&quot;</span> /&gt;</span>\n</code></pre><h3>禁用状态</h3><p><code>disabled</code> 禁用状态下无法点击按钮或修改输入框。</p><pre><code class="language-html"><span class="hljs-tag">&lt;<span class="hljs-name">nut-inputnumber</span> <span class="hljs-attr">v-model</span>=<span class="hljs-string">&quot;value&quot;</span> <span class="hljs-attr">disabled</span> /&gt;</span>\n</code></pre><h3>只读禁用输入框</h3><p><code>readonly</code> 设置只读禁用输入框输入行为</p><pre><code class="language-html"><span class="hljs-tag">&lt;<span class="hljs-name">nut-inputnumber</span> <span class="hljs-attr">v-model</span>=<span class="hljs-string">&quot;value&quot;</span> <span class="hljs-attr">readonly</span> /&gt;</span>\n</code></pre><h3>支持小数点</h3><p>设置步长 <code>step</code> 0.1 <code>decimal-places</code> 小数保留1位</p><pre><code class="language-html"><span class="hljs-tag">&lt;<span class="hljs-name">nut-inputnumber</span> <span class="hljs-attr">v-model</span>=<span class="hljs-string">&quot;value&quot;</span> <span class="hljs-attr">step</span>=<span class="hljs-string">&quot;0.1&quot;</span> <span class="hljs-attr">decimal-places</span>=<span class="hljs-string">&quot;1&quot;</span> /&gt;</span>\n</code></pre><h3>支持异步修改</h3><p>通过 <code>change</code> 事件和 <code>model-value</code> 进行异步修改</p><pre><code class="language-html"><span class="hljs-tag">&lt;<span class="hljs-name">nut-inputnumber</span> <span class="hljs-attr">:model-value</span>=<span class="hljs-string">&quot;value&quot;</span> @<span class="hljs-attr">change</span>=<span class="hljs-string">&quot;onChange&quot;</span> /&gt;</span>\n</code></pre><pre><code class="language-javascript"><span class="hljs-keyword">import</span> { ref } <span class="hljs-keyword">from</span> <span class="hljs-string">&#39;vue&#39;</span>;\n\n<span class="hljs-keyword">export</span> <span class="hljs-keyword">default</span> {\n <span class="hljs-function"><span class="hljs-title">setup</span>(<span class="hljs-params"></span>)</span> {\n <span class="hljs-keyword">const</span> value = ref(<span class="hljs-number">1</span>);\n <span class="hljs-keyword">const</span> onChange = <span class="hljs-function">(<span class="hljs-params">value: number</span>) =&gt;</span> {\n <span class="hljs-built_in">setTimeout</span>(<span class="hljs-function">() =&gt;</span> {\n value.value = value;\n }, <span class="hljs-number">2000</span>);\n };\n <span class="hljs-keyword">return</span> { value,onChange };\n },\n};\n</code></pre><h3>自定义按钮大小</h3><p>设置步长 <code>step</code> 0.1 <code>decimal-places</code> 小数保留1位</p><pre><code class="language-html"><span class="hljs-tag">&lt;<span class="hljs-name">nut-inputnumber</span> <span class="hljs-attr">v-model</span>=<span class="hljs-string">&quot;value&quot;</span> <span class="hljs-attr">button-size</span>=<span class="hljs-string">&quot;30&quot;</span> <span class="hljs-attr">input-width</span>=<span class="hljs-string">&quot;50&quot;</span> /&gt;</span>\n</code></pre><h2>API</h2><h3>Props</h3><table><thead><tr><th>参数</th><th>说明</th><th>类型</th><th>默认值</th></tr></thead><tbody><tr><td>v-model</td><td>初始值</td><td>String、Number</td><td>-</td></tr><tr><td>input-width</td><td>输入框宽度</td><td>String</td><td><code>40px</code></td></tr><tr><td>button-size</td><td>操作符+、-尺寸</td><td>String</td><td><code>20px</code></td></tr><tr><td>min</td><td>最小值限制</td><td>String、Number</td><td><code>1</code></td></tr><tr><td>max</td><td>最大值限制</td><td>String、Number</td><td><code>9999</code></td></tr><tr><td>step</td><td>步长</td><td>String、Number</td><td><code>1</code></td></tr><tr><td>decimal-places</td><td>设置保留的小数位</td><td>String、Number</td><td><code>0</code></td></tr><tr><td>disabled</td><td>禁用所有功能</td><td>Boolean</td><td>false</td></tr><tr><td>readonly</td><td>只读状态禁用输入框操作行为</td><td>Boolean</td><td>false</td></tr></tbody></table><h3>Events</h3><table><thead><tr><th>事件名</th><th>说明</th><th>回调参数</th></tr></thead><tbody><tr><td>add</td><td>点击增加按钮时触发</td><td>event: Event</td></tr><tr><td>reduce</td><td>点击减少按钮时触发</td><td>event: Event</td></tr><tr><td>overlimit</td><td>点击不可用的按钮时触发</td><td>event: Event</td></tr><tr><td>change</td><td>值改变时触发</td><td>value: number , event : Event</td></tr><tr><td>blur</td><td>输入框失去焦点时触发</td><td>event: Event</td></tr><tr><td>focus</td><td>输入框获得焦点时触发</td><td>event: Event</td></tr></tbody></table>',37)],p={setup:(t,{expose:p})=>(p({frontmatter:{}}),(t,p)=>(a(),s("div",n,l)))};export{p as default};