/* * Copyright 2016 Palantir Technologies, Inc. All rights reserved. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ import * as React from "react"; import { polyfill } from "react-lifecycles-compat"; import { AbstractPureComponent2, Classes } from "../../common"; import * as Errors from "../../common/errors"; import { DISPLAYNAME_PREFIX, IOptionProps, IProps } from "../../common/props"; import { isElementOfType } from "../../common/utils"; import { IRadioProps, Radio } from "./controls"; export interface IRadioGroupProps extends IProps { /** * Whether the group and _all_ its radios are disabled. * Individual radios can be disabled using their `disabled` prop. */ disabled?: boolean; /** * Whether the radio buttons are to be displayed inline horizontally. */ inline?: boolean; /** Optional label text to display above the radio buttons. */ label?: string; /** * Name of the group, used to link radio buttons together in HTML. * If omitted, a unique name will be generated internally. */ name?: string; /** * Callback invoked when the currently selected radio changes. * Use `event.currentTarget.value` to read the currently selected value. * This prop is required because this component only supports controlled usage. */ onChange: (event: React.FormEvent) => void; /** * Array of options to render in the group. This prop is mutually exclusive * with `children`: either provide an array of `IOptionProps` objects or * provide `` children elements. */ options?: IOptionProps[]; /** Value of the selected radio. The child with this value will be `:checked`. */ selectedValue?: string | number; } let counter = 0; function nextName() { return `${RadioGroup.displayName}-${counter++}`; } @polyfill export class RadioGroup extends AbstractPureComponent2 { public static displayName = `${DISPLAYNAME_PREFIX}.RadioGroup`; // a unique name for this group, which can be overridden by `name` prop. private autoGroupName = nextName(); public render() { const { label } = this.props; return (
{label == null ? null : } {Array.isArray(this.props.options) ? this.renderOptions() : this.renderChildren()}
); } protected validateProps() { if (this.props.children != null && this.props.options != null) { console.warn(Errors.RADIOGROUP_WARN_CHILDREN_OPTIONS_MUTEX); } } private renderChildren() { return React.Children.map(this.props.children, child => { if (isElementOfType(child, Radio)) { return React.cloneElement(child, this.getRadioProps(child.props as IOptionProps)); } else { return child; } }); } private renderOptions() { return this.props.options.map(option => ( )); } private getRadioProps(optionProps: IOptionProps): IRadioProps { const { name } = this.props; const { className, disabled, value } = optionProps; return { checked: value === this.props.selectedValue, className, disabled: disabled || this.props.disabled, inline: this.props.inline, name: name == null ? this.autoGroupName : name, onChange: this.props.onChange, value, }; } }