Sistema di componenti aziendale · Nuova risorsa

Element Plus Sistema di progettazione.

Usa il modello Transfer, i filtri e le opzioni disabilitate effettivi di Element Plus per creare un ambiente di lavoro per la selezione dei moduli, con colori, dimensioni tipografiche e dimensioni dei controlli verificati.

Guida OpenDesign9 capitoli35 voci di riferimentoGuida applicativa originale
01

Anteprima dell'interfaccia del sistema di progettazione sistema di design Element Plus

Filtra e sposta i moduli tra due liste Transfer native, controlla le chiavi selezionate e applica una selezione locale.

Selezione dei moduli dell'area di lavoroApri l’esempio completo
Element Plus 2.14.7 nativo con Vue 3 e un ConfigProvider in inglese. · Riferimento per l’implementazione
02

Riferimento di progettazione del sistema sistema di design Element Plus

Element Plus 2.14.7 predefinito compilato CSS. Le variabili riportano i valori verificati del pacchetto, inclusi gli alias semantici. Il layout di trasferimento usa le regole originali di composizione responsive, separate dalle fondamenta del sistema.

Colori primari e di stato

Fonte
Nome / regolaValore / configurazioneUtilizzo
--el-color-primary#409eff Accento primario predefinito.
--el-color-primary-light-3#79bbff Tinta primaria usata per le interazioni più chiare.
--el-color-primary-light-5#a0cfff Tinta intermedia.
--el-color-primary-light-7#c6e2ff Tinta chiara.
--el-color-primary-light-9#ecf5ff Superficie contenuta per la selezione e il pannello delle chiavi.
--el-color-primary-dark-2#337ecc Stato primario più scuro.
--el-color-success#67c23a Ruolo di successo.
--el-color-warning#e6a23c Ruolo di avviso.
--el-color-danger#f56c6c Ruolo di errore/pericolo.
--el-color-info#909399 Ruolo neutro informativo.

Testo semantico e superfici

Fonte
Nome / regolaValore / configurazioneUtilizzo
--el-text-color-primary#303133 Testo principale per la lettura.
--el-text-color-regular#606266 Testo ordinario dei componenti.
--el-text-color-secondary#909399 Testo di aiuto e metadati.
--el-text-color-placeholder#a8abb2 Ruolo del testo segnaposto.
--el-bg-color#fffSuperficie predefinita.
--el-bg-color-page#f2f3f5 Sfondo della pagina.
--el-bg-color-overlay#fffSuperficie di sovrapposizione.
--el-border-color#dcdfe6 Bordo predefinito.
--el-border-color-light#e4e7ed Bordo discreto di schede e riepiloghi.

Tipografia, controlli e forme

Fonte
Nome / regolaValore / configurazioneUtilizzo
--el-font-family"Helvetica Neue", Helvetica, "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", "微软雅黑", Arial, sans-serifPreferenza per la famiglia predefinita.
--el-font-size-extra-large20pxScala del titolo: 20 px.
--el-font-size-large18pxScala: 18 px.
--el-font-size-medium16pxScala: 16 px.
--el-font-size-base14pxDimensione base: 14 px.
--el-font-size-small13pxScala: 13 px.
--el-font-size-extra-small12pxScala: 12 px.
--el-border-radius-base4pxAngolo standard del componente.
--el-border-radius-small2pxAngolo piccolo.
--el-component-size-large40pxAltezza grande dei controlli.
--el-component-size32pxAltezza predefinita dei controlli.
--el-component-size-small24pxAltezza ridotta dei controlli.

Layout originale dell'area di lavoro dei moduli

Fonte
Nome / regolaValore / configurazioneUtilizzo
Desktop panel arrangementtwo panels with 180px reserved betweenAdattamento originale attorno al Transfer nativo.
Narrow layout≤700px: stacked panelsPunto di interruzione originale, non un token Element Plus.
Page spacing32px desktop; 20px 16px mobileSpaziatura esterna originale.
Summary spacing24px padding / 24px gapComposizione originale delle chiavi selezionate e del riepilogo dei moduli.
03

Guida completa al sistema di progettazione sistema di design Element Plus

Una guida pratica per scegliere, applicare e valutare questo sistema in un’interfaccia reale.

DESIGN-element-plus.md

