2023-01-13 20:43:55 +00:00
|
|
|
import '../icon/icon';
|
2021-09-29 12:40:26 +00:00
|
|
|
import { classMap } from 'lit/directives/class-map.js';
|
2023-01-13 20:43:55 +00:00
|
|
|
import { customElement, property, state } from 'lit/decorators.js';
|
|
|
|
import { html } from 'lit';
|
2022-03-24 12:11:49 +00:00
|
|
|
import { watch } from '../../internal/watch';
|
2023-01-13 20:43:55 +00:00
|
|
|
import ShoelaceElement from '../../internal/shoelace-element';
|
2021-07-10 00:45:44 +00:00
|
|
|
import styles from './radio.styles';
|
2022-07-19 12:27:39 +00:00
|
|
|
import type { CSSResultGroup } from 'lit';
|
2020-07-15 21:30:37 +00:00
|
|
|
|
|
|
|
/**
|
2022-10-21 13:56:35 +00:00
|
|
|
* @summary Radios allow the user to select a single option from a group.
|
2023-01-12 15:26:25 +00:00
|
|
|
* @documentation https://shoelace.style/components/radio
|
2020-07-15 21:30:37 +00:00
|
|
|
* @status stable
|
2023-01-12 15:26:25 +00:00
|
|
|
* @since 2.0
|
2020-07-15 21:30:37 +00:00
|
|
|
*
|
2022-11-10 17:27:03 +00:00
|
|
|
* @dependency sl-icon
|
|
|
|
*
|
2021-06-25 20:25:46 +00:00
|
|
|
* @slot - The radio's label.
|
2020-07-15 21:30:37 +00:00
|
|
|
*
|
2021-06-25 20:25:46 +00:00
|
|
|
* @event sl-blur - Emitted when the control loses focus.
|
|
|
|
* @event sl-focus - Emitted when the control gains focus.
|
2021-06-24 22:24:54 +00:00
|
|
|
*
|
2022-12-06 16:18:14 +00:00
|
|
|
* @csspart base - The component's base wrapper.
|
|
|
|
* @csspart control - The circular container that wraps the radio's checked state.
|
|
|
|
* @csspart control--checked - The radio control when the radio is checked.
|
|
|
|
* @csspart checked-icon - The checked icon, an `<sl-icon>` element.
|
|
|
|
* @csspart label - The container that wraps the radio's label.
|
2020-07-15 21:30:37 +00:00
|
|
|
*/
|
2021-03-18 13:04:23 +00:00
|
|
|
@customElement('sl-radio')
|
2022-08-17 15:37:37 +00:00
|
|
|
export default class SlRadio extends ShoelaceElement {
|
2022-07-19 12:27:39 +00:00
|
|
|
static styles: CSSResultGroup = styles;
|
2021-03-06 17:01:39 +00:00
|
|
|
|
2022-08-02 16:59:00 +00:00
|
|
|
@state() checked = false;
|
2022-03-24 12:11:49 +00:00
|
|
|
@state() protected hasFocus = false;
|
|
|
|
|
2022-12-06 16:18:14 +00:00
|
|
|
/** The radio's value. When selected, the radio group will receive this value. */
|
2022-03-24 12:11:49 +00:00
|
|
|
@property() value: string;
|
|
|
|
|
2022-12-13 14:28:12 +00:00
|
|
|
/** The radio's size. */
|
|
|
|
@property({ reflect: true }) size: 'small' | 'medium' | 'large' = 'medium';
|
|
|
|
|
2022-03-24 12:11:49 +00:00
|
|
|
/** Disables the radio. */
|
|
|
|
@property({ type: Boolean, reflect: true }) disabled = false;
|
|
|
|
|
2023-01-03 18:36:12 +00:00
|
|
|
connectedCallback() {
|
2022-03-24 12:11:49 +00:00
|
|
|
super.connectedCallback();
|
2023-01-03 20:04:07 +00:00
|
|
|
this.handleBlur = this.handleBlur.bind(this);
|
|
|
|
this.handleClick = this.handleClick.bind(this);
|
|
|
|
this.handleFocus = this.handleFocus.bind(this);
|
|
|
|
|
2022-08-02 16:59:00 +00:00
|
|
|
this.setInitialAttributes();
|
|
|
|
this.addEventListeners();
|
2022-08-01 16:08:31 +00:00
|
|
|
}
|
|
|
|
|
2023-01-03 20:04:07 +00:00
|
|
|
disconnectedCallback() {
|
|
|
|
this.removeEventListeners();
|
2022-03-24 12:11:49 +00:00
|
|
|
}
|
|
|
|
|
2023-01-03 20:04:07 +00:00
|
|
|
private addEventListeners() {
|
|
|
|
this.addEventListener('blur', this.handleBlur);
|
|
|
|
this.addEventListener('click', this.handleClick);
|
|
|
|
this.addEventListener('focus', this.handleFocus);
|
|
|
|
}
|
|
|
|
|
|
|
|
private removeEventListeners() {
|
|
|
|
this.removeEventListener('blur', this.handleBlur);
|
|
|
|
this.removeEventListener('click', this.handleClick);
|
|
|
|
this.removeEventListener('focus', this.handleFocus);
|
2022-08-01 16:08:31 +00:00
|
|
|
}
|
|
|
|
|
2022-08-02 16:59:00 +00:00
|
|
|
private handleBlur() {
|
2022-03-24 12:11:49 +00:00
|
|
|
this.hasFocus = false;
|
2022-09-16 20:21:40 +00:00
|
|
|
this.emit('sl-blur');
|
2022-03-24 12:11:49 +00:00
|
|
|
}
|
|
|
|
|
2022-08-02 16:59:00 +00:00
|
|
|
private handleClick() {
|
2022-03-24 12:11:49 +00:00
|
|
|
if (!this.disabled) {
|
|
|
|
this.checked = true;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2022-08-02 16:59:00 +00:00
|
|
|
private handleFocus() {
|
2022-03-24 12:11:49 +00:00
|
|
|
this.hasFocus = true;
|
2022-09-16 20:21:40 +00:00
|
|
|
this.emit('sl-focus');
|
2022-03-24 12:11:49 +00:00
|
|
|
}
|
|
|
|
|
2022-08-02 16:59:00 +00:00
|
|
|
private setInitialAttributes() {
|
|
|
|
this.setAttribute('role', 'radio');
|
|
|
|
this.setAttribute('tabindex', '-1');
|
2022-03-24 12:11:49 +00:00
|
|
|
this.setAttribute('aria-disabled', this.disabled ? 'true' : 'false');
|
|
|
|
}
|
|
|
|
|
2023-01-03 20:04:07 +00:00
|
|
|
@watch('checked')
|
|
|
|
handleCheckedChange() {
|
|
|
|
this.setAttribute('aria-checked', this.checked ? 'true' : 'false');
|
|
|
|
this.setAttribute('tabindex', this.checked ? '0' : '-1');
|
|
|
|
}
|
|
|
|
|
|
|
|
@watch('disabled', { waitUntilFirstUpdate: true })
|
|
|
|
handleDisabledChange() {
|
|
|
|
this.setAttribute('aria-disabled', this.disabled ? 'true' : 'false');
|
|
|
|
}
|
|
|
|
|
2020-07-15 21:30:37 +00:00
|
|
|
render() {
|
2021-02-26 14:09:13 +00:00
|
|
|
return html`
|
2022-08-02 16:59:00 +00:00
|
|
|
<span
|
2020-07-15 21:30:37 +00:00
|
|
|
part="base"
|
2021-02-26 14:09:13 +00:00
|
|
|
class=${classMap({
|
2020-07-15 21:30:37 +00:00
|
|
|
radio: true,
|
|
|
|
'radio--checked': this.checked,
|
|
|
|
'radio--disabled': this.disabled,
|
2022-12-13 14:28:12 +00:00
|
|
|
'radio--focused': this.hasFocus,
|
|
|
|
'radio--small': this.size === 'small',
|
|
|
|
'radio--medium': this.size === 'medium',
|
|
|
|
'radio--large': this.size === 'large'
|
2021-02-26 14:09:13 +00:00
|
|
|
})}
|
2020-07-15 21:30:37 +00:00
|
|
|
>
|
2022-10-14 12:35:00 +00:00
|
|
|
<span part="${`control${this.checked ? ' control--checked' : ''}`}" class="radio__control">
|
2022-12-13 14:28:12 +00:00
|
|
|
${this.checked
|
|
|
|
? html` <sl-icon part="checked-icon" class="radio__checked-icon" library="system" name="radio"></sl-icon> `
|
|
|
|
: ''}
|
2020-07-15 21:30:37 +00:00
|
|
|
</span>
|
|
|
|
|
2022-12-02 22:03:59 +00:00
|
|
|
<slot part="label" class="radio__label"></slot>
|
2022-08-02 16:59:00 +00:00
|
|
|
</span>
|
2021-02-26 14:09:13 +00:00
|
|
|
`;
|
2020-07-15 21:30:37 +00:00
|
|
|
}
|
|
|
|
}
|
2021-03-12 14:07:38 +00:00
|
|
|
|
2021-03-12 14:09:08 +00:00
|
|
|
declare global {
|
|
|
|
interface HTMLElementTagNameMap {
|
|
|
|
'sl-radio': SlRadio;
|
|
|
|
}
|
|
|
|
}
|