Appearance
ElRWDispatcherProvider
局部几个dispatcher的共同状态管理
基本使用
Activity name
Activity zone
please select your zone
Activity time
-
Instant delivery
Activity type
Resources
Activity form
ReadWrite
vue
<template>
<div>
<el-dispatcher-provider
:rw-dispatcher-state="rwState"
inactive-text="Inactive"
style="max-width: 600px"
>
<el-form-item label="Activity name">
<el-input-dispatcher v-model="form.name" />
</el-form-item>
<el-form-item label="Activity zone">
<el-select-dispatcher
v-model="form.region"
placeholder="please select your zone"
>
<el-option label="Zone one" value="shanghai" />
<el-option label="Zone two" value="beijing" />
</el-select-dispatcher>
</el-form-item>
<el-form-item label="Activity time">
<el-col :span="11">
<el-date-picker-dispatcher
v-model="form.date1"
type="date"
placeholder="Pick a date"
style="width: 100%"
/>
</el-col>
<el-col :span="2" class="text-center">
<span class="text-gray-500">-</span>
</el-col>
<el-col :span="11">
<el-time-picker-dispatcher
v-model="form.date2"
placeholder="Pick a time"
style="width: 100%"
/>
</el-col>
</el-form-item>
<el-form-item label="Instant delivery">
<el-switch-dispatcher v-model="form.delivery" />
</el-form-item>
<el-form-item label="Activity type">
<el-checkbox-group-dispatcher v-model="form.type">
<el-checkbox value="Online activities" name="type">
Online activities
</el-checkbox>
<el-checkbox value="Promotion activities" name="type">
Promotion activities
</el-checkbox>
<el-checkbox value="Offline activities" name="type">
Offline activities
</el-checkbox>
<el-checkbox value="Simple brand exposure" name="type">
Simple brand exposure
</el-checkbox>
</el-checkbox-group-dispatcher>
</el-form-item>
<el-form-item label="Resources">
<el-radio-group-dispatcher v-model="form.resource">
<el-radio value="Sponsor">Sponsor</el-radio>
<el-radio value="Venue">Venue</el-radio>
</el-radio-group-dispatcher>
</el-form-item>
<el-form-item label="Activity form">
<el-input-dispatcher v-model="form.desc" type="textarea" />
</el-form-item>
<el-form-item>
<el-button type="primary" @click="onSubmit">Create</el-button>
<el-button>Cancel</el-button>
</el-form-item>
</el-dispatcher-provider>
<el-switch
v-model="rwState"
active-value="write"
inactive-value="read"
active-text="Write"
inactive-text="Read"
@change="handleStateToggle"
>
Toggle State
</el-switch>
</div>
</template>
<script lang="ts" setup>
import { reactive, ref } from "vue";
import { type RWDispatcherState } from "element-plus-form-dispatcher/helper";
const rwState = ref<RWDispatcherState>("write");
// do not use same name with ref
const form = reactive({
name: "",
region: "",
date1: "",
date2: "",
delivery: false,
type: [],
resource: "",
desc: "",
});
const handleStateToggle = () => {
console.log(`Current stage: ${rwState.value}`);
};
const onSubmit = () => {
console.log("submit!");
};
</script>
隐藏源码
尺寸控制
局部所有子组件都继承了provider的 size 属性。
ReadWrite
Activity name
Activity zone
please select your zone
Activity time
-
Activity type
Resources
vue
<template>
<div class="flex items-center">
<el-radio-group v-model="size" aria-label="size control">
<el-radio-button value="large">large</el-radio-button>
<el-radio-button value="default">default</el-radio-button>
<el-radio-button value="small">small</el-radio-button>
</el-radio-group>
<el-switch
v-model="rwState"
active-value="write"
inactive-value="read"
active-text="Write"
inactive-text="Read"
@change="handleStateToggle"
>
Toggle State
</el-switch>
</div>
<br />
<el-dispatcher-provider
style="max-width: 600px"
:size="size"
:rw-dispatcher-state="rwState"
>
<el-form-item label="Activity name">
<el-input-dispatcher v-model="sizeForm.name" />
</el-form-item>
<el-form-item label="Activity zone">
<el-select-dispatcher
v-model="sizeForm.region"
placeholder="please select your zone"
>
<el-option label="Zone one" value="shanghai" />
<el-option label="Zone two" value="beijing" />
</el-select-dispatcher>
</el-form-item>
<el-form-item label="Activity time">
<el-col :span="11">
<el-date-picker-dispatcher
v-model="sizeForm.date1"
type="date"
aria-label="Pick a date"
placeholder="Pick a date"
style="width: 100%"
/>
</el-col>
<el-col class="text-center" :span="1" style="margin: 0 0.5rem">-</el-col>
<el-col :span="11">
<el-time-picker-dispatcher
v-model="sizeForm.date2"
aria-label="Pick a time"
placeholder="Pick a time"
style="width: 100%"
/>
</el-col>
</el-form-item>
<el-form-item label="Activity type">
<el-checkbox-group-dispatcher v-model="sizeForm.type">
<el-checkbox-button value="Online activities" name="type">
Online activities
</el-checkbox-button>
<el-checkbox-button value="Promotion activities" name="type">
Promotion activities
</el-checkbox-button>
</el-checkbox-group-dispatcher>
</el-form-item>
<el-form-item label="Resources">
<el-radio-group-dispatcher v-model="sizeForm.resource">
<el-radio border value="Sponsor">Sponsor</el-radio>
<el-radio border value="Venue">Venue</el-radio>
</el-radio-group-dispatcher>
</el-form-item>
<el-form-item>
<el-button type="primary" @click="onSubmit">Create</el-button>
<el-button>Cancel</el-button>
</el-form-item>
</el-dispatcher-provider>
</template>
<script lang="ts" setup>
import { reactive, ref } from "vue";
import type { ComponentSize, FormProps } from "element-plus";
import { type RWDispatcherState } from "element-plus-form-dispatcher/helper";
const size = ref<ComponentSize>("default");
const rwState = ref<RWDispatcherState>("write");
const sizeForm = reactive({
name: "",
region: "",
date1: "",
date2: "",
delivery: false,
type: [],
resource: "",
desc: "",
});
function onSubmit() {
console.log("submit!");
}
const handleStateToggle = () => {
console.log(`Current stage: ${rwState.value}`);
};
</script>
<style>
.el-radio-group {
margin-right: 12px;
}
</style>
隐藏源码
禁用表单
Activity name
Activity zone
Activity time
-
Instant delivery
Activity type
Resources
Activity form
ReadWrite
vue
<template>
<div>
<el-dispatcher-provider
disabled
:rw-dispatcher-state="rwState"
style="max-width: 600px"
>
<el-form-item label="Activity name">
<el-input-dispatcher v-model="form.name" />
</el-form-item>
<el-form-item label="Activity zone">
<el-select-dispatcher
v-model="form.region"
placeholder="please select your zone"
>
<el-option label="Zone one" value="shanghai" />
<el-option label="Zone two" value="beijing" />
</el-select-dispatcher>
</el-form-item>
<el-form-item label="Activity time">
<el-col :span="11">
<el-date-picker-dispatcher
v-model="form.date1"
type="date"
placeholder="Pick a date"
style="width: 100%"
/>
</el-col>
<el-col :span="2" class="text-center">
<span class="text-gray-500">-</span>
</el-col>
<el-col :span="11">
<el-time-picker-dispatcher
v-model="form.date2"
placeholder="Pick a time"
style="width: 100%"
/>
</el-col>
</el-form-item>
<el-form-item label="Instant delivery">
<el-switch-dispatcher v-model="form.delivery" />
</el-form-item>
<el-form-item label="Activity type">
<el-checkbox-group-dispatcher v-model="form.type">
<el-checkbox value="Online activities" name="type">
Online activities text
</el-checkbox>
<el-checkbox value="Promotion activities" name="type">
Promotion activities text
</el-checkbox>
<el-checkbox value="Offline activities" name="type">
Offline activities text
</el-checkbox>
<el-checkbox value="Simple brand exposure" name="type">
Simple brand exposure text
</el-checkbox>
</el-checkbox-group-dispatcher>
</el-form-item>
<el-form-item label="Resources">
<el-radio-group-dispatcher v-model="form.resource">
<el-radio value="Sponsor">Sponsor text</el-radio>
<el-radio value="Venue">Venue text</el-radio>
</el-radio-group-dispatcher>
</el-form-item>
<el-form-item label="Activity form">
<el-input-dispatcher v-model="form.desc" type="textarea" />
</el-form-item>
</el-dispatcher-provider>
<el-switch
v-model="rwState"
active-value="write"
inactive-value="read"
active-text="Write"
inactive-text="Read"
@change="handleStateToggle"
>
Toggle State
</el-switch>
</div>
</template>
<script lang="ts" setup>
import { reactive, ref } from "vue";
import { type RWDispatcherState } from "element-plus-form-dispatcher/helper";
const rwState = ref<RWDispatcherState>("write");
// do not use same name with ref
const form = reactive({
name: "张三",
region: "shanghai",
delivery: false,
desc: "xxxxxxxxxx",
date1: "2026-08-24",
date2: "2026-08-24 20:21:15",
resource: "Venue",
type: ["Online activities", "Promotion activities"],
});
const handleStateToggle = () => {
console.log(`Current stage: ${rwState.value}`);
};
</script>
隐藏源码
API
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| rw-dispatcher-state | 读写状态 | "write" | "read" | "write" |
| size | 子组件尺寸 | "large" | "default" | "small" | — |
| disabled | 禁用子组件 | boolean | false |