Indicazioni complete, un punto di partenza per l’implementazione e link alle fonti.

Scarica la guida

Sistema di design Element Plus Sistema di progettazione: una lista di trasferimento prevede due tipi di selezione

Una lista di trasferimento prevede due tipi di selezione

Element Plus Transfer presenta liste di elementi disponibili e di destinazione, con controlli per spostare gli elementi selezionati. L'area di lavoro dei moduli usa il componente Vue effettivo della versione 2.14.7. Il suo v-model contiene le chiavi di destinazione, inizialmente catalog e tokens. Una casella di controllo all'interno di una lista contrassegna un elemento per la successiva azione di trasferimento; non indica che l'elemento appartenga già alla destinazione.

Da questa guida su OpenDesign

Questa distinzione è resa visibile dalla lettura in tempo reale del modello. Selezionando un elemento di origine lo si prepara per l'aggiunta. Premendo Add si modifica l'array delle chiavi di destinazione, si aggiorna il riepilogo dei moduli selezionati e si cancella ogni risultato applicato in precedenza. In questo modo è possibile osservare il contratto del modello della libreria senza doverlo dedurre da due liste statiche.

Leggi la specifica di supporto

Sistema di design Element Plus Sistema di progettazione: ruoli predefiniti e dimensioni concrete dei componenti

Ruoli predefiniti e dimensioni concrete dei componenti

Element Plus espone --el-color-primary e le relative varianti chiare e scure, i ruoli di stato, i colori del testo e le variabili delle superfici. La tabella riporta i valori effettivi compilati del pacchetto installato. Il pannello delle chiavi circostante usa primary-light-9 e il testo ordinario, mentre il pulsante di azione adotta lo stile primario nativo.

La tipografia predefinita include una dimensione base di quattordici pixel, con dimensioni complementari di dodici, tredici, sedici, diciotto e venti pixel. Le variabili relative alle dimensioni dei componenti descrivono le misure piccola, predefinita e grande dei controlli. Non vanno confuse con una scala di spaziatura per il layout di pagina. Gli spazi di ventiquattro pixel e la spaziatura esterna di trentadue pixel dell'area di lavoro sono scelte di composizione originali ed esplicite.

Leggi la specifica di supporto

Sistema di design Element Plus Sistema di progettazione: chiavi stabili, etichette e opzioni disabilitate

Chiavi stabili, etichette e opzioni disabilitate

Ogni opzione ha una chiave, un'etichetta e un flag di disabilitazione. L'array selezionato contiene queste chiavi, consentendo di cambiare le etichette senza modificarne l'identità. I moduli di esempio includono Catalogo risorse, Ispezione dei token, Coda di revisione, Cronologia delle versioni e Ricerca tra progetti. Esportazione audit resta disabilitata per mostrare un'opzione visibile ma non disponibile.

La disponibilità in questo esempio è un dato dimostrativo statico. Non rappresenta una verifica dei diritti di accesso e non garantisce che questi moduli esistano come prodotti installabili. In un'applicazione reale, la fonte delle opzioni e le regole di autorizzazione devono provenire dal modello del prodotto. Non dedurre le autorizzazioni dal fatto che sia possibile fare clic su una casella di controllo Transfer.

Leggi la specifica di supporto

Sistema di design Element Plus Sistema di progettazione: la ricerca modifica la visibilità, non l'appartenenza

La ricerca modifica la visibilità, non l'appartenenza

filterable aggiunge ricerche indipendenti ai pannelli. Il testo segnaposto del filtro suggerisce un'azione concreta: Trova un modulo. Il filtro predefinito confronta l'etichetta dell'opzione. Durante una ricerca, un elemento selezionato può scomparire dalla lista di destinazione visibile senza essere rimosso dall'array delle chiavi selezionate; il riepilogo e la lettura continuano a mostrare l'intero insieme di destinazione.

Gli slot personalizzati per lo stato vuoto a sinistra e a destra distinguono un pannello senza opzioni corrispondenti dal caso globale in cui non è selezionato nulla. La pagina disabilita inoltre localmente Apply quando l'array di destinazione è vuoto. Sono stati distinti: nessuna corrispondenza nella ricerca non significa nessun modulo selezionato.

  1. Cerca Review queue nel pannello degli elementi disponibili.
  2. Seleziona l'opzione corrispondente e premi Add.
  3. Cancella la ricerca e verifica che review compaia nella lettura del modello e nella lista di destinazione.

Leggi la specifica di supporto

Sistema di design Element Plus Sistema di progettazione: mantieni la relazione tra le due liste sui dispositivi mobili

Mantieni la relazione tra le due liste sui dispositivi mobili

Su desktop, i pannelli Transfer nativi sono affiancati, con un'area dedicata ai comandi Add e Remove. Sugli schermi larghi al massimo settecento pixel, i pannelli si dispongono in verticale e i pulsanti di azione formano una riga orizzontale tra loro. I titoli continuano a identificare i Moduli disponibili e i Moduli dell'area di lavoro, così la direzione dello spostamento resta chiara.

L'area di lavoro non riduce l'intero controllo per adattarlo allo schermo del telefono. Adatta la composizione mantenendo etichette, caselle di controllo, ricerche e contenuti delle liste alle dimensioni native e leggibili. La lettura delle chiavi selezionate e il riepilogo testuale passano a un'unica colonna sottostante, conservando le stesse informazioni anziché nasconderle al breakpoint più stretto.

Leggi la specifica di supporto

Sistema di design Element Plus Sistema di progettazione: appartenenza provvisoria e istantanea applicata

Appartenenza provvisoria e istantanea applicata

Applica localmente copia l'array delle chiavi selezionate. Una successiva modifica del trasferimento azzera lo stato applicato, così l'avviso di operazione riuscita non resta visibile dopo che l'utente ha modificato la selezione temporanea. Ripristina selezione iniziale assegna un nuovo array di catalogo/token e azzera anche il risultato applicato. Le transizioni di stato sono espresse in poche righe esplicite nel codice sorgente Vue.

L'avviso indica soltanto che la selezione dell'anteprima locale è stata applicata. Non dichiara che sia avvenuta un'installazione, una modifica dei diritti o un aggiornamento esterno. In una vera schermata delle impostazioni, lo stato applicato dovrebbe corrispondere a un risultato di persistenza confermato; un evento del componente, da solo, non costituisce una conferma del server.

Leggi la specifica di supporto

Element Plus Controlli nativi del sistema di design e istruzioni comprensibili

Controlli nativi e istruzioni comprensibili

L'esempio mantiene le caselle di controllo e i pulsanti di trasferimento nativi di Transfer. Il testo dei pulsanti è impostato su Rimuovi e Aggiungi, anziché lasciare soltanto icone direzionali, una scelta particolarmente utile quando gli elenchi sono disposti in verticale. I titoli dei pannelli chiariscono i ruoli di origine e destinazione, mentre la frase di aiuto spiega la sequenza: selezionare e poi spostare.

L'opzione disabilitata resta visibile nel contesto e gli slot vuoti del pannello indicano che non ci sono opzioni corrispondenti. Chi usa la tastiera deve poter raggiungere i campi di ricerca, le caselle di controllo e i pulsanti senza gestori personalizzati utilizzabili solo con il puntatore. Il componente gestisce il proprio comportamento interno; l'applicazione evita di sostituire questa struttura con righe disegnate che si limitano a sembrare controlli di selezione.

  • I titoli dei pannelli indicano quale elenco è la destinazione.
  • Le etichette testuali mantengono chiara la direzione del trasferimento nel layout a colonne sovrapposte.
  • La visualizzazione in tempo reale del modello rende individuabili gli elementi selezionati non visibili.

Leggi la specifica di supporto

Sistema di design Element Plus Compilare il componente Vue e caricare CSS

Compila il componente Vue e carica CSS

In un progetto Vue 3 Vite, installa [email protected] e importa element-plus/dist/index.css prima del layout originale CSS. Il file App.vue completo usa script setup e importa direttamente i componenti. ElConfigProvider riceve la lingua inglese, così i testi integrati dei pannelli e dello stato vuoto restano coerenti con la pagina di riferimento in inglese.

La configurazione fornita, adatta alla produzione, importa App.vue tramite il plugin Vue Vite. L'esempio offline è stato creato compilando lo stesso componente a file singolo e includendolo localmente nel bundle. Non richiede una CDN esterna, un servizio di importazione automatica né un compilatore di template a runtime. Se un progetto esistente usa un plugin di importazione automatica, mantieni gli stili generati coerenti con la strategia scelta per l'importazione completa o per singolo componente.

Leggi la specifica di supporto

Element Plus Le personalizzazioni del tema del sistema di design devono preservare le relazioni tra i componenti

Le personalizzazioni del tema devono preservare le relazioni tra i componenti

Le proprietà personalizzate CSS sono utili per modificare i ruoli condivisi senza riscrivere i selettori di ogni componente. L'ambiente di lavoro usa le variabili --el effettive per sfondo, testo, bordi e angoli. Modifica solo i selettori di layout necessari per adattare Transfer nativo a questa specifica composizione.

Per un tema di brand più ampio, usa l'approccio documentato basato su Sass o sulle variabili CSS ed esamina insieme gli stati hover, disabilitato e focus. Sostituire il solo valore esadecimale del colore principale in uno screenshot non tiene conto delle superfici più chiare e delle interazioni più scure. La tabella basata sul codice sorgente fornisce i valori iniziali; l'anteprima nativa completa permette di esaminarne gli effetti su un componente funzionante.

Leggi la specifica di supporto

Element Plus Esempi di componenti del sistema di design

Componente Vue completo per la selezione dei moduli

Un componente a file singolo che usa Transfer, Card, Alert, Button e Tag nativi.

vue
<script setup>
import {ref,computed} from 'vue';
import {ElConfigProvider,ElTransfer,ElCard,ElButton,ElTag,ElAlert} from 'element-plus';
import en from 'element-plus/es/locale/lang/en';
const modules=[{key:'catalog',label:'Asset catalog',disabled:false},{key:'tokens',label:'Token inspector',disabled:false},{key:'review',label:'Review queue',disabled:false},{key:'history',label:'Version history',disabled:false},{key:'audit',label:'Audit export · unavailable',disabled:true},{key:'search',label:'Cross-project search',disabled:false}];
const selected=ref(['catalog','tokens']),applied=ref(null);const names=computed(()=>modules.filter(x=>selected.value.includes(x.key)).map(x=>x.label));
const changed=()=>{applied.value=null};
</script>
<template><ElConfigProvider :locale="en"><main class="module-desk"><header><p class="eyebrow">ELEMENT PLUS / WORKSPACE COMPOSITION</p><h1>Choose the tools this team needs.</h1><p>Move modules between lists, then inspect the exact selected keys.</p></header><ElCard shadow="never"><template #header><div class="card-heading"><h2>Module selection</h2><ElTag type="info">{{selected.length}} selected</ElTag></div></template><ElTransfer v-model="selected" :data="modules" filterable filter-placeholder="Find a module" :titles="['Available modules','Workspace modules']" :button-texts="['Remove','Add']" @change="changed"><template #left-empty><p class="empty">No available module matches.</p></template><template #right-empty><p class="empty">No selected module matches.</p></template></ElTransfer><p class="help">Check a module before using Add or Remove. Audit export stays disabled in this sample.</p></ElCard><div class="summary-grid"><section class="summary"><h2>Workspace modules</h2><ul v-if="names.length"><li v-for="name in names" :key="name">{{name}}</li></ul><p v-else>No modules selected. Add at least one before applying.</p><div class="actions"><ElButton type="primary" :disabled="!selected.length" @click="applied=[...selected]">Apply locally</ElButton><ElButton @click="selected=['catalog','tokens'];changed()">Restore starting set</ElButton></div><ElAlert v-if="applied" title="Selection applied to the local preview" type="success" :closable="false" show-icon description="No installation, entitlement change or external update was performed." /></section><section class="key-panel"><p class="eyebrow">V-MODEL VALUE</p><pre>{{JSON.stringify(selected,null,2)}}</pre><p>The model contains keys, not option objects. Search filters visibility without changing this array.</p></section></div><footer>Native Element Plus Transfer, Card, Tag, Button and Alert. Local module names and availability are original examples.</footer></main></ElConfigProvider></template>

Riferimento del codice

  • v-model memorizza le chiavi selezionate, non gli oggetti delle opzioni completi.
  • Un'opzione disabilitata resta visibile, ma non può essere trasferita.
  • La modifica della selezione di Transfer azzera lo stato applicato non più aggiornato.

Composizione di Transfer adattabile

Gli stili mantengono i pannelli e i controlli nativi, disponendoli in verticale sugli schermi più stretti.

css
body{margin:0;background:var(--el-bg-color-page);font-family:var(--el-font-family);color:var(--el-text-color-primary);font-size:var(--el-font-size-base);line-height:1.6}.module-desk{max-width:1080px;margin:auto;padding:32px}header{max-width:700px;margin-bottom:28px}h1{font-size:34px;line-height:1.2;letter-spacing:-.03em;margin:10px 0 16px}h2{font-size:20px;line-height:1.3;margin:0}.eyebrow{font-size:11px;letter-spacing:.12em;font-weight:700;color:var(--el-text-color-secondary)}.card-heading{display:flex;justify-content:space-between;align-items:center;gap:12px}.el-transfer{--el-transfer-panel-body-height:210px;display:flex;align-items:center;justify-content:center}.el-transfer-panel{width:calc((100% - 180px)/2)}.el-transfer__buttons{padding:0 20px;display:flex;flex-direction:column;gap:10px}.el-transfer__buttons .el-button{margin:0}.help,.empty{font-size:13px;color:var(--el-text-color-secondary)}.empty{padding:16px}.summary-grid{display:grid;grid-template-columns:1fr 1fr;gap:24px;margin-top:24px}.summary,.key-panel{background:var(--el-bg-color);border:1px solid var(--el-border-color-light);border-radius:var(--el-border-radius-base);padding:24px}.actions{display:flex;flex-wrap:wrap;gap:8px;margin:20px 0}.actions .el-button{margin:0}.key-panel{background:var(--el-color-primary-light-9)}pre{font:14px/1.7 monospace;white-space:pre-wrap}.key-panel p{font-size:13px}.summary li{margin:6px 0}footer{font-size:12px;color:var(--el-text-color-secondary);margin-top:20px}@media(max-width:700px){.module-desk{padding:20px 16px}h1{font-size:28px}.el-transfer{flex-direction:column;gap:16px}.el-transfer-panel{width:100%}.el-transfer__buttons{flex-direction:row;padding:0}.summary-grid{grid-template-columns:1fr}.el-card__body{padding:16px}}

Riferimento del codice

  • Il punto di interruzione e il layout circostante sono scelte originali.
04

Sistema di design Element Plus Configurazione dell'agente

Punto di partenza per l’implementazione

Verificato con Vue 3 e Element Plus 2.14.7. App.vue fornisce ConfigProvider in inglese e importa esplicitamente i componenti. Tutto lo stato è locale.

javascript
// Create the project first:
// npm create vite@latest element-plus-specimen -- --template vue
// cd element-plus-specimen && npm install
// In a Vite Vue 3 project:
// npm install [email protected]
// Save the complete single-file component above as App.vue.
// main.js
import {createApp} from 'vue';
import 'element-plus/dist/index.css';
import './style.css';
import App from './App.vue';
createApp(App).mount('#app');
// index.html: <div id="app"></div>
// style.css: use the complete responsive composition above.
// Vite's standard Vue template includes @vitejs/plugin-vue for .vue files.
// Keep the template index.html and replace its entry with the code above.
// npm run dev

Un prompt per il tuo progetto

Prompt per l’agente
Estendi il selettore dei moduli dell'area di lavoro Element Plus 2.14.7 fornita usando ElTransfer nativo. Mantieni i sei moduli con chiave, la voce Audit disabilitata, il comportamento di filtro e l'array controllato delle chiavi selezionate. L'applicazione deve acquisire la selezione corrente dei moduli; le modifiche successive devono rendere visibilmente obsoleta quella fotografia, mentre il ripristino deve riportare alla selezione iniziale. Mantieni il layout adattabile a due pannelli e il comportamento degli elementi disabilitati, senza ricostruire Transfer come elenchi indipendenti. Carica il foglio di stile nativo prima della composizione originale CSS.
05

Element Plus Fonti e ambito del sistema di design

Riferimento nativo Element Plus 2.14.7. I nomi dei moduli e le autorizzazioni sono esempi originali; la selezione locale non comporta installazioni né modifiche dei diritti.