开发预览更新于 2026-05-10

PasswordStrength 密码强度

密码输入 + 4 段强度条 + 实时需求清单 + 显隐切换。

基础用法

默认 4 条规则（8+ 字符 / 大写 / 数字 / 符号），用户可通过 requirements 自定义。

背景

8+ 位字符
1 个大写字母
1 个数字
1 个符号

<script setup lang="ts">
import { ref } from 'vue';
import { CfPasswordStrength } from '@chufix-design/vue';
const pwd = ref('');
</script>

<template>
  <div style="max-width: 360px;">
    <CfPasswordStrength v-model="pwd" placeholder="试着输入复杂密码…" />
  </div>
</template>

<script setup>
import { ref } from 'vue';
import { CfPasswordStrength } from '@chufix-design/vue';
const pwd = ref('');
</script>

<template>
  <div style="max-width: 360px;">
    <CfPasswordStrength v-model="pwd" placeholder="试着输入复杂密码…" />
  </div>
</template>

<CfPasswordStrength value={pwd} onChange={setPwd} />

<CfPasswordStrength value={pwd} onChange={setPwd} />

自定义规则

可传 requirements 替换默认 4 条规则，每条 { label, test }。

背景

12+ 位字符
不包含空格
至少 1 个小写
至少 1 个大写
至少 1 个数字
至少 1 个特殊字符

<script setup lang="ts">
import { ref } from 'vue';
import { CfPasswordStrength } from '@chufix-design/vue';
const pwd = ref('');
const requirements = [
  { label: '12+ 位字符', test: (v: string) => v.length >= 12 },
  { label: '不包含空格', test: (v: string) => !!v && !/\s/.test(v) },
  { label: '至少 1 个小写', test: (v: string) => /[a-z]/.test(v) },
  { label: '至少 1 个大写', test: (v: string) => /[A-Z]/.test(v) },
  { label: '至少 1 个数字', test: (v: string) => /\d/.test(v) },
  { label: '至少 1 个特殊字符', test: (v: string) => /[!@#$%^&*]/.test(v) },
];
</script>

<template>
  <div style="max-width: 360px;">
    <CfPasswordStrength v-model="pwd" :requirements="requirements" placeholder="自定义规则…" />
  </div>
</template>

<script setup>
import { ref } from 'vue';
import { CfPasswordStrength } from '@chufix-design/vue';
const pwd = ref('');
const requirements = [
  { label: '12+ 位字符', test: (v) => v.length >= 12 },
  { label: '不包含空格', test: (v) => !!v && !/\s/.test(v) },
  { label: '至少 1 个小写', test: (v) => /[a-z]/.test(v) },
  { label: '至少 1 个大写', test: (v) => /[A-Z]/.test(v) },
  { label: '至少 1 个数字', test: (v) => /\d/.test(v) },
  { label: '至少 1 个特殊字符', test: (v) => /[!@#$%^&*]/.test(v) },
];
</script>

<template>
  <div style="max-width: 360px;">
    <CfPasswordStrength v-model="pwd" :requirements="requirements" placeholder="自定义规则…" />
  </div>
</template>

<CfPasswordStrength value={pwd} onChange={setPwd} requirements={rules} />

<CfPasswordStrength value={pwd} onChange={setPwd} requirements={rules} />

API

属性	类型	默认值	说明
`modelValue` / `v-model` (Vue), `value/onChange` (React)	`string`	`''`	密码值
`size`	`'sm' \| 'md' \| 'lg'`	`'md'`
`placeholder`	`string`	`'请输入密码'`
`disabled`	`boolean`	`false`
`showToggle`	`boolean`	`true`	显示眼睛切换显隐
`requirements`	`PasswordRequirement[]`	`defaultPasswordRequirements`	`{ label, test }[]`