corrad-bp/components/process-flow/ProcessBuilderComponents.vue
Md Afiq Iskandar b2692bec73 Enhance Process Builder with Mobile Responsiveness and Node Highlighting
- Implemented mobile responsive states for the process builder, allowing for better usability on smaller screens by auto-hiding panels and providing toggle functionality.
- Added node highlighting capabilities to improve user interaction, enabling users to easily identify and navigate to specific nodes within the process flow.
- Updated the ProcessFlowCanvas component to support centering on highlighted nodes, enhancing the visual experience during node selection.
- Improved overall layout and interaction design for mobile and tablet devices, ensuring a seamless user experience across different screen sizes.
2025-07-08 14:10:50 +08:00

284 lines
7.3 KiB
Vue

<template>
<div class="process-components">
<!-- Search Bar -->
<div class="search-container p-3 mb-2">
<div class="relative">
<input
type="text"
v-model="searchQuery"
placeholder="Search..."
class="w-full px-3 py-2 pl-9 bg-white border border-gray-300 rounded text-gray-700 text-sm placeholder-gray-400 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-blue-500"
/>
<Icon
name="material-symbols:search"
class="absolute left-3 top-1/2 transform -translate-y-1/2 w-4 h-4 text-gray-400"
/>
</div>
</div>
<!-- Core Components -->
<div class="component-category mb-6">
<h3 class="text-gray-700 text-sm font-medium px-3 mb-2">Core Components</h3>
<div class="grid grid-cols-1 sm:grid-cols-2 gap-2 px-2">
<div
v-for="component in getComponentsByCategory('Core')"
:key="component.type"
class="component-item rounded p-3 flex flex-col items-center justify-center cursor-grab hover:bg-gray-100 transition-colors border border-gray-200 touch-manipulation"
:class="{ 'hidden': !matchesSearch(component) }"
draggable="true"
@dragstart="onDragStart($event, component)"
@click="addComponent(component)"
>
<Icon :name="component.icon" class="mb-2 w-6 h-6 text-gray-600" />
<span class="text-xs text-gray-600 text-center leading-tight">{{ component.name }}</span>
</div>
</div>
</div>
</div>
</template>
<script setup>
const emit = defineEmits(['add-component']);
const searchQuery = ref('');
// Define basic process components aligned with BPMN notation
const availableComponents = [
// Core components
{
type: 'start',
name: 'Start Point',
category: 'Core',
icon: 'material-symbols:play-circle-outline',
description: 'Initiates the process flow',
defaultProps: {
label: 'Start',
data: {
description: 'Process start point'
}
}
},
{
type: 'end',
name: 'End Point',
category: 'Core',
icon: 'material-symbols:stop-circle-outline',
description: 'Terminates the process flow',
defaultProps: {
label: 'End',
data: {
description: 'Process end point'
}
}
},
{
type: 'form',
name: 'Form Task',
category: 'Core',
icon: 'material-symbols:description-outline',
description: 'Form to be filled out',
defaultProps: {
label: 'Form Task',
data: {
description: 'Form submission task',
formId: null,
formName: null
}
}
},
{
type: 'api',
name: 'API Call',
category: 'Core',
icon: 'material-symbols:api',
description: 'Make external API calls',
defaultProps: {
label: 'API Call',
data: {
description: 'External API call',
apiMethod: 'GET',
apiUrl: '',
requestBody: '',
headers: '{ "Content-Type": "application/json" }',
outputVariable: 'apiResponse',
continueOnError: false,
errorVariable: 'apiError'
}
}
},
{
type: 'gateway',
name: 'Decision Point',
category: 'Core',
icon: 'material-symbols:call-split',
description: 'Decision point for flow control',
defaultProps: {
label: 'Decision Point',
data: {
description: 'Decision point for branching the workflow',
conditions: [],
defaultPath: 'Default'
}
}
},
{
type: 'notification',
name: 'Notification',
category: 'Core',
icon: 'material-symbols:notifications-outline',
description: 'Send notifications to users',
defaultProps: {
label: 'Notification',
data: {
description: 'Send notification to users',
notificationType: 'info',
recipientType: 'user',
recipientUser: '',
recipientRole: '',
recipientVariable: '',
recipientEmail: '',
subject: '',
message: '',
priority: 'medium',
deliveryOptions: {
inApp: true,
email: false,
sms: false
},
expiration: {
enabled: false,
value: 24,
unit: 'hours'
}
}
}
},
{
type: 'business-rule',
name: 'Business Rule',
category: 'Core',
icon: 'material-symbols:rule',
description: 'Apply business rules to data',
defaultProps: {
label: 'Business Rule',
data: {
description: 'Apply business rules',
ruleGroups: [],
priority: 'medium'
}
}
},
{
type: 'script',
name: 'Script Task',
category: 'Core',
icon: 'material-symbols:code',
description: 'Execute JavaScript to transform data',
defaultProps: {
label: 'Script Task',
data: {
description: 'Data transformation script',
scriptCode: '// Transform API response or process variables\n// Example:\n// processVariables.newVariable = processVariables.apiResponse.data.field;\n',
scriptLanguage: 'javascript',
inputVariables: [],
outputVariables: [],
continueOnError: false,
errorVariable: 'scriptError'
}
}
}
];
// Get components by category for rendering in sections
const getComponentsByCategory = (category) => {
return availableComponents.filter(component => component.category === category);
};
// Check if component matches search query
const matchesSearch = (component) => {
if (!searchQuery.value) return true;
const query = searchQuery.value.toLowerCase();
return (
component.name.toLowerCase().includes(query) ||
component.description.toLowerCase().includes(query) ||
component.type.toLowerCase().includes(query)
);
};
// Handle drag start event
const onDragStart = (event, component) => {
// Set the component data in the format expected by ProcessFlowCanvas
const componentData = {
type: component.type,
label: component.defaultProps.label,
data: component.defaultProps.data
};
// Set the drag data with text/plain format for better Mac compatibility
event.dataTransfer.effectAllowed = 'copy';
event.dataTransfer.dropEffect = 'copy';
event.dataTransfer.setData('text/plain', JSON.stringify(componentData));
// Add visual feedback
event.target.classList.add('dragging');
};
// Add a component directly via click
const addComponent = (component) => {
// Use same format as drag operation for consistency
const componentData = {
type: component.type,
label: component.defaultProps.label,
data: component.defaultProps.data
};
emit('add-component', componentData);
};
</script>
<style scoped>
.process-components {
@apply bg-white h-full;
}
.component-item {
@apply h-20;
min-height: 80px;
transition: all 0.15s ease-in-out;
}
.component-item:hover {
transform: translateY(-2px);
}
.component-item:active {
transform: scale(0.97);
}
/* Mobile touch-friendly adjustments */
@media (max-width: 768px) {
.component-item {
@apply h-24;
min-height: 96px;
}
}
/* Touch device optimizations */
@media (hover: none) and (pointer: coarse) {
.component-item {
min-height: 44px; /* iOS recommended touch target */
}
.component-item:hover {
transform: none; /* Disable hover effects on touch devices */
}
.component-item:active {
transform: scale(0.95);
background-color: #f3f4f6;
}
}
</style>