@italia/button 0.1.0-alpha.1 → 0.1.0-alpha.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/custom-elements.json +42 -23
- package/dist/src/it-button.d.ts +3 -4
- package/dist/src/it-button.d.ts.map +1 -1
- package/dist/src/it-button.js +974 -84
- package/dist/src/it-button.js.map +1 -1
- package/package.json +15 -12
- package/styles/globals.scss +7 -1
package/custom-elements.json
CHANGED
|
@@ -40,16 +40,6 @@
|
|
|
40
40
|
},
|
|
41
41
|
"privacy": "private"
|
|
42
42
|
},
|
|
43
|
-
{
|
|
44
|
-
"kind": "field",
|
|
45
|
-
"name": "_buttonClasses",
|
|
46
|
-
"type": {
|
|
47
|
-
"text": "string"
|
|
48
|
-
},
|
|
49
|
-
"privacy": "private",
|
|
50
|
-
"default": "''",
|
|
51
|
-
"attribute": "_buttonClasses"
|
|
52
|
-
},
|
|
53
43
|
{
|
|
54
44
|
"kind": "field",
|
|
55
45
|
"name": "type",
|
|
@@ -124,6 +114,24 @@
|
|
|
124
114
|
"name": "internals",
|
|
125
115
|
"attribute": "internals"
|
|
126
116
|
},
|
|
117
|
+
{
|
|
118
|
+
"kind": "field",
|
|
119
|
+
"name": "disabled",
|
|
120
|
+
"type": {
|
|
121
|
+
"text": "boolean | undefined"
|
|
122
|
+
},
|
|
123
|
+
"attribute": "it-aria-disabled",
|
|
124
|
+
"reflects": true
|
|
125
|
+
},
|
|
126
|
+
{
|
|
127
|
+
"kind": "field",
|
|
128
|
+
"name": "expanded",
|
|
129
|
+
"type": {
|
|
130
|
+
"text": "boolean | undefined"
|
|
131
|
+
},
|
|
132
|
+
"attribute": "it-aria-expanded",
|
|
133
|
+
"reflects": true
|
|
134
|
+
},
|
|
127
135
|
{
|
|
128
136
|
"kind": "method",
|
|
129
137
|
"name": "surfaceSubmitEvent",
|
|
@@ -141,6 +149,11 @@
|
|
|
141
149
|
"name": "form",
|
|
142
150
|
"readonly": true
|
|
143
151
|
},
|
|
152
|
+
{
|
|
153
|
+
"kind": "method",
|
|
154
|
+
"name": "focus",
|
|
155
|
+
"privacy": "public"
|
|
156
|
+
},
|
|
144
157
|
{
|
|
145
158
|
"kind": "field",
|
|
146
159
|
"name": "_onKeyDown",
|
|
@@ -148,14 +161,6 @@
|
|
|
148
161
|
}
|
|
149
162
|
],
|
|
150
163
|
"attributes": [
|
|
151
|
-
{
|
|
152
|
-
"name": "_buttonClasses",
|
|
153
|
-
"type": {
|
|
154
|
-
"text": "string"
|
|
155
|
-
},
|
|
156
|
-
"default": "''",
|
|
157
|
-
"fieldName": "_buttonClasses"
|
|
158
|
-
},
|
|
159
164
|
{
|
|
160
165
|
"name": "type",
|
|
161
166
|
"type": {
|
|
@@ -215,6 +220,20 @@
|
|
|
215
220
|
{
|
|
216
221
|
"name": "internals",
|
|
217
222
|
"fieldName": "internals"
|
|
223
|
+
},
|
|
224
|
+
{
|
|
225
|
+
"name": "it-aria-disabled",
|
|
226
|
+
"type": {
|
|
227
|
+
"text": "boolean | undefined"
|
|
228
|
+
},
|
|
229
|
+
"fieldName": "disabled"
|
|
230
|
+
},
|
|
231
|
+
{
|
|
232
|
+
"name": "it-aria-expanded",
|
|
233
|
+
"type": {
|
|
234
|
+
"text": "boolean | undefined"
|
|
235
|
+
},
|
|
236
|
+
"fieldName": "expanded"
|
|
218
237
|
}
|
|
219
238
|
],
|
|
220
239
|
"superclass": {
|
|
@@ -291,7 +310,7 @@
|
|
|
291
310
|
{
|
|
292
311
|
"kind": "variable",
|
|
293
312
|
"name": "meta",
|
|
294
|
-
"default": "{ title: 'Componenti/Button', tags: ['autodocs'], component: 'it-button', args: { slot: 'Testo del pulsante', variant: 'primary', size: undefined, block: false, outline: false,
|
|
313
|
+
"default": "{ title: 'Componenti/Button', tags: ['autodocs'], component: 'it-button', args: { slot: 'Testo del pulsante', variant: 'primary', size: undefined, block: false, outline: false, disabled: false, icon: false, type: 'button', value: '', 'aria-label': 'Aria label', }, argTypes: { variant: { control: 'select', description: 'Varianti di colore', options: BUTTON_VARIANTS, }, size: { control: 'select', description: 'Dimensione del pulsante', options: BUTTON_SIZES, }, block: { control: 'boolean', type: 'boolean', description: 'Quando abilitato, estende il componente Button fino a prendere tutta la larghezza disponibile', table: { defaultValue: { summary: 'false' } }, }, disabled: { control: 'boolean', type: 'boolean', name: 'it-aria-disabled', table: { defaultValue: { summary: 'false' } }, }, outline: { control: 'boolean', type: 'boolean', description: 'Applica il colore solamente al bordo, usando il colore di sfondo come colore interno del pulsante.', table: { defaultValue: { summary: 'false' } }, }, icon: { control: 'boolean', type: 'boolean', description: \"Se il pulsante mostra un'icona, è necessario aggiungere questo attributo.\", table: { defaultValue: { summary: 'false' } }, }, slot: { control: 'text', description: 'Testo del pulsante', }, 'aria-label': { control: 'text', description: 'Testo aria-label del pulsante', }, type: { control: 'select', description: 'Tipologia di pulsante', options: ['button', 'submit', 'reset'], table: { defaultValue: { summary: 'button' } }, }, value: { control: 'text', }, }, parameters: { docs: { description: { component: ` <Description>Pulsante con etichetta di testo o icona che al click inizia un'azione o un evento.</Description> Per indicazioni su \"Come e Quando usarlo\" si fa riferimento alla [guida del design-system](https://designers.italia.it/design-system/componenti/buttons/). `, }, }, }, } satisfies Meta<ButtonProps>"
|
|
295
314
|
},
|
|
296
315
|
{
|
|
297
316
|
"kind": "variable",
|
|
@@ -315,7 +334,7 @@
|
|
|
315
334
|
"type": {
|
|
316
335
|
"text": "Story"
|
|
317
336
|
},
|
|
318
|
-
"default": "{ name: 'Varianti di colore', args: { slot: '' }, argTypes: { variant: { table: { disable: true, }, }, outline: { table: { disable: true, }, },
|
|
337
|
+
"default": "{ name: 'Varianti di colore', args: { slot: '' }, argTypes: { variant: { table: { disable: true, }, }, outline: { table: { disable: true, }, }, disabled: { table: { disable: true, }, }, }, parameters: { docs: { description: { story: ` Gli stili definiti da Bootstrap Italia utilizzano un naming consistente con Bootstrap, con alcune personalizzazioni. <div class=\"callout callout-success\"><div class=\"callout-inner\"><div class=\"callout-title\"><span class=\"text\">Accessibilità</span></div> <p> Le classi \\`.btn\\` e \\`.btn-\\` conferiscono agli elementi html l’aspetto visivo di un pulsante. Anche elementi \\`<a>\\` o \\`<span>\\` possono subire questa trasformazione provocando discrepanza tra ciò che si rappresenta e la funzione semantica dell’elemento. <br/> Questo può provocare complesse problematiche di accessibilità. <br/><br/> Dove il click sul pulsante non genera un cambio di pagina utilizzare esclusivamente il componente \\`<it-button>\\`. <br/><br/> Qualora non fosse possibile, è necessario applicare in modo appropriato l’attributo \\`role=\"button\"\\` per trasmetterne lo scopo alle tecnologie assistive.</p></div></div> #### Note sullo stato disabilitato I pulsanti disabilitati dovranno avere l'attributo \\`aria-disabled=\"true\"\\` per indicare lo stato dell’elemento alle tecnologie assistive. Quando si utilizza l'attributo \\`aria-disabled\\` è consigliato usare anche l'attributo \\`aria-describedby\\` (o un elemento all'interno del bottone con classe \\`.sr-only\\`) per informare tramite gli screen-reader il motivo per il quale il pulsante è disabilitato. <br/> È sconsigliato l'uso dell'attributo \\`disabled\\`. `, }, }, }, render: (args) => html` ${renderVariant({ ...args, variant: 'primary' }, 'Primary')} ${renderVariant({ ...args, variant: 'secondary' }, 'Secondary')} ${renderVariant({ ...args, variant: 'success' }, 'Success')} ${renderVariant({ ...args, variant: 'danger' }, 'Danger')} ${renderVariant({ ...args, variant: 'warning' }, 'Warning')} ${renderVariant({ ...args, variant: 'link' }, 'Pulsante link')} `, }"
|
|
319
338
|
},
|
|
320
339
|
{
|
|
321
340
|
"kind": "variable",
|
|
@@ -339,7 +358,7 @@
|
|
|
339
358
|
"type": {
|
|
340
359
|
"text": "Story"
|
|
341
360
|
},
|
|
342
|
-
"default": "{ name: 'Sfondo scuro', args: { slot: '' }, argTypes: { variant: { table: { disable: true, }, }, outline: { table: { disable: true, }, },
|
|
361
|
+
"default": "{ name: 'Sfondo scuro', args: { slot: '' }, argTypes: { variant: { table: { disable: true, }, }, outline: { table: { disable: true, }, }, disabled: { table: { disable: true, }, }, }, parameters: { docs: { description: { story: ` <div class=\"callout callout-success\"><div class=\"callout-inner\"><div class=\"callout-title\"><span class=\"text\">Trasmettere significato alle tecnologie assistive</span></div> <p> L’uso del colore per aggiungere un significato fornisce solo un’indicazione visiva, che non sarà trasmesso agli utenti di tecnologie assistive – come gli screen reader. Assicurati che le informazioni denotate dal colore siano rese disponibili anche dal contenuto stesso (es.: il testo visibile), o siano incluse attraverso mezzi alternativi, come testo aggiuntivo nascosto con la classe <code>.visually-hidden</code>.</p></div></div>`, }, }, }, render: (args) => html` <div class=\"bg-dark p-4\"> ${renderVariant({ ...args, variant: 'primary' }, 'Primary')} ${renderVariant({ ...args, variant: 'secondary' }, 'Secondary')} ${renderVariant({ ...args, variant: 'link' }, 'Pulsante link')} </div> `, }"
|
|
343
362
|
},
|
|
344
363
|
{
|
|
345
364
|
"kind": "variable",
|
|
@@ -347,7 +366,7 @@
|
|
|
347
366
|
"type": {
|
|
348
367
|
"text": "Story"
|
|
349
368
|
},
|
|
350
|
-
"default": "{ ...meta, name: 'Con icona', args: {}, argTypes: { variant: { table: { disable: true, }, }, size: { table: { disable: true, }, }, }, parameters: { docs: { description: { story: `
|
|
369
|
+
"default": "{ ...meta, name: 'Con icona', args: {}, argTypes: { variant: { table: { disable: true, }, }, size: { table: { disable: true, }, }, }, parameters: { docs: { description: { story: ` È necessario passare l'attributo \\`icon=\"true\"\\` (o \\`icon=\"\"\\`, o semplicemente \\`icon\\`) a \\`<it-button>\\` per applicargli gli stili corretti. L’icona può essere posizionata a sinistra o a destra del testo, a seconda della posizione in cui viene inserita all’interno del pulsante. <br/><br/> #### Dimensione dell'icona - Nei pulsanti di dimensione \\`lg\\` o default (\\`sm\\`), è necessario passare l'attributo \\`size=\"sm\"\\` all'icona. - Nei pulsanti di dimensione \\`xs\\`, è necessario passare l'attributo \\`size=\"xs\"\\` all'icona . #### Allineamento e spaziatura dell’icona Nel caso si utilizzi un’icona all’interno di un elemento \\`<it-button>\\` è necessario inserire il testo del pulsante all’interno di un tag \\`<span/>\\` al fine di garantire un perfetto allineamento ed una corretta spaziatura tra l’icona e lo stesso testo. <div class=\"callout callout-success\"><div class=\"callout-inner\"><div class=\"callout-title\"><span class=\"text\">Accessibilità</span></div> <p> Le icone sono di default puramente decorative. Nel caso in cui l'icona non debba essere un elemento decorativo, è necessario utilizzare correttamente gli attributi \\`label\\`, \\`role\\` e \\`aria-hidden\\` sul componente \\`<it-icon>\\`. Per maggiori dettagli visita la [guida dedicata](?path=/docs/componenti-icon--documentazione) al componente \\`<it-icon>\\`.</p></div></div> `, }, }, }, render: (params) => { const slot = params.slot?.length > 0 ? params.slot : null; return html` <div class=\"flex\"> <it-button variant=\"success\" size=\"lg\" icon ?outline=\"${params.outline}\" ?block=\"${params.block}\" ?it-aria-disabled=\"${params.disabled}\" type=\"${params.type}\" > <it-icon name=\"it-star-full\" color=\"white\" size=\"sm\"></it-icon> <span>${slot ?? 'Pulsante Large con icona'}</span> </it-button> <it-button variant=\"primary\" icon ?outline=\"${params.outline}\" ?block=\"${params.block}\" ?it-aria-disabled=\"${params.disabled}\" type=\"${params.type}\" > <it-icon name=\"it-star-full\" color=\"white\" size=\"sm\"></it-icon> <span>${slot ?? 'Pulsante con icona'}</span> </it-button> <it-button variant=\"danger\" size=\"xs\" icon ?outline=\"${params.outline}\" ?block=\"${params.block}\" ?it-aria-disabled=\"${params.disabled}\" type=\"${params.type}\" > <it-icon name=\"it-star-full\" color=\"white\" size=\"xs\"></it-icon> <span>${slot ?? 'Pulsante Extra Small con icona'}</span> </it-button> <it-button variant=\"link\" size=\"xs\" icon ?outline=\"${params.outline}\" ?block=\"${params.block}\" ?it-aria-disabled=\"${params.disabled}\" type=\"${params.type}\" > <it-icon name=\"it-star-full\" color=\"primary\" size=\"xs\"></it-icon> <span>${slot ?? 'Pulsante Link Extra Small con icona'}</span> </it-button> </div>`; }, }"
|
|
351
370
|
},
|
|
352
371
|
{
|
|
353
372
|
"kind": "variable",
|
|
@@ -355,7 +374,7 @@
|
|
|
355
374
|
"type": {
|
|
356
375
|
"text": "Story"
|
|
357
376
|
},
|
|
358
|
-
"default": "{ ...meta, name: 'Con icona cerchiata', args: {}, argTypes: { variant: { table: { disable: true, }, }, size: { table: { disable: true, }, }, }, parameters: { docs: { description: { story: `
|
|
377
|
+
"default": "{ ...meta, name: 'Con icona cerchiata', args: {}, argTypes: { variant: { table: { disable: true, }, }, size: { table: { disable: true, }, }, }, parameters: { docs: { description: { story: ` È necessario passare l'attributo \\`icon=\"true\"\\` (o \\`icon=\"\"\\`, o semplicemente \\`icon\\`) a \\`<it-button>\\` per applicargli gli stili corretti. L’icona può essere posizionata a sinistra o a destra del testo, a seconda della posizione in cui viene inserita all’interno del pulsante. <br/>Deve essere contenuta all'interno di uno elemento con classe\\`.rounded-icon\\` per poter avere il contorno circolare. <br/><br/> #### Dimensione dell'icona La dimensione dell'icona deve sempre essere \\`xs\\`, quindi \\`<it-icon>\\` deve avere sempre l'attributo \\`size=\"xs\"\\`. `, }, }, }, render: (params) => { const slot = params.slot?.length > 0 ? params.slot : null; return html` <it-button class=\"me-2\" variant=\"success\" size=\"lg\" icon ?outline=\"${params.outline}\" ?block=\"${params.block}\" ?it-aria-disabled=\"${params.disabled}\" type=\"${params.type}\" > <span class=\"rounded-icon\"> <it-icon name=\"it-user\" color=\"success\" size=\"xs\"></it-icon> </span> <span>${slot ?? 'Pulsante Large con icona'}</span> </it-button> <it-button class=\"me-2\" variant=\"primary\" icon ?outline=\"${params.outline}\" ?block=\"${params.block}\" ?it-aria-disabled=\"${params.disabled}\" type=\"${params.type}\" > <span class=\"rounded-icon\" size=\"sm\"> <it-icon name=\"it-user\" color=\"primary\" size=\"xs\"></it-icon> </span> <span>${slot ?? 'Pulsante con icona'}</span> </it-button> <it-button class=\"me-2\" variant=\"danger\" icon ?outline=\"${params.outline}\" ?block=\"${params.block}\" ?it-aria-disabled=\"${params.disabled}\" type=\"${params.type}\" > <span class=\"rounded-icon\"> <it-icon name=\"it-user\" color=\"danger\" size=\"xs\"></it-icon> </span> <span>${slot ?? 'Pulsante Small con icona'}</span> </it-button> <it-button class=\"me-2\" variant=\"secondary\" size=\"xs\" icon ?outline=\"${params.outline}\" ?block=\"${params.block}\" ?it-aria-disabled=\"${params.disabled}\" type=\"${params.type}\" > <span class=\"rounded-icon\"> <it-icon name=\"it-user\" color=\"secondary\" size=\"xs\"></it-icon> </span> <span>${slot ?? 'Pulsante Link Extra Small con icona'}</span> </it-button> `; }, }"
|
|
359
378
|
}
|
|
360
379
|
],
|
|
361
380
|
"exports": [
|
package/dist/src/it-button.d.ts
CHANGED
|
@@ -1,11 +1,9 @@
|
|
|
1
1
|
import { BaseComponent } from '@italia/globals';
|
|
2
|
-
import { PropertyValues } from 'lit';
|
|
3
2
|
import { type Sizes, type Variants } from './types.js';
|
|
4
3
|
export declare class ItButton extends BaseComponent {
|
|
5
4
|
static styles: import("lit").CSSResultGroup;
|
|
6
5
|
static get formAssociated(): boolean;
|
|
7
6
|
private _nativeButton;
|
|
8
|
-
private _buttonClasses;
|
|
9
7
|
type: string;
|
|
10
8
|
variant: Variants;
|
|
11
9
|
size: Sizes;
|
|
@@ -14,10 +12,11 @@ export declare class ItButton extends BaseComponent {
|
|
|
14
12
|
icon: boolean;
|
|
15
13
|
value: string;
|
|
16
14
|
internals: ElementInternals;
|
|
17
|
-
|
|
18
|
-
|
|
15
|
+
disabled?: boolean;
|
|
16
|
+
expanded?: boolean;
|
|
19
17
|
surfaceSubmitEvent(event: any): void;
|
|
20
18
|
get form(): HTMLFormElement | null;
|
|
19
|
+
focus(): void;
|
|
21
20
|
private _onKeyDown;
|
|
22
21
|
connectedCallback(): void;
|
|
23
22
|
disconnectedCallback(): void;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"it-button.d.ts","sourceRoot":"","sources":["../../src/it-button.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAiB,MAAM,iBAAiB,CAAC;
|
|
1
|
+
{"version":3,"file":"it-button.d.ts","sourceRoot":"","sources":["../../src/it-button.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAiB,MAAM,iBAAiB,CAAC;AAI/D,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGvD,qBACa,QAAS,SAAQ,aAAa;IACzC,MAAM,CAAC,MAAM,+BAAU;IAEvB,MAAM,KAAK,cAAc,YAExB;IAEgB,OAAO,CAAC,aAAa,CAAqB;IAEhB,IAAI,SAAY;IAEhB,OAAO,EAAE,QAAQ,CAAM;IAEvB,IAAI,EAAE,KAAK,CAAM;IAEhB,OAAO,UAAS;IAEhB,KAAK,UAAS;IAEd,IAAI,UAAS;IAE7B,KAAK,SAAM;IAE3B,SAAS,mBAA0B;IAE4B,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAE9F,kBAAkB,CAAC,KAAK,EAAE,GAAG;IAmC7B,IAAI,IAAI,2BAEP;IAEe,KAAK;IAIrB,OAAO,CAAC,UAAU,CAKhB;IAEF,iBAAiB,IAAI,IAAI;IAUzB,oBAAoB,IAAI,IAAI;IAMnB,MAAM;CA6BhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,WAAW,EAAE,QAAQ,CAAC;KACvB;CACF"}
